Skip to content

DriesSchaumont/sphinx-subprojecttoctree

Repository files navigation

Subprojecttoctree

Subprojecttoctrees is a Sphinx extension that aims to facilitate the integration of several documentation sources into a single Read the Docs webpage. This project extends the Read the Docs subproject concept, which allows projects to be configured as a subproject of another project, by creating a unified sidebar of URLs between these projects. A single 'master' index is specified in the 'main' project, eliminating the need to update all subprojects to change the index and allowing for version-specific sidebar links.

Documentation

The documentation can be found here.

How to install

Before installing, it is recommended to create a virtual environment first. Learn more about virtual environments here.

You can install binairy packages from the Python Package Index (PyPI)

pip install sphinx-subprojecttoctree

More information can be found in the documentation

Dependencies

This project is a plugin for Sphinx.

Python version support

Python 3.8, 3.9 and 3.10 are officially supported.

Running the tests

To run the tests, execute tox.

License

MIT

About

A Sphinx extension that aims to facilitate the integration of several documentation sources into a single Read the Docs webpage.

Resources

License

Stars

Watchers

Forks

Languages