Sphinx LaTeXPDF输出:如何改变"风格"

时间:2015-03-04 16:37:41

标签: latex python-sphinx

我使用Sphinx生成HTML和PDF文档。到目前为止,默认的PDF输出还可以,但我的经理发给我一个Word .dotx模板,并说PDF应该是相同的" corporate"风格。

所以问题是,如何改变PDF输出的风格?

conf.py文件提供了一些选项,比如latex_logo(但如果我在标题页上需要2张图片怎么办?)和" preamb"带有一些参数的部分。但我找不到任何手册或描述可用的参数。

例如,如何定义图片对齐,文本包装或表格线颜色等?

1 个答案:

答案 0 :(得分:1)

在您的情况下,Sphinx生成LaTeX输出,然后调用LaTeX编译器生成最终的PDF。这意味着您的风格很大程度上受LaTeX中给出的选项控制。对于特定问题,您还可以在线搜索LaTeX,而不一定是Sphinx。例如,您可以搜索" LaTeX图形对齐"而不是" Sphinx PDF图形对齐"。

要更改图形对齐方式,请使用figure_align中的latex_elements选项。例如,'figure_align': 'ht'会尽可能将数字放在插入点,否则它会回到页面顶部。您可以结帐here以获取LaTeX图形对齐。

preamble是一个非常灵活的选择。 preamble的内容插入到生成的LaTeX源文件的顶部。它允许您插入LaTeX提供的原始选项。例如,如果要将表格线颜色更改为红色,请将以下代码插入preamble

\usepackage{xcolor,colortbl}
\arrayrulecolor{red}

同样,这些资源仅显示为LaTeX个关键字资源,而不是Sphinx(here)。 IMO在LaTeX相关资源中搜索您的问题是最好的方法。

另外,我还写了一篇与Sphinx PDF输出相关的post,这也可能对你有所帮助。