c743416ded
Mirror the auto-indexed per-host pattern for a new docs/services/ category, seeded with the six things currently deployed on or around makerfloss.eu: docs, slides, forgejo, gandi-dns, marp, mermaid. Generator/hook generalisation: - scripts/gen_overview.py: replace the hardcoded `hostname` check with a configurable `key_field` (default: hostname). Add a generic `key-link` column kind (replaces the old `hostname-link`) and a `url-link` kind that renders the value as a clickable link. - scripts/overview_config.yml: declare hardware's key_field, then add a `services` block (key_field=name, its own kind/status enums, grouped by kind for the index table). - scripts/mkdocs_hooks.py: route by `page.file.src_uri` so each hardware/* page gets a "Specs" table and each services/* page gets a "Service" table; both share the helpers in gen_overview. Wiring: - Makefile: docs-index and docs-check now regenerate and drift-check both indices. - .forgejo/workflows/docs.yml: same on the CI runner. - mkdocs.yml: add Services to nav. - README.md, CLAUDE.md: list services/ in the repo-layout block. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
60 lines
1.3 KiB
YAML
60 lines
1.3 KiB
YAML
site_name: MakerFLOSS Docs
|
|
site_url: https://docs.makerfloss.eu/
|
|
site_description: Documentation for the MakerFLOSS initiative at Orange Makerspace.
|
|
|
|
repo_url: https://forgejo.makerfloss.eu/sjat/MakerFLOSS
|
|
repo_name: sjat/MakerFLOSS
|
|
edit_uri: _edit/main/
|
|
|
|
theme:
|
|
name: material
|
|
features:
|
|
- navigation.indexes
|
|
- navigation.sections
|
|
- navigation.top
|
|
- content.code.copy
|
|
- search.suggest
|
|
- search.highlight
|
|
palette:
|
|
- media: "(prefers-color-scheme: light)"
|
|
scheme: default
|
|
primary: deep orange
|
|
toggle:
|
|
icon: material/weather-night
|
|
name: Switch to dark mode
|
|
- media: "(prefers-color-scheme: dark)"
|
|
scheme: slate
|
|
primary: deep orange
|
|
toggle:
|
|
icon: material/weather-sunny
|
|
name: Switch to light mode
|
|
|
|
markdown_extensions:
|
|
- admonition
|
|
- toc:
|
|
permalink: true
|
|
- tables
|
|
- attr_list
|
|
- md_in_html
|
|
- pymdownx.superfences
|
|
- pymdownx.highlight:
|
|
anchor_linenums: true
|
|
- pymdownx.inlinehilite
|
|
- pymdownx.tabbed:
|
|
alternate_style: true
|
|
- pymdownx.tasklist:
|
|
custom_checkbox: true
|
|
|
|
plugins:
|
|
- search
|
|
|
|
hooks:
|
|
- scripts/mkdocs_hooks.py
|
|
|
|
nav:
|
|
- Home: index.md
|
|
- Hardware:
|
|
- hardware/index.md
|
|
- Services:
|
|
- services/index.md
|
|
- House rules: house-rules.md
|