sphinx.ext.imgconverter – Um conversor de imagem de referência usando o Imagemagick¶
Adicionado na versão 1.6.
Esta extensão converte imagens em seu documento em formato apropriado para construtores. Por exemplo, permite usar imagens SVG com o construtor LaTeX. Como resultado, você não precisa ser preocupar com quais formatos de imagem o construtor oferece suporte.
Por padrão, a extensão usa ImageMagick para realizar conversões e não funcionará se o ImageMagick não estiver instalado.
Nota
O ImageMagick rasteriza uma imagem SVG na conversão. Como resultado, a imagem não é escalável. Para evitar isso, por favor, use outros conversores de imagem como o sphinxcontrib-svg2pdfconverter (que usa o Inkscape ou rsvg-convert).
Configuração¶
- image_converter¶
- Type:
str- Default:
'convert'on Unix;'magick'on Windows
Um caminho para um comando de conversão. Por padrão, o imgconverter usa o comando a partir da caminhos de pesquisa.
Alterado na versão 3.1: Usa o comando magick por padrão no Windows
- image_converter_args¶
- Type:
Sequence[str]- Default:
['convert']on Windows;()on Unix
Additional command-line arguments to give to convert, as a list.
Alterado na versão 3.1: Use
['convert']by default on Windows