Question

我有一个Django项目，我使用Sphinx创建我的文档。我经历了sphinx-apidoc，然后跑去制作乳胶涂料＆＃39;。由此产生的文档有很多行从边缘流出。除了保证金问题之外，索引中的行开始相互溢出。

是否有一种简单的方法可以解决这些问题（或者更简单的方法来创建PDF文档）？

ELI5如果可能的话（我不精通LaTeX）

Answer 1

索引中的溢出行情况应该从将其添加到conf.py：

后得到改善

latex_elements = {
    'printindex': '\\footnotesize\\raggedright\\printindex',
}

或者，您可以切换到日语，它可以从其特殊文档类中开箱即用（甚至更好）; - ）

TeX并不总是知道如何插入换行符：毕竟它很擅长自然语言的连字符。但正如评论中所指出的那样，自1.4.2以来，Sphinx强迫LaTeX处理更好的长代码行。

从最近的1.5.3开始，用户可以自定义页边距，检查http://www.sphinx-doc.org/en/stable/latex.html#the-sphinx-latex-style-package-options以获取可通过'sphinxsetup'配置的hmargin和vmargin文档。