獅身人面像無法獲得TOCTREE顯示鏈接

Question

我是獅身人面像的新手。我嘗試了這個教程，但是我沒有在內容中生成鏈接。我得到

C:\Users\mhaikalm\sphinxtest\source\index.rst:11: WARNING: toctree contains refe 
rence to document 'intro' that doesn't have a title: no link will be generated 
C:\Users\mhaikalm\sphinxtest\source\index.rst:11: WARNING: toctree contains refe 
rence to document 'zuhdi' that doesn't have a title: no link will be generated 
writing additional files... (0 module code pages) genindex search 
copying static files... done 
dumping search index... done 
dumping object inventory... done 
build succeeded, 3 warnings. 

Build finished. The HTML pages are in build/html. 

的錯誤我已經在相同目錄下創建zuhdi.rst和intro.rst爲index.rst。我怎樣才能把文件的標題？

爲了您的信息，我的index.rst包含這些行：

Contents: 

.. toctree:: 
    :maxdepth: 2 

    intro 
    zuhdi 

執行文件必須存在我把在toctree的聯繫？ intro.rst和zuhdi.rst只是一個空文件。

Answer 1

由於您沒有intro.rst中的標題，您將收到此錯誤。
爲了解決這個問題，請給intro.rst添加一個標題。假設你想你的標題是My Title，那麼標題可以通過將以下兩行的intro.rst第一行補充說：

My Title 
********* 

請注意，您必須有足夠的*字符完全強調你的標題，否則你將獲得約畸形的標題另一個錯誤或者其強調

希望這有助於