15666e0470
Add rack placement frontmatter to mf00–mf04, fix pre-existing schema error in docs/services/coursemanagement.md (missing kind/name fields), extend Makefile docs-index and docs-check targets to also run gen_rack, add test target, generate rack01.md and rack01-elevation.svg. Positions are provisional placeholders to prove the pipeline; correct when mounting. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
33 lines
1 KiB
Makefile
33 lines
1 KiB
Makefile
.PHONY: help docs-index docs-build docs-serve docs-check slides test
|
|
|
|
help:
|
|
@echo "Targets:"
|
|
@echo " docs-index Regenerate docs/{hardware,services}/index.md from per-item frontmatter"
|
|
@echo " docs-build Build the static MkDocs site into ./site (strict)"
|
|
@echo " docs-serve Run a live-reload local preview server"
|
|
@echo " docs-check Drift-check: regenerate indices, fail if they differ from the committed copies"
|
|
@echo " slides Run build-slides.sh (Marp slides)"
|
|
@echo " test Run the Python unit tests (pytest)"
|
|
|
|
docs-index:
|
|
python3 scripts/gen_overview.py --category hardware
|
|
python3 scripts/gen_overview.py --category services
|
|
python3 scripts/gen_rack.py
|
|
|
|
docs-build:
|
|
mkdocs build --strict
|
|
|
|
docs-serve:
|
|
mkdocs serve
|
|
|
|
docs-check:
|
|
python3 scripts/gen_overview.py --category hardware
|
|
python3 scripts/gen_overview.py --category services
|
|
python3 scripts/gen_rack.py
|
|
git diff --exit-code docs/hardware/index.md docs/services/index.md docs/infrastructure/racks/
|
|
|
|
slides:
|
|
./build-slides.sh
|
|
|
|
test:
|
|
pytest -q
|