powersync-docs/mkdocs.yml
Patrick Schurig 9eee067829 feat: docs-as-code — générateur, literate-nav, badges, CI Gitea Actions
- PORTING_STATUS.yaml : source de vérité canal APT + placement nav
- scripts/gen_device_reference.py : génération matrice + fiches + SUMMARY.md
  depuis integrationplugin*.json + meta.json ; nightly sans JSON = invisible
- mkdocs.yml : plugin literate-nav, nav 6 sections, Appareils via SUMMARY.md
- .gitea/workflows/docs.yml : CI complet — fetch JSON (branche auto-détectée),
  génération, build --strict, check idempotence, rsync deploy
- Badges HTML (stable/testing/nightly + consumer/community + ok/part/road)
- Fiches appareils : Eastron, ABB B2x, ABB Terra, Keba, Waveshare
- requirements.txt : mkdocs-material, mkdocs-literate-nav, PyYAML

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-06-02 08:53:54 +02:00

84 lines
2.2 KiB
YAML

site_name: ETM PowerSync — Documentation
site_url: https://docs.etm-powersync.fr
site_description: >-
Documentation du HEMS ETM PowerSync : installation, fonctionnalités, compatibilité
des équipements. Gestion d'énergie locale bâtie sur nymea.io.
site_author: ETM-Schurig
copyright: >-
© ETM-Schurig — Documentation sous licence CC-BY 4.0 · exemples de code sous GPL-3.0
repo_url: https://github.com/etmschurig/powersync-docs
repo_name: etmschurig/powersync-docs
edit_uri: edit/main/docs/
theme:
name: material
language: fr
font:
text: IBM Plex Sans
code: IBM Plex Mono
palette:
scheme: slate # thème sombre, raccord avec la charte ETM
primary: custom # couleurs réelles définies dans stylesheets/extra.css
accent: custom
features:
- navigation.indexes
- navigation.top
- navigation.instant
- navigation.footer
- search.suggest
- search.highlight
- content.code.copy
- content.action.edit
icon:
repo: fontawesome/brands/github
extra_css:
- stylesheets/extra.css
markdown_extensions:
- admonition
- attr_list
- md_in_html
- tables
- toc:
permalink: true
- pymdownx.highlight:
anchor_linenums: true
- pymdownx.superfences
- pymdownx.details
- pymdownx.inlinehilite
- pymdownx.tabbed:
alternate_style: true
- pymdownx.emoji:
emoji_index: !!python/name:material.extensions.emoji.twemoji
emoji_generator: !!python/name:material.extensions.emoji.to_svg
plugins:
- search:
lang: fr
- literate-nav:
nav_file: SUMMARY.md
nav:
- Accueil: index.md
- Installation:
- installation/index.md
- Dépôt APT: installation/depot-apt.md
- Configuration: installation/configuration.md
- L'application: installation/application.md
- Appareils: appareils/
- Fonctionnalités:
- fonctionnalites/index.md
- Surplus solaire: fonctionnalites/surplus-solaire.md
- Délestage: fonctionnalites/delestage.md
- Gestion batterie: fonctionnalites/gestion-batterie.md
- Tarifs dynamiques: tarifs.md
- Référence:
- reference.md
- API REST: integrations/rest-api.md
- MQTT: integrations/mqtt.md
- Aide:
- Dépannage: depannage.md
- FAQ: faq.md