Random notes

This is a place to store random notes, tips and tricks I find useful for the future me.

Website - https://mana-random-notes.readthedocs.io/

Read the Docs for hosting

mkdocs is used to serve up the static website, and Read the Docs is used for hosting it online.

Use mkdocs for development

mkdocs can be used in the local machine during development to test website is building correctly. Commands used:

# create  conda env
conda env create --file "configs/envs/mkdocs.yaml"

# activate env
conda activate mkdocs

# install more stuff via pip (not ideal but good enough for now)
pip install -r "configs/mkdocs/requirements.txt"

# now build website using website and serve live (locally)
mkdocs serve