Setting Up the New Documentation Site Locally
To set up and run the documentation site on your local machine, please follow the steps below:
1. Create a Virtual Environment
To create a virtual environment named venv
in your project directory, use the following command:
2. Activate the Virtual Environment
Activate the virtual environment to ensure that all dependencies are installed locally within your project directory.
On Linux/MacOS:
On Windows:
3. Install Dependencies
To install all the necessary Python packages listed in requirements.txt, run:
Please run these commands to update and fetch the local Submodules.
git submodule foreach --recursive 'git fetch --all'
git submodule update --init --remote --recursive --depth 1
git submodule sync --recursive
git submodule update --remote --recursive
4. Serve the Documentation Locally
Start a local development server to preview the documentation in your web browser. The server will automatically reload whenever you make changes to the documentation files.
5. Make Changes and Review
As you edit the documentation, you can view your changes in real-time through the local server. This step ensures everything looks as expected before deploying.
6. Push Changes to GitHub
Once you are satisfied with your changes, commit and push them to the GitHub repository. The documentation will be automatically deployed via GitHub Actions, making it live on the documentation site.