1.2 KiB
About These Docs
The Hydrus docs are built with MkDocs using the Material for MkDocs theme. The .md files in the docs directory are converted into nice html in the help directory. This is done automatically in the built releases, but if you run from source, you will want to build your own.
Local Setup
To see or work on the docs locally, install mkdocs-material:
The recommended installation method is pip:
pip install mkdocs-material
Building
To build the help, run:
mkdocs build -d help
In the base hydrus directory (same as the mkdocs.yml file), which will build it into the help directory. You will then be good!
Repeat the command and MkDocs will clear out the old directory and update it, so you can fold this into any update script.
Live Preview
To edit the docs directory, you can run the live preview development server with:
mkdocs serve
Again in the base hydrus directory. It will host the help site at http://127.0.0.1:8000/, and when you change a file, it will automatically rebuild and reload the page in your browser.