sphinx.ext.imgconverter – A reference image converter using Imagemagick¶
Added in version 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.
Nota
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).
Configuration¶
- image_converter¶
A path to a conversion command. By default, the imgconverter finds the command from search paths.
On Unix platforms, the command convert is used by default.
On Windows, the command magick is used by default.
Distinto en la versión 3.1: Use magick command by default on windows
- image_converter_args¶
Additional command-line arguments to give to convert, as a list. The default is an empty list
[].On Windows, it defaults to
["convert"].Distinto en la versión 3.1: Use
["convert"]by default on Windows