📖 Documentation Guide
The project contains built-in documentation written in Markdown and displayed using MkDocs with the Material theme.
🛠️ How to run the documentation (development mode)
- Go to the project root:
cd kraken_webui
- Make sure
mkdocs-material
is installed:
(install it in a virtual environment or with pipx)
python -m venv /env
source env/bin/activate
pip install -r requirements.txt
- Start the local documentation server:
mkdocs serve
- Open it in your browser:
🛠️ Additional commands
-
Build the static site:
mkdocs build
The result will be in thesite/
folder. -
Deploy to GitHub Pages:
(requires a configured GitHub repository)
mkdocs gh-deploy
💡 Useful Tips
- The Markdown documentation files are located in the
docs/
folder. - The structure and navigation are configured in the
mkdocs.yml
file. - Changes in Markdown files are automatically reflected when refreshing the page.