mirror of
https://github.com/sphinx-doc/sphinx.git
synced 2025-02-25 18:55:22 -06:00
53 lines
1.6 KiB
ReStructuredText
53 lines
1.6 KiB
ReStructuredText
.. _sphinx.ext.imgconverter:
|
|
|
|
:mod:`sphinx.ext.imgconverter` -- A reference image converter using Imagemagick
|
|
===============================================================================
|
|
|
|
.. module:: sphinx.ext.imgconverter
|
|
:synopsis: Convert images to appropriate format for builders
|
|
|
|
.. versionadded:: 1.6
|
|
|
|
This extension converts images in your document to appropriate format for
|
|
builders. For example, it allows you to use SVG images with LaTeX builder.
|
|
As a result, you don't mind what image format the builder supports.
|
|
|
|
Internally, this extension uses Imagemagick_ to convert images.
|
|
|
|
.. _Imagemagick: https://www.imagemagick.org/script/index.php
|
|
|
|
.. note::
|
|
|
|
Imagemagick rasterizes a SVG image on conversion. As a result, the image
|
|
becomes not scalable. To avoid that, please use other image converters like
|
|
`sphinxcontrib-svg2pdfconverter`__ (which uses Inkscape or
|
|
``rsvg-convert``).
|
|
|
|
.. __: https://github.com/missinglinkelectronics/sphinxcontrib-svg2pdfconverter
|
|
|
|
|
|
Configuration
|
|
-------------
|
|
|
|
.. confval:: image_converter
|
|
|
|
A path to :command:`convert` command. By default, the imgconverter uses
|
|
the command from search paths.
|
|
|
|
On windows platform, :command:`magick` command is used by default.
|
|
|
|
.. versionchanged:: 3.1
|
|
|
|
Use :command:`magick` command by default on windows
|
|
|
|
.. confval:: image_converter_args
|
|
|
|
Additional command-line arguments to give to :command:`convert`, as a list.
|
|
The default is an empty list ``[]``.
|
|
|
|
On windows platform, it defaults to ``["convert"]``.
|
|
|
|
.. versionchanged:: 3.1
|
|
|
|
Use ``["convert"]`` by default on windows
|