Skip to main content

Sphinx SVG 到 PDF 转换器扩展

项目描述

如果构建器本身不支持 SVG 图像(例如 LaTeX),此扩展将 SVG 图像转换为 PDF。

在内部,使用 来自libRSVGCairoSVG的Inkscapersvg-convert作为逐渐更轻量级的替代品来转换图像。

安装

只需通过pip安装:

$ pip install sphinxcontrib-svg2pdfconverter

您可以通过将sphinxcontrib.inkscapeconvertersphinxcontrib.rsvgconvertersphinxcontrib.cairosvgconverter添加到 conf.py 的扩展列表中 来选择 Inkscape、libRSVG 和 CairoSVG

确保系统PATH中有可用的inkscapersvg-convert命令,如有必要,请分别调整 inkscape_converter_binrsvg_converter_bin配置值。

CairoSVG 需要安装额外的依赖项:

$ pip install sphinxcontrib-svg2pdfconverter[CairoSVG]

CairoSVG 及其依赖项在安装过程中可能需要其他工具,具体取决于您使用的操作系统;有关详细信息,请参阅CairoSVG 文档

配置

墨景

inkscape_converter_bin

Inkscape 二进制文件的路径。默认情况下,这是inkscape

inkscape_converter_args

Inkscape 的附加命令行参数,作为列表。默认情况下,这是['--export-area-drawing']

RSVG

rsvg_converter_bin

RSVG 转换器二进制文件的路径。默认情况下,这是rsvg-convert

rsvg_converter_args

RSVG 转换器的附加命令行参数,作为列表。默认情况下,这是空列表[]

开罗SVG

无需配置。

项目详情


下载文件

下载适用于您平台的文件。如果您不确定要选择哪个,请了解有关安装包的更多信息。

源分布

sphinxcontrib-svg2pdfconverter-1.2.0.tar.gz (5.5 kB 查看哈希)

已上传 source

内置分布

sphinxcontrib_svg2pdfconverter-1.2.0-py3-none-any.whl (8.1 kB 查看哈希

已上传 py3