Trouble to setup subpages in sphinx documentation

22 views
Skip to first unread message

Mathis Joussemet

unread,
Jul 14, 2024, 6:10:12 PM (8 days ago) Jul 14
to sphinx-users
I'm trying to set up subpages on my Sphinx doc. Basically, I want that my root index.rst file to call the index in the developer folder which references the build.rst and contributing.rst files. (the code is in the attached file)
When I'm trying to do that, I get these errors. I couldn't find anything about it online.
I really hope you can help me

Thx in advance
Capture d’écran du 2024-07-14 20-53-35.png


Capture d’écran du 2024-07-14 20-50-15.png
sphinx-source.zip

Rafael Fontenelle

unread,
Jul 15, 2024, 12:49:10 PM (7 days ago) Jul 15
to sphinx-users
Hi Mathis

It seems you didn't add developer/ directory to the zip file, not sure if that was intentional.

Have you tried:

<root>/index.rst

.. toctree::
   developer/index

and in <root>/developer/index.rst

.. toctree::

  build
  contributing

?


Regards,
Rafael

Mathis

unread,
Jul 15, 2024, 1:30:57 PM (7 days ago) Jul 15
to sphinx...@googlegroups.com
After looking at the python docs, i found how to do it like you said.

Thx for the help
Reply all
Reply to author
Forward
0 new messages