Не удается получить TOCTREE в Sphinx для показа ссылки

Я новичок в Sphinx. Я попробовал учебник, но мне не удалось создать ссылку в содержимом. Ошибка, которую я получил

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 - это просто пустой файл.

Ответ 1

Вы получаете эту ошибку, потому что у вас нет названия в intro.rst.
Чтобы исправить это, добавьте заголовок в intro.rst. Предположим, что вы хотите, чтобы ваш заголовок был My Title, тогда заголовок можно добавить, сделав следующие две строки: первые строки intro.rst:

My Title
*********

Обратите внимание, что у вас должно быть достаточно символов *, чтобы полностью подчеркнуть ваш заголовок, иначе вы получите еще одну ошибку о некорректном заголовке или подчеркивании этого

Надеюсь, что это поможет