HOWTO.md

mkdocs for github pages site

Visit me at https://djismgaming.github.io

notes to self :D

• Microsoft Visual C++ 14.0 or greater is required. Get it with "Microsoft C++ Build Tools": https://visualstudio.microsoft.com/visual-cpp-build-tools/

Install the GTK for Windows Runtime to avoid cairo errors upon executing mkdocs serve

Execute on Git Bash

python -m venv .venv
source .venv/Scripts/activate
python -m pip install --upgrade pip setuptools wheel
pip install -r requirements.txt

mkdocs serve

For live development on VSCode

Execute in Git Bash

source .venv/Scripts/activate
mkdocs serve

Then visit http://127.0.0.1:8000/

Execute devupdate.ps1 in powershell to update the environment while making live modifications