我正在使用sphinx记录我的Django应用程序。
我具有以下docs目录结构
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
我想为library_changes.rst
文件添加一个 toctree ,该文件的级别与index.rst
相同。
但这会导致错误
upgrade_changes/index.rst:50: WARNING: toctree contains reference to nonexisting document 'library_changes'
如何包含要在同一级别上树的文件?