如何修復Sphinx創建的PDF文件的邊距？

我有一個Django項目，我用Sphinx創建了我的文檔。我經歷了獅身人面像 - apidoc並跑了'製作latexpdf'。由此產生的文檔有不少邊界線流出。除了保證金問題之外，索引中的行開始溢出。如何修復Sphinx創建的PDF文件的邊距？

Overflowing Lines

Margin Issues :(

有一種簡單的方法來解決這些問題（或者更簡單的方法來創建PDF文檔）？

ELI5如果可能的話（在LaTeX的我不是很精通）

來源

2017-04-01 CarlosRobelli

提供可複製的Python和Sphinx示例和版本。沒有這一點，我唯一的建議是不使用等寬字體，將等寬字體設置爲更小的尺寸，或使用更窄的字體。在[金字塔PDF文檔]的索引條目中（http://readthedocs.org/projects/pyramid/downloads/pdf/latest/），我們不使用等寬字體。我們曾經遇到過很長的代碼塊沒有正確包裝的問題，但似乎在最近版本的Sphinx中已經解決了。在我們的[源代碼回購]（https://github.com/Pylons/pyramid/tree/master/docs）中查找示例。 –

在索引中溢出的線情況應增加這conf.py提高：

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

或者，您可以切換到日語從其特殊的文件類別中做出類似的東西（甚至更好）;-)

TeX並不總是知道如何自己插入linebreaks：畢竟它擅長連字符自然語言。但正如在評論中指出的那樣，Sphinx強制LaTeX從1.4.2開始處理更好的長代碼行。

由於最近的1.5.3版本，用戶可以自定義頁邊距，請檢查http://www.sphinx-doc.org/en/stable/latex.html#the-sphinx-latex-style-package-options以獲取可通過'sphinxsetup'配置的hmargin和vmargin文檔。

來源

2017-04-01 20:26:39 jfbu

使用1.6.3，這個建議大大改進了，但不幸的是並沒有完全消除從我的索引頁的第一列到第二列溢出的行。但我有一些很長的字符串。 –

如何修復Sphinx創建的PDF文件的邊距？

回答

相關問題