https://jwblangley.github.io/docs/
Time-saving Answers to Infrequent, but Annoyingly Specific Tasks My personal notes covering small bits and pieces that may be needed relatively uncommon, but are a time-suck when they do come up without this collection!
This repo is fully automated. To add or edit any documentation, simply create/edit a file within the docs
directory. Do not add documentation to the img
or stylesheets
directories as these have special usage.
Directory hierarchy is preserved and reflected in the generated docs, which are automatically built and published on each commit to the master branch.
This repo uses mkdocs, incorporating material for mkdocs. Local development can be done by creating and activating a virtual environment.
python3 -m venv venv
source venv/bin/activate
Installing the dependencies.
pip install -r requirements.txt
And serving a build to localhost:8000
mkdocs serve