ВНИМАНИЕ: toctree содержит ссылку на несуществующий документ - PullRequest
Новая
       2

ВНИМАНИЕ: toctree содержит ссылку на несуществующий документ

0 голосов
/ 24 июня 2019

Я использую sphinx для документирования своего приложения Django.

У меня следующая структура каталогов документов 

docs
|- build
|- source
   |- _static
   |- _templates
   |- conf.py
   |- index.rst
   |- upgrade.rst
|- upgrade_changes
   |- migration
      |- index.rst
   |- index.rst
   |- library_changes.rst

и содержание docs/source/index.rst равно 

My App's documentation!
=============================================
App Description

Revamp Upgrade Changes
----------------------

.. toctree::
   :maxdepth: 2

   upgrade

файл source/upgrade.rst включает содержимое upgrade_changes

.. include:: ../upgrade_changes/index.rst

И /upgrade_changes/index.rst имеет 

Following is the list of all revamp related documentation.

.. toctree::
   :maxdepth: 2

   library_changes

Я хочу включить toctree для файла library_changes.rst, который находится на том же уровне, что и index.rst.

Но это дает ошибку 

upgrade_changes/index.rst:50: WARNING: toctree contains reference to nonexisting document 'library_changes'

Как включить файлы в toctree на одном уровне?

...