Impossibile ottenere TOCTREE nella sfinge per mostrare il link

Question

Sono nuovo di sfinge. Ho provato il tutorial ma non sono riuscito a generare il collegamento nei contenuti. L'errore che ho ottenuto

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. 

Ho creato zuhdi.rst e intro.rst nella stessa directory di index.rst. Come posso inserire il titolo nei documenti?

Per vostra informazione, il mio index.rst contiene queste righe:

Contents: 

.. toctree:: 
    :maxdepth: 2 

    intro 
    zuhdi 

Fare i documenti deve esistere per me di mettere i link nella toctree? Il intro.rst e zuhdi.rst è solo un file vuoto.

Answer 1

Si riceve questo errore perché non si dispone di un titolo in intro.rst.
Per risolvere questo problema, aggiungere un titolo a intro.rst. Supponiamo che si desidera che il titolo sia My Title, poi il titolo può essere aggiunto facendo le seguenti due righe le prime linee di intro.rst:

My Title 
********* 

noti che è necessario avere abbastanza * caratteri per sottolineare tutto il titolo, altrimenti si otterrà un altro errore di un titolo errato o sottolineando di esso

Spero che questo aiuti