site_name: beautyspot
site_url: https://neelbauman.github.io/beautyspot/
repo_url: https://github.com/neelbauman/beautyspot
repo_name: neelbauman/beautyspot
edit_uri: edit/main/docs/

# テーマ設定: Material for MkDocs
theme:
  name: material
  palette:
    # ライトモード
    - scheme: default
      primary: black
      accent: indigo
      toggle:
        icon: material/weather-night
        name: Switch to dark mode
    # ダークモード（beautyspotの"moon"コンセプトに合わせて）
    - scheme: slate
      primary: black
      accent: indigo
      toggle:
        icon: material/weather-sunny
        name: Switch to light mode
  features:
    - navigation.expand
    - content.code.copy
    - content.code.annotate
  icon:
    repo: fontawesome/brands/github

# 拡張機能設定
markdown_extensions:
  - admonition
  - pymdownx.details
  - pymdownx.highlight:
      anchor_linenums: true
  - pymdownx.superfences:
      custom_fences:
        # Mermaid記法のサポート
        - name: mermaid
          class: mermaid
          format: !!python/name:pymdownx.superfences.fence_code_format

# プラグイン設定
plugins:
  - search
  - mkdocstrings:
      handlers:
        python:
          paths: [src]
          options:
            show_root_heading: true
            show_source: true

# ナビゲーション構造
nav:
  - Home: index.md
  - Getting Started: guides/usage_patterns.md
  - Cookbooks:
      - Custom Types: cookbooks/custom_types.md
      - Imperative Caching: cookbooks/imperative_caching.md
      - Advanced Key Generation: cookbooks/key_generation.md
      - Cloud Storage: cookbooks/cloud_storage.md
      - Task-specific Serializers: cookbooks/task_serializer.md
      - Web Scraping: cookbooks/web_scraping.md
      - ML Pipelines: cookbooks/ml_pipelines.md
      - Web Applications (FastAPI): cookbooks/web_apps.md
      - LLM Ecosystem: cookbooks/llm_apps.md
      - Testing: cookbooks/testing.md
  - User Guides:
      - Caching Strategy: guides/caching.md
      - Data Serialization: guides/serialization.md
      - Data Lifecycle: guides/lifecycle.md
      - Custom Backends (DI): guides/custom_backend.md
      - Rate Limiting: guides/rate_limiting.md
      - CLI & Dashboard: guides/cli.md
  - Reference:
      - CacheManager: reference/cache.md
      - CacheKey: reference/cachekey.md
      - Spot (Core): reference/core.md
      - Content Types: reference/content_types.md
      - CacheDB: reference/db.md
      - Exceptions: reference/exceptions.md
      - Hooks: reference/hooks.md
      - Lifecycle: reference/lifecycle.md
      - Limiter: reference/limiter.md
      - Maintenance Service: reference/maintenance.md
      - Serializer: reference/serializer.md
      - Storage: reference/storage.md
      - Types: reference/types.md
  - Topics:
      - Philosophy: philosophy.md
      - Architecture: quality_report.md
