powersync-docs/mkdocs.yml

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
  # `false` supprime le preconnect fonts.gstatic.com et la feuille
  # fonts.googleapis.com que Material injecte sinon dans le <head>.
  # Les polices sont auto-hébergées : voir les @font-face de
  # docs/stylesheets/extra.css et les woff2 de docs/assets/fonts/.
  font: false
  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        # RETIRÉ (multi-langue, 2026-10-12) :
    #   incompatible avec le lien contextuel du sélecteur de langue de
    #   mkdocs-static-i18n, et l'avertissement fait échouer `mkdocs build --strict`.
    #   Le sélecteur l'emporte : il ramène sur la même page dans l'autre langue.
    - 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:
      # Schémas Mermaid (page « Comment le moteur décide ») : Material les dessine côté navigateur.
      custom_fences:
        - name: mermaid
          class: mermaid
          format: !!python/name:pymdownx.superfences.fence_code_format
  - 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:
  # i18n AVANT literate-nav et search : il réécrit l'arbre des fichiers par langue,
  # les autres doivent voir l'arbre déjà localisé.
  - i18n:
      docs_structure: suffix          # index.md (fr) · index.de.md · index.en.md
      fallback_to_default: true       # pas de page absente : on retombe sur le FR
      reconfigure_material: true      # bascule de langue dans le header Material
      reconfigure_search: true        # un index de recherche par langue
      languages:
        - locale: fr
          name: Français
          default: true
          build: true
          site_name: ETM PowerSync — Documentation
          theme:
            language: fr
        - locale: de
          name: Deutsch
          build: true
          site_name: ETM PowerSync — Dokumentation
          theme:
            language: de
          nav_translations:
            Accueil: Startseite
            Installation: Installation
            Appareils: Geräte
            EMS — moteur à règles: EMS — Regelbasierte Engine
            Comment le moteur décide: Wie die Engine entscheidet
            Optimiseur: Optimierer
            Protocole: Protokoll
            Contrat: Vertrag
            Écrire un optimiseur: Einen Optimierer schreiben
            API: API
            Aide: Hilfe
            Compatibilité: Kompatibilität
            Dépôt APT: APT-Repository
            Configuration: Konfiguration
            L'application: Die App
            Surplus solaire: Solarüberschuss
            Délestage: Lastabwurf
            Gestion batterie: Speicherverwaltung
            Prévision PV: PV-Prognose
            Tarifs dynamiques: Dynamische Tarife
            API JsonRPC: JSON-RPC-API
            Référence API: API-Referenz
            Dépannage: Fehlersuche
            FAQ: FAQ
            Compteurs: Zähler
            Bornes de recharge: Wallboxen
            SmartDevices: SmartDevices
            HVAC: HVAC
            Onduleurs / PV: Wechselrichter / PV
            Batteries / ESS: Speicher / ESS
            Tarifs & prévisions: Tarife & Prognosen
            Types génériques: Generische Typen
            API — Métier: API — Fachlich
            API — Système: API — System
            Compteur ABB B2x: ABB-B2x-Zähler
            Borne ABB Terra AC: ABB Terra AC Ladestation
        - locale: en
          name: English
          build: true
          site_name: ETM PowerSync — Documentation
          theme:
            language: en
          nav_translations:
            Accueil: Home
            Installation: Installation
            Appareils: Devices
            EMS — moteur à règles: EMS — rule engine
            Comment le moteur décide: How the engine decides
            Optimiseur: Optimizer
            Protocole: Protocol
            Contrat: Contract
            Écrire un optimiseur: Writing an optimizer
            API: API
            Aide: Help
            Compatibilité: Compatibility
            Dépôt APT: APT repository
            Configuration: Configuration
            L'application: The app
            Surplus solaire: Solar surplus
            Délestage: Load shedding
            Gestion batterie: Battery management
            Prévision PV: PV forecast
            Tarifs dynamiques: Dynamic tariffs
            API JsonRPC: JSON-RPC API
            Référence API: API reference
            Dépannage: Troubleshooting
            FAQ: FAQ
            Compteurs: Meters
            Bornes de recharge: EV chargers
            SmartDevices: SmartDevices
            HVAC: HVAC
            Onduleurs / PV: Inverters / PV
            Batteries / ESS: Batteries / ESS
            Tarifs & prévisions: Tariffs & forecasts
            Types génériques: Generic types
            API — Métier: API — Domain
            API — Système: API — System
            Compteur ABB B2x: ABB B2x meter
            Borne ABB Terra AC: ABB Terra AC charging station
  - 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/
  # Partie technique : trois sections qui suivent l'architecture (2026-10-18).
  # Les fichiers n'ont pas bougé : seules les étiquettes changent, les URL restent.
  - EMS — moteur à règles:
      - fonctionnalites/index.md
      - Comment le moteur décide: fonctionnalites/moteur.md
      - Surplus solaire: fonctionnalites/surplus-solaire.md
      - Délestage: fonctionnalites/delestage.md
      - Gestion batterie: fonctionnalites/gestion-batterie.md
      - Prévision PV: fonctionnalites/prevision-pv.md
      - Tarifs dynamiques: tarifs.md
  - Optimiseur:
      - optimiseur/index.md
      - Protocole: optimiseur/protocole.md
      - Contrat: optimiseur/contrat.md
      - Écrire un optimiseur: optimiseur/ecrire.md
  - API:
      - reference.md
      - API JsonRPC: integrations/jsonrpc-api.md
      - Référence API: api/
      - MQTT: integrations/mqtt.md
  - Aide:
      - Dépannage: depannage.md
      - FAQ: faq.md