mkdocs.yml

# arkhe のドキュメント。**Markdown だけで書けること**を最優先にしてある。
#   - 本文は docs/ 以下の .md。日本語は同じ名前に `.ja` を挟む（docs/index.ja.md）
#   - 図は Mermaid をコードブロックに書く（画像を書き出す手順を挟まない）
#   - API 仕様は実装から生成した openapi.json を読ませる（手で二重に書かない）
site_name: arkhe
site_description: ARK identifier infrastructure — minter and resolver as separate services
site_url: https://rcosdp.github.io/arkhe/
repo_url: https://github.com/RCOSDP/arkhe
repo_name: RCOSDP/arkhe
edit_uri: edit/main/docs/
copyright: MIT — National Institute of Informatics

theme:
  name: material
  language: en
  icon:
    logo: material/key-chain
    repo: fontawesome/brands/github
  font:
    text: Inter
    code: JetBrains Mono
  palette:
    - media: "(prefers-color-scheme: light)"
      scheme: default
      primary: deep purple
      accent: deep purple
      toggle: {icon: material/weather-night, name: Switch to dark mode}
    - media: "(prefers-color-scheme: dark)"
      scheme: slate
      primary: deep purple
      accent: deep purple
      toggle: {icon: material/weather-sunny, name: Switch to light mode}
  features:
    # navigation.instant は i18n の言語切替と両立しない（警告になる）
    - navigation.tracking
    - navigation.sections
    - navigation.top
    - navigation.footer
    - toc.follow
    - content.code.copy
    - content.action.edit
    - search.suggest
    - search.highlight

plugins:
  - search
  # 日英。**同じ名前に `.ja` を挟むだけ**で対訳になる（別ディレクトリを掘らない）。
  - i18n:
      docs_structure: suffix
      languages:
        - locale: en
          default: true
          name: English
          build: true
        - locale: ja
          name: 日本語
          build: true
          nav_translations:
            Introduction: はじめに
            Overview: arkhe とは
            Quickstart: クイックスタート
            Concepts: 考え方
            What ARK is: ARK とは何か
            Delegation: 委譲の構造
            Invariants: 壊さないもの
            Guides: 手引き
            Setting up for the first time: はじめて立ち上げるとき
            From minting to resolving, with curl: curl で採番から解決まで
            Authentication: 認証
            Admin interface: 管理画面
            Succession and departure: 承継と離脱
            Deployment: デプロイ
            Running several arkhe: 分散して運用する
            Reference: リファレンス
            Configuration: 設定
            CLI: コマンド
            Data model: データモデル
            API: API
            Errors: エラー
            Project: プロジェクト
            Contributing: 参加する
            Versioning: バージョン
            Changelog: 変更履歴

markdown_extensions:
  - abbr
  - admonition
  - attr_list
  - def_list
  - footnotes
  - md_in_html
  - tables
  - toc:
      permalink: true
      toc_depth: 3
      # **既定の slugify は非 ASCII を落とす。** 日本語見出しのアンカーが
      # `_1` `_2` … になり、深いリンクが使えないうえ、見出しを 1 つ足すと
      # 番号がずれて既存のリンクが黙って別の場所を指す。
      slugify: !!python/object/apply:pymdownx.slugs.slugify {kwds: {case: lower}}
  - pymdownx.details
  # **アイコンの `:material-…:` は emoji 拡張が変換している。** これが無いと、
  # 「どこから読むか」のカードに `:material-api:` という文字列がそのまま出る
  # （警告は出ない——未知の短縮記法はただの文字列として通るので、
  # `--strict` でも気づけない。実際にそのまま公開されていた）。
  - pymdownx.emoji:
      emoji_index: !!python/name:material.extensions.emoji.twemoji
      emoji_generator: !!python/name:material.extensions.emoji.to_svg
  - pymdownx.highlight: {anchor_linenums: true}
  - pymdownx.inlinehilite
  # ルートの CHANGELOG をドキュメントに取り込む（二重管理しない）
  - pymdownx.snippets: {base_path: ['.', 'docs']}
  - pymdownx.tabbed: {alternate_style: true}
  # Mermaid をそのまま書けるようにする（画像を書き出す手順を挟まない）
  - pymdownx.superfences:
      custom_fences:
        - name: mermaid
          class: mermaid
          format: !!python/name:pymdownx.superfences.fence_code_format

extra:
  alternate:
    - name: English
      link: /arkhe/
      lang: en
    - name: 日本語
      link: /arkhe/ja/
      lang: ja
  social:
    - icon: fontawesome/brands/github
      link: https://github.com/RCOSDP/arkhe

extra_css: [assets/extra.css]

nav:
  - Introduction:
      - Overview: index.md
      - Quickstart: quickstart.md
  - Concepts:
      - What ARK is: concepts/ark.md
      - Delegation: concepts/delegation.md
      - Invariants: concepts/invariants.md
  - Guides:
      - Setting up for the first time: guides/onboarding.md
      - From minting to resolving, with curl: guides/walkthrough.md
      - Authentication: guides/authentication.md
      - Admin interface: guides/admin.md
      - Succession and departure: guides/succession.md
      - Deployment: guides/deployment.md
      - Running several arkhe: guides/federation.md
  - Reference:
      - Configuration: reference/configuration.md
      - CLI: reference/cli.md
      - Data model: reference/data-model.md
      - API: reference/api.md
      - Errors: reference/errors.md
  - Project:
      - Contributing: project/contributing.md
      - Versioning: project/versioning.md
      - Changelog: project/changelog.md