Kann TOCTREE in Sphinx nicht erhalten, um Verbindung anzuzeigen

Question

Ich bin zu Sphinx neu. Ich habe das Tutorial ausprobiert, aber ich konnte den Link im Inhalt nicht erzeugen. Der Fehler, ich habe

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. 

Ich habe zuhdi.rst und intro.rst im selben Verzeichnis wie index.rst erstellt. Wie kann ich den Dokumenten Titel geben?

Zu Ihrer Information enthält meine index.rst diese Zeilen:

Contents: 

.. toctree:: 
    :maxdepth: 2 

    intro 
    zuhdi 

die Dokumente Sie müssen für mich bestehen die Links in der toctree zu setzen? Die intro.rst und zuhdi.rst ist nur eine leere Datei.

Answer 1

Sie erhalten diesen Fehler, weil Sie keinen Titel in intro.rst haben.
Um dies zu beheben, fügen Sie einen Titel intro.rst hinzu. Angenommen, Sie möchten Ihren Titel My Title, dann der Titel sein kann, indem sie die beiden folgenden Zeilen die ersten Zeilen von intro.rst hinzugefügt:

My Title 
********* 

Beachten Sie, dass Sie genug * Zeichen vollständig benötigen, um Ihren Titel unterstreichen, Sie sonst wird ein weiterer Fehler zu einem fehlerhaften Titel erhalten oder davon

Hoffnung unterstreicht diese