Skip to main content

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

Project description

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

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

sphinx-subprojecttoctree-0.5.4.tar.gz (218.5 kB view hashes)

Uploaded Source

Built Distribution

sphinx_subprojecttoctree-0.5.4-py3-none-any.whl (8.0 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page