5

I'm using sphinx for documenting my Django application.

I have the following directory structure of docs

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

and the content of docs/source/index.rst is

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

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

.. toctree::
   :maxdepth: 2

   upgrade

the source/upgrade.rst file inludes the content from upgrade_changes

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

And the /upgrade_changes/index.rst has

Following is the list of all revamp related documentation.

.. toctree::
   :maxdepth: 2

   library_changes

I want to include a toctree for the library_changes.rst file which is at the same level os of index.rst.

But this gives an error

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

How can I include the files to toctree at the same level?

bad_coder
  • 11,289
  • 20
  • 44
  • 72
Anuj TBE
  • 9,198
  • 27
  • 136
  • 285

0 Answers0