Overwork documentation (#3444)

* 📝 overwork macro documentation

* 📝 address review comments

* 🔧 add style check to Makefile

* 🙈 overwork .gitignore

* 📌 Pygments 2.12.0 is broken

* ✏️ fix links

* 🚸 adjust output to cppcheck

* 📝 add titles to more admonitions

* ✏️ fix typos

* 📝 document future behavior change
This commit is contained in:
Niels Lohmann
2022-04-25 22:40:45 +02:00
committed by GitHub
parent fcc36f99ba
commit a6ee8bf9d9
63 changed files with 1689 additions and 366 deletions
+11 -8
View File
@@ -1,18 +1,21 @@
# serve the site locally
serve: prepare_files
serve: prepare_files style_check
venv/bin/mkdocs serve
build: prepare_files
serve_dirty: prepare_files style_check
venv/bin/mkdocs serve --dirtyreload
build: prepare_files style_check
venv/bin/mkdocs build
# create files that are not versioned inside the mkdocs folder
# create files that are not versioned inside the mkdocs folder (images, examples)
prepare_files: clean
# create subfolders
mkdir docs/examples
# copy images
cp -vr ../json.gif docs/images
# copy examples
cp -vr ../examples/*.cpp ../examples/*.output docs/examples
cp -r ../json.gif docs/images
cp -r ../examples/*.cpp ../examples/*.output docs/examples
style_check:
@cd docs ; python3 ../scripts/check_structure.py
# clean subfolders
clean: