mkdocs.yml

extra_css:
  - assets/css/extra.css

site_name: DiracX
repo_url: https://github.com/DIRACGrid/diracx
site_url: https://diracx.io/
site_description: >-
  Write your documentation in Markdown and create a professional static site in
  minutes – searchable, customizable, in 60+ languages, for all devices

theme:
  name: material
  palette:
    - media: "(prefers-color-scheme)"
      toggle:
        icon: material/theme-light-dark
        name: Switch to light mode
    - media: "(prefers-color-scheme: light)"
      scheme: default
      toggle:
        icon: material/weather-sunny
        name: Switch to dark mode
    - media: "(prefers-color-scheme: dark)"
      scheme: slate
      toggle:
        icon: material/weather-night
        name: Switch to system preference
  font:
    text: Roboto
    code: Roboto Mono
  logo: assets/images/logo.svg
  icon:
    logo: logo
  features:
    - content.action.edit
    - content.code.annotate
    - content.code.copy
    - content.tabs.link
    - header.autohide
    - navigation.expand
    - navigation.indexes
    - navigation.instant
    - navigation.instant.progress
    - navigation.tabs
    - navigation.tabs.sticky
  custom_dir: docs/overrides/

nav:
  - Home: index.md

  - Roadmap: roadmap.md

  - User Guide:
    - user/index.md
    - Getting started: user/tutorials/getting-started.md
    - Known installations: user/reference/known-installations.md
    - Web:
      - user/web/index.md
      - Logging in: user/web/login_out.md
    - Programmatic Usage:
      - user/reference/programmatic-usage/index.md
      - Command Line: user/reference/programmatic-usage/command-line-interface.md
      - Python: user/reference/programmatic-usage/python-interface.md
      - HTTPS: user/reference/programmatic-usage/https-interface.md
    - Reference:
      - Client Config: user/reference/client-configuration.md

  - Administrator Guide:
    - admin/index.md
    - Tutorials:
      - Run locally: admin/tutorials/run_locally.md
    - How-To:
      - install:
        - Install kubernetes: admin/how-to/install/install-kubernetes.md
        - Installing DiracX: admin/how-to/install/installing.md
        - Convert CS: admin/how-to/install/convert-cs.md
        - Register a VO: admin/how-to/install/register-a-vo.md
        - Register the admin VO: admin/how-to/install/register-the-admin-vo.md
      - Debugging: admin/how-to/debugging.md
      - Upgrading: admin/how-to/upgrading.md
      - Rotate a secret: admin/how-to/rotate-a-secret.md
    - Explanations:
      - Configuration: admin/explanations/configuration.md
      - OpenTelemetry: admin/explanations/opentelemetry.md
      - Chart structure: admin/explanations/chart-structure.md
      - Databases: admin/explanations/database-management.md
      - Sandbox Store: admin/explanations/sandbox-store.md
    - Reference:
      - Security Model: admin/reference/security_model.md
      - Charts values: admin/reference/values.md

  - Developer Guide:
    - dev/index.md
    - Getting started: dev/tutorials/getting-started.md
    - Tutorials:
      - Larger developments: dev/tutorials/larger-developments.md
      - Developing DiracX Web: dev/tutorials/develop-web.md
      - Run a full DiracX instance locally: dev/tutorials/run-locally.md
      - Play with auth: dev/tutorials/play-with-auth.md
    - How-To:
      - Contribute: dev/how-to/contribute.md
      - Write docs: dev/how-to/write-docs.md
      - Add functionality:
        - dev/how-to/add-functionality/index.md
        - New route or router: dev/how-to/add-a-route.md
        - New task: dev/how-to/add-a-task.md
        - New DB: dev/how-to/add-a-db.md
        - New CLI command: dev/how-to/add-a-cli-command.md
        - New settings: dev/how-to/add-a-setting.md
      - Develop legacy DIRAC: dev/how-to/develop-legacy-dirac.md
      - Use the demo:
        - dev/how-to/use-the-demo/index.md
        - Accessing the client: dev/how-to/use-the-demo/swagger.md
        - Use swagger: dev/how-to/use-the-demo/swagger.md
        - Accessing DiracX Web: dev/how-to/use-the-demo/web.md
      - Client customization: dev/how-to/client-customization.md
      - Client generation: dev/how-to/client-generation.md
      - Client extensions: dev/how-to/client-extension.md
    - Explanations:
      - Components:
        - Introduction: dev/explanations/components/index.md
        - API: dev/explanations/components/api.md
        - CLI: dev/explanations/components/cli.md
        - Databases: dev/explanations/components/db.md
        - Routes: dev/explanations/components/routes.md
      - Client: dev/explanations/client.md
      - Testing: dev/explanations/testing.md
      - Run demo: dev/explanations/run_demo.md
      - Extensions: dev/explanations/extensions.md
    - Reference:
      - Writing tests: dev/reference/writing-tests.md
      - Coding conventions: dev/reference/coding-conventions.md
      - Configuration: dev/reference/configuration.md
      - Dependency injection: dev/reference/dependency-injection.md

markdown_extensions:
  - admonition
  - md_in_html
  - def_list
  - pymdownx.tasklist:
      custom_checkbox: true
  - attr_list
  - pymdownx.emoji:
      emoji_index: !!python/name:material.extensions.emoji.twemoji
      emoji_generator: !!python/name:material.extensions.emoji.to_svg
  - pymdownx.details
  - pymdownx.superfences:
      custom_fences:
        - name: mermaid
          class: mermaid
          format: !!python/name:pymdownx.superfences.fence_code_format
  - pymdownx.inlinehilite
  - pymdownx.snippets
  - pymdownx.highlight:
      anchor_linenums: true
      line_spans: __span
      pygments_lang_class: true
  - pymdownx.tabbed:
      alternate_style: true
  - tables

plugins:
  - diracx:
      repos:
        - url: https://github.com/DIRACGrid/diracx-charts
          branch: master
          include:
            - docs
            - diracx
        - url: https://github.com/DIRACGrid/diracx-web
          branch: main
          include:
            - docs
  - search