mkdocs.yml

site_name: CTLD
site_description: Combined Transport and Logistics Dispatcher for DCS World — modular rewrite.
site_url: https://veaf.github.io/CTLD/
repo_url: https://github.com/VEAF/CTLD
repo_name: VEAF/CTLD
docs_dir: docs
edit_uri: blob/develop/docs/

theme:
  name: material
  palette:
    - media: "(prefers-color-scheme: light)"
      scheme: default
      primary: indigo
      toggle:
        icon: material/weather-night
        name: Switch to dark mode
    - media: "(prefers-color-scheme: dark)"
      scheme: slate
      primary: indigo
      toggle:
        icon: material/weather-sunny
        name: Switch to light mode
  features:
    - navigation.tabs
    - navigation.sections
    - navigation.top
    - search.highlight
    - search.suggest
    - content.code.copy

markdown_extensions:
  - toc:
      permalink: true
  - admonition
  - attr_list
  - pymdownx.superfences:
      custom_fences:
        - name: mermaid
          class: mermaid
          format: !!python/name:pymdownx.superfences.fence_code_format

plugins:
  - search:
      lang: [en, fr]
  - i18n:
      docs_structure: suffix
      languages:
        - locale: en
          default: true
          name: English
          build: true
        - locale: fr
          name: Français
          build: true
          nav_translations:
            Home: Accueil
            Pilot: Pilote
            Overview: Vue d'ensemble
            Troop transport: Transport de troupes
            Crates: Caisses (crates)
            Vehicles: Véhicules
            Sling-load: Élingue (sling-load)
            Parachute: Parachute
            JTAC: JTAC
            Recon: Reconnaissance (recon)
            Beacons: Balises (beacons)
            Smoke: Fumigène (smoke)
            Pack: Pack
            Mission Maker: Concepteur de mission (mission maker)
            Configuration: Configuration
            Configure with ctld-tools: Configurer avec ctld-tools
            Zone setup: Configuration des zones
            Scenes & FOB: Scènes & FOB
            Crate catalogue: Catalogue de caisses (crates)
            Minefield: Champ de mines
            Validating your config: Valider votre configuration
            Translations: Traductions
            Legacy API: API historique
            Developer: Développeur
            Development workflow: Workflow de développement
            Architecture: Architecture
            Subsystems: Sous-systèmes
            Scene engine: Moteur de scènes
            Crate spawn pipeline: Pipeline de spawn des caisses (crates)
            Troop + JTAC lifecycle: Cycle de vie troupes + JTAC (troops)
            Zone management: Gestion des zones
            Vehicle system: Système de véhicules
            Beacon system: Système de balises (beacons)
            Recon system: Système de reconnaissance (recon)
            F10 menu system: Système de menu F10
            Player tracking: Suivi des joueurs
            AA system assembly: Assemblage des systèmes AA
            Events: Événements
            Internationalisation: Internationalisation
            Building & testing: Build et tests
            Integration testing: Tests d'intégration
            Migration v1 → v2: Migration v1 → v2
            API reference: Référence de l'API
            Design spec: Spécification de conception

extra:
  version:
    provider: mike
    default: dev

# NOTE: docs are role-based and bilingual (EN + FR). Pilot + Mission Maker sections
# are the user-facing guides (DOC-USER-ROLES); Developer is the technical docs
# (DOC-TECH); the Integration Testing page is revised in DCS-BRIDGE-MCP.
nav:
  - Home: index.md
  - Pilot:
    - Overview: pilot/index.md
    - Troop transport: pilot/troop-transport.md
    - Crates: pilot/crates.md
    - Vehicles: pilot/vehicles.md
    - Sling-load: pilot/slingload.md
    - Parachute: pilot/parachute.md
    - JTAC: pilot/jtac.md
    - Recon: pilot/recon.md
    - Beacons: pilot/beacons.md
    - Smoke: pilot/smoke.md
    - Pack: pilot/pack.md
  - Mission Maker:
    - Overview: mission-maker/index.md
    - Configuration: mission-maker/configuration.md
    - Configure with ctld-tools: mission-maker/ctld-tools.md
    - Zone setup: mission-maker/zones.md
    - Scenes & FOB: mission-maker/scenes-fob.md
    - Crate catalogue: mission-maker/crates-catalogue.md
    - Minefield: mission-maker/minefield.md
    - Validating your config: mission-maker/asset-validation.md
    - Translations: mission-maker/translations.md
    - Legacy API: mission-maker/legacy-api.md
  - Developer:
    - Overview: developer/index.md
    - Development workflow: developer/workflow.md
    - Architecture: developer/architecture.md
    - Subsystems:
      - Overview: developer/subsystems/index.md
      - Scene engine: developer/subsystems/scenes.md
      - Crate spawn pipeline: developer/subsystems/crates.md
      - Troop + JTAC lifecycle: developer/subsystems/troops-jtac.md
      - Zone management: developer/subsystems/zones.md
      - Vehicle system: developer/subsystems/vehicles.md
      - Beacon system: developer/subsystems/beacons.md
      - Recon system: developer/subsystems/recon.md
      - F10 menu system: developer/subsystems/menu.md
      - Player tracking: developer/subsystems/players.md
      - AA system assembly: developer/subsystems/aa.md
    - Events: developer/events.md
    - Internationalisation: developer/i18n.md
    - Building & testing: developer/building-and-testing.md
    - Integration testing: developer/integration-testing.md
    - Migration v1 → v2: developer/migration-v1-v2.md
    - API reference: developer/api-reference.md
    - Design spec: developer/design-spec.md