在reST文件中定义Latex包

Question

我们使用Docutils生成reST文档，然后通过rst2latex生成TeX文件。

在rst文件中，我们添加了许多LaTeX代码，如：

.. raw:: latex

    ~\\
    \rule{\textwidth}{1pt}
    ~\\

但我不知道在哪里添加像\usepackage{tabulary}这样的包。

如果我将其添加到rst文件中，就像我上面所示，即使在最开始，这条\usepackage行也会自动添加到tex输出文件中的\begin{document}之后。这显然会产生错误。

知道在哪里可以在reST中添加\usepackage命令吗？

Answer 1

您可以使用LaTeX preamble（在Docutils 0.7之后）

rst2latex foo.rst foo.tex --latex-preamble="\usepackage{tabulary}"

将在foo.html

中生成以下内容

%%% Custom LaTeX preamble
\usepackage{tabulary}

或者，可以通过

提供自定义样式表

rst2latex foo.rst foo.tex --stylesheet=preamble.tex

将生成

%%% User specified packages and stylesheets
\input{preamble.tex}

在正确的地方。