sphinx.ext.imgconverter -- A reference image converter using Imagemagick¶
在 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.
By default the extension uses ImageMagick to perform conversions, and will not work if ImageMagick is not installed.
備註
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).
組態¶
- image_converter¶
- Type:
str- 預設值:
'convert'on Unix;'magick'on Windows
A path to a conversion command. By default, the imgconverter finds the command from search paths.
在 3.1 版的變更: Use magick command by default on windows
- image_converter_args¶
- Type:
Sequence[str]- 預設值:
['convert']on Windows;()on Unix
Additional command-line arguments to give to convert, as a list.
在 3.1 版的變更: Use
['convert']by default on Windows