ReadtheDocs is CU Boulder Libraries Core Tech & Apps approved method for documentation.
- Python 3.3 or greater
-
Clone Repository
git clone git@github.com:culibraries/documentation.git or git clone https://github.com/culibraries/documentation.git
-
Create Virtual Environment
NOTE: Win variations assume cmd.exe shell
cd documentation python3 -m venv venv (Win: python -m venv <dir>) . venv/bin/activate (Win: venv\Scripts\activate.bat) pip install -r requirements.txt
-
Create HTML
cd docs make html
-
New Terminal - Web server
. venv/bin/activate cd docs/_build/html python -m http.server Serving HTTP on :: port 8000 (http://[::]:8000/) ...
-
Open Browser http://localhost:8000
git checkout -b new_docs
- Edit/Add documentation (Markdown)
make html
- add new pages to toctree (index.rst)
CU Boulder Libraries' regular activity is to create a PR from the release
branch with a code review. The documentation
repository is slightly different. Perform a PR from the feature branch to the main
branch. Add a code review before merge to main.
- Merge to main required before ReadtheDocs build process will start.
- ReadtheDocs View builds
- After successful build: https://cu-boulder-libraries.readthedocs.io/en/latest/