mkdocs.yml

site_name: Multilingual Programming
site_description: >-
  A programming language that lets you write in 17 human languages —
  powered by a Python interpreter, WASM backend, and a browser playground.
site_url: https://johnsamuel.info/multilingual/
repo_url: https://github.com/johnsamuelwrites/multilingual
repo_name: johnsamuelwrites/multilingual
edit_uri: edit/main/docs/

theme:
  name: material
  palette:
    # Light mode
    - media: "(prefers-color-scheme: light)"
      scheme: default
      primary: deep purple
      accent: cyan
      toggle:
        icon: material/weather-night
        name: Switch to dark mode
    # Dark mode
    - media: "(prefers-color-scheme: dark)"
      scheme: slate
      primary: deep purple
      accent: cyan
      toggle:
        icon: material/weather-sunny
        name: Switch to light mode
  features:
    - navigation.tabs
    - navigation.tabs.sticky
    - navigation.sections
    - navigation.expand
    - navigation.top
    - navigation.footer
    - navigation.instant
    - navigation.instant.progress
    - search.suggest
    - search.highlight
    - search.share
    - content.code.copy
    - content.code.annotate
    - content.tabs.link
    - announce.dismiss
  icon:
    repo: fontawesome/brands/github
    edit: material/pencil
  font:
    text: Inter
    code: JetBrains Mono
  logo: assets/multilingual_pipeline_surface.svg
  favicon: assets/multilingual_pipeline_surface.svg

docs_dir: docs
exclude_docs: |
  _generated/README.md

nav:
  - Home: index.md
  - Playground: playground.md
  - Guide FR: fr/programmation.md
  - Project:
    - Release Notes: _generated/RELEASE.md
    - Changelog: CHANGELOG.md
    - Releasing: releasing.md
    - Development Guide: development.md
    - Backend Testing Quick Start: BACKEND_TESTING_QUICK_START.md
    - Backend Testing Strategy: BACKEND_TESTING_STRATEGY.md
    - Contributing: development.md
  - Reference:
    - Detailed Reference: reference.md
    - Compatibility Matrix: compatibility_matrix.md
    - Compatibility Roadmap (3.12): compatibility_roadmap.md
    - Python 3.12 Feature Checklist: python312_feature_checklist.md
    - Language Onboarding: language_onboarding.md
  - Design:
    - Design Overview: design.md
    - Core Spec: core_spec.md
    - Frontend Contracts: frontend_contracts.md
    - Evaluation Plan: evaluation_plan.md
    - Related Work: related_work.md
  - Localization:
    - Translation Guidelines: translation_guidelines.md
    - CNL Scope: cnl_scope.md
    - Stdlib Localization: stdlib_localization.md
    - Naturalness Notes: word_order_and_naturalness.md
  - WASM:
    - Installation: WASM_INSTALLATION.md
    - Development: WASM_DEVELOPMENT.md
    - Performance Tuning: WASM_PERFORMANCE_TUNING.md
    - Troubleshooting: WASM_TROUBLESHOOTING.md
    - FAQ: WASM_FAQ.md
    - Architecture Overview: WASM_ARCHITECTURE_OVERVIEW.md
    - Upgrade Guide: UPGRADE_TO_WASM.md

markdown_extensions:
  - admonition
  - attr_list
  - md_in_html
  - tables
  - footnotes
  - toc:
      permalink: true
      title: On this page
  - pymdownx.highlight:
      anchor_linenums: true
      line_spans: __span
      pygments_lang_class: true
  - pymdownx.inlinehilite
  - pymdownx.superfences:
      custom_fences:
        - name: mermaid
          class: mermaid
          format: !!python/name:pymdownx.superfences.fence_code_format
  - pymdownx.tabbed:
      alternate_style: true
  - pymdownx.details
  - pymdownx.emoji:
      emoji_index: !!python/name:material.extensions.emoji.twemoji
      emoji_generator: !!python/name:material.extensions.emoji.to_svg
  - pymdownx.keys
  - pymdownx.mark
  - pymdownx.smartsymbols
  - pymdownx.tasklist:
      custom_checkbox: true

extra:
  social:
    - icon: fontawesome/brands/github
      link: https://github.com/johnsamuelwrites/multilingual
      name: GitHub
  generator: false

extra_css:
  - assets/extra.css