Repository files navigation

The Django Commons docs are deployed atdjango-commons.org.

The repository that hosts the docs is athttps://github.com/django-commons/django-commons.github.io

1. Create a Python 3.13 virtual environment (uv venv --python 3.13)
2. Runpip install mkdocs mkdocs-material
3. Runmkdocs serve -f src/mkdocs.yml

With uv:uv run --python 3.13 --with mkdocs --with mkdocs-material mkdocs serve -f src/mkdocs.yml

You don't have to use pre-commit. But if you choose to:

1. Install pre-commit

• Runpre-commit install

This will install pre-commit. Then, before you commit, runpre-commit run to run pre-commit and check your changed files for linting errors.

The site is hosted using GitHub Pages which requires a separate repository.

If you have cloned both this repository and django-commons.github.io to the same parent directory as follows:

django-commons-mkdocs/    src/        mkdocs.yml        docs/django-commons.github.io/

To deploy, run the following command from thedjango-commons.github.io/ directory.

uv run --python 3.13 --with mkdocs --with mkdocs-material mkdocs  gh-deploy --config-file ../django-commons-mkdocs/src/mkdocs.yml --remote-branch main

• mkdocs new [dir-name] - Create a new project.
• mkdocs serve - Start the live-reloading docs server.
• mkdocs build - Build the documentation site.
• mkdocs -h - Print help message and exit.