sphinxcontrib-texfigure 0.1.3

概览

sphinxcontrib-texfigure 是一个 Sphinx 扩展程序，用于从 TeX 文件生成图形和图表。

要查看此扩展程序可以生成的图表示例，请参阅 http://htsql.org/doc/overview.html#htsql-in-a-nutshell。有关更多示例，请参阅源分布中的 demo 目录。

此扩展程序的范围与 sphinxcontrib-tikz 扩展程序类似，但在输入和选项方面采用不同的方法。

此软件由 Kirill Simonov (Prometheus Research, LLC) 编写，并按 BSD 许可证发布。

先决条件

以下可执行文件用于将 TeX 文档转换为位图

• pdflatex

• pdftoppm

• pnmcrop

• pnmtopng

在 Debian 或基于 Debian 的系统上，可以使用以下命令安装

# apt-get install texlive
# apt-get install poppler-utils
# apt-get install netpbm

如果您想使用 TikZ 生成图表，请安装

# apt-get install texlive-pictures

使用方法

要启用此扩展程序，请将以下行添加到 conf.py

extensions.append('sphinxcontrib.texfigure')

使用 texfigure 指令将 TeX/LaTeX 文档转换为图像。例如

.. texfigure:: hello-world.tex

此指令将渲染 你好，世界！ 并在框中呈现，假设 hello-world.tex 包含以下 LaTeX 文档

\documentclass{article}
\usepackage{tikz}
\pagestyle{empty}

\begin{document}
\begin{tikzpicture}
\node[draw] {Hello, World!};
\end{tikzpicture}
\end{document}

使用选项 align 来指定水平对齐，使用 alt 来指定图像的文本内容

.. texfigure:: hello-world.tex
   :align: center
   :alt: Hello, World!

参考