Python Sphinx在生成PDF時跳過第一節pdf

我使用sphynx從靜態.rst文件生成文檔（沒有文檔字符串提取）。Python Sphinx在生成PDF時跳過第一節pdf

我在我的倉庫兩個文件：

index.rst

.. toctree:: 

    intro

和intro.rst

Will be skipped 
=============== 

Where is my parent section? 
--------------------------- 

Second section 
==============

以下是通過運行sphinx-build -b latex . _build; cd _build; pdflatex *獲得PDF格式的屏幕截圖：

enter image description here

Flabbergasting還是什麼？

來源

2015-01-15 kraymer

感謝您提供的工作示例。我可以在Windows上用Sphinx 1.2.3重現你的觀察。就我所見，HTML輸出按預期工作。與膠乳製造商，下面的文檔結構產生：

\chapter{Where is my parent section?} 
\label{intro:will-be-skipped}\label{intro::doc}\label{intro:where-is-my-parent-section} 

\chapter{Second section} 
\label{intro:second-section}

我發現了可疑的文檔，它並沒有定義的標題。作爲解決方法，我發現添加更高級別的層次結構是可行的，但將它放入index.rst或intro.rest中並不重要。這是修改後的index.rst：

===== 
TITLE 
===== 

.. toctree:: 

    intro

，導致： enter image description here

我已經再進一步看出來這個問題，並發現該到位桶/ GitHub的問題處理的非常相同的問題（這是從2011年）：

https://bitbucket.org/birkenfeld/sphinx/issue/632/section-versus-chapter-oddity-in-latex https://github.com/sphinx-doc/sphinx/issues/632

報價：

您的index.rst沒有標題，對不對？基本上獅身人面像吞噬了上最頂層的標題（然後由文檔 frontmatter替換）。

這個問題在2011年被擱置了，可能它並沒有被視爲失敗的行爲。那時它剛剛在GitHub上關閉，沒有被「固定」。所以，正如Georg在那張票上寫的那樣，獅身人面像實際上只是消費最高的層次，而其內容卻不會出現在任何地方。

因此：添加「標題層次結構」，無論您如何命名，都是正確的解決方案。

來源

2015-01-21 22:38:07

只是澄清，缺少的標題是在'index.rst' – shadi

使用Ubuntu 14.04和texlive如果我創建sphinx-quickstart一個新的獅身人面像的項目（單獨的源和構建目錄），刪除示例文件到source目錄，並建立：

$ make latexpdf

我看的見在PDF輸出中標題爲Will be skipped。

Expected PDF output

的OP的原始命令是

$ sphinx-build -b latex . _build; cd _build; pdflatex *

構建文檔，這是比在使用latex all-pdf的Makefilelatexpdf的目標略有不同。但是，如果我使用sphinx-quickstart創建的conf.py創建了一個新的項目目錄，我仍然可以使用OP命令序列在PDF中看到Will be skipped輸出。我會研究您正在使用的conf.py設置，這些設置可能會提供解決方案的線索。

來源

2015-01-23 15:06:16

Python Sphinx在生成PDF時跳過第一節pdf

回答

相關問題