Subprojects
Subprojects, or subprojects, make documenting complex or modular systems easier across versions and repositories. You can create a super project that includes multiple subprojects, allowing you to keep your repository organized and version controlled. Subprojects simplify documentation and navigation across projects. This documentation assumes that you're familiar with standard documentation best practice.
Get Started
This document includes documentation for subprojects. This section covers:
1. Adding new subprojects and documentation to a main project.
2. Creating navigation for a new project.
3. Managing versioning and custom project settings.
Getting Started
links:
home: "index.rst"
Make subdocuments:
.. toctree::
:caption: Tutorials
:hidden:
:maxdepth: 2
tutorial
Subdocuments
:name: name
Subdocuments
We will start by first setting up a Subdocument to a project with multiple subprojects or multiple documentation. We suggest including index.md
, then adding the main project in documentation. For help, look here. For example:
1. cd my-project
3.
cd subproject-1
4.
python manage.py
python manage.py docs
subprojects/
cd project/
pip install sphinx-subproject
python main.py
5.
[docs] Documentation settings.
6.pip install -r requirements.txt
7.pip -r requirements