mkdocs.yml

site_name: Exordos Core
site_url: https://github.com/exordos/
repo_name: exordos_core
repo_url: https://github.com/exordos/exordos_core
edit_uri: browse/docs/
copyright: Copyright © 2025-2026 Genesis Corporation
use_directory_urls: false

theme:
  name: zensical
  variant: modern
  language: en
  features:
    - search.suggest
    - search.highlight
    - navigation.tabs
    - navigation.tabs.sticky
    - navigation.sections
    - navigation.expand
    - navigation.indexes
    - content.code.copy
  palette:
    - scheme: default
      primary: indigo
      toggle:
        icon: lucide/sun
        name: Switch to dark mode
    - scheme: slate
      primary: indigo
      toggle:
        icon: lucide/moon
        name: Switch to light mode

plugins:
  - i18n:
      docs_structure: suffix
      fallback_to: en
      languages:
        - locale: en
          default: true
          name: English
          build: true
        - locale: ru
          name: Русский
          build: true
          nav_translations:
            Software: Продукт
            Usage: Использование
            Platform Overview: Обзор платформы
            Licensing: Лицензирование
            Local Deployment: Локальное развёртывание
            Admin Guide: Руководство администратора
            Support: Поддержка
            Security: Безопасность
            Troubleshooting: Устранение неполадок
            Wizard: Мастер настройки
            Developers: Разработчикам
            App Guide: Руководство по приложениям
            Core Guide: Руководство по ядру
            OpenAPI: OpenAPI
            Boot API: Boot API
            Orch API: Orch API
            Status API: Status API
            User API: User API
            Element: Элементы
            Manifest: Манифест
            API: API
            Service as a Service API: Service as a Service API
            Example commands: Примеры команд
            IAM: IAM
            Permissions: Права доступа
            Network: Сеть
            LBaaS API: LBaaS API
            Secrets: Секреты
            Certificates: Сертификаты
            Passwords: Пароли
  - search:
      lang:
        - en
        - ru
  - glightbox
  - render_swagger


extra:
  repo_icon: github
  alternate:
    - name: English
      link: ./
      lang: en
    - name: Русский
      link: ./index.ru.html
      lang: ru

extra_javascript:
  - javascripts/i18n-nav.js

markdown_extensions:
  - meta
  - admonition
  - footnotes
  - attr_list
  - pymdownx.highlight:
      anchor_linenums: true
      line_spans: __span
      pygments_lang_class: true
  - toc:
      slugify: !!python/name:pymdownx.slugs.uslugify
      permalink: '#'
  - pymdownx.arithmatex
  - pymdownx.betterem:
      smart_enable: all
  - pymdownx.keys
  - pymdownx.emoji:
      emoji_index: !!python/name:zensical.extensions.emoji.twemoji
      emoji_generator: !!python/name:zensical.extensions.emoji.to_svg
  - pymdownx.caret
  - pymdownx.critic
  - pymdownx.details
  - pymdownx.inlinehilite
  - pymdownx.magiclink
  - pymdownx.mark
  - pymdownx.smartsymbols
  - pymdownx.superfences:
      preserve_tabs: true
      custom_fences:
        - name: mermaid
          class: mermaid
          format: !!python/name:pymdownx.superfences.fence_code_format
  - pymdownx.tasklist:
      custom_checkbox: true
  - pymdownx.tilde
  - pymdownx.tabbed:
      alternate_style: true

nav:
  - Software: index.md
  - Usage:
    - Platform Overview: usage/platform-overview.md
    - Licensing: usage/licensing.md
    - Local Deployment: usage/local_deployment.md
    - Admin Guide: usage/admin-guide.md
    - Support: usage/support-lifecycle.md
    - Security: usage/security.md
    - Troubleshooting: usage/troubleshooting.md
    - Wizard: usage/wizard.md
  - Developers:
    - App Guide: app-developer-guide/app-guide.md
    - Core Guide: core-developer-guide/core-guide.md
    - Repo Proxy: core-developer-guide/repo-proxy.md
  - OpenAPI:
    - User API: openapi/openapi_user.md
    - Boot API: openapi/openapi_boot.md
    - Orch API: openapi/openapi_orch.md
    - Status API: openapi/openapi_status.md
  - Element:
    - Manifest: em/manifest.md
    - API: em/api_documentation.md
    - Service as a Service API: em/service.md
    - Example commands: em/cli.md
  - IAM:
    - Permissions: iam/permissions_overview.md
  - Network:
    - LBaaS API: network/load_balancer.md
  - Secrets:
      - Certificates: secret/certificates.md
      - Passwords: secret/passwords.md