如何通过 pdflatex \raggedright 制作 sphinx 文档？答案

【问题标题】：How to make sphinx document via pdflatex \raggedright?如何通过 pdflatex \raggedright 制作 sphinx 文档？
【发布时间】：2017-05-28 20:26:03
【问题描述】：

如果我使用pdflatex，如何将\raggedright 命令应用于所有文本来呈现reST 文档？

【问题讨论】：

标签： latex python-sphinx restructuredtext pdflatex

【解决方案1】：

使用自定义模板。

在以下示例中，我将使用xelatex。我会将 xelatex 的默认模板从 /usr/local/lib/python2.7/site-packages/docutils/writers/latex2e/xelatex.tex 复制到名为 mytemplate.tex 的文件中

默认模板如下所示：

$head_prefix% generated by Docutils <http://docutils.sourceforge.net/>
% rubber: set program xelatex
\usepackage{fixltx2e}
\usepackage{fontspec}
% \defaultfontfeatures{Scale=MatchLowercase}
$requirements
%%% Custom LaTeX preamble
$latex_preamble
%%% User specified packages and stylesheets
$stylesheet
%%% Fallback definitions for Docutils-specific commands
$fallbacks$pdfsetup
$titledata
%%% Body
\begin{document}
$body_pre_docinfo$docinfo$dedication$abstract$body
\end{document}

您可以在\begin{document} 之后添加\raggedright。

为了呈现文档，我会使用以下命令：

rst2xetex --template=mytemplate.tex --use-latex-docinfo mydoc.rst
xelatex mydoc.tex
xelatex mydoc.tex
rm -f *.out *.aux *.log mydoc.tex

（这是在类似 UNIX 的操作系统上。）

【讨论】：

你的回答让我对pdflatex的模板很好奇。长话短说：我最终在/usr/lib/python2.7/dist-packages/sphinx/writers/latex.py 找到了default_elemets。一位成员是maketitle，我已对其进行了修改以在我的conf.py 文件中包含'\\maketitle \\raggedright'。我标记你的答案是正确的，即使是xetex，因为你踢我的方向是正确的。