警告:toctree包含对不存在文档的引用

时间:2019-06-24 10:54:01

标签: python-sphinx

我正在使用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'

如何包含要在同一级别上树的文件?

0 个答案:

没有答案