# LLM Wiki — MkDocs Configuration
# Serves the wiki as a beautiful documentation site with full-text search.
# Edit this to customize the theme, nav structure, or plugins.

site_name: "LLM Wiki"
site_description: "Personal knowledge base — maintained by LLM agents"
site_url: ""
repo_url: ""
edit_uri: ""
docs_dir: docs
site_dir: site

theme:
  name: material
  language: en
  palette:
    primary: indigo
    accent: teal
  features:
    - navigation.tabs
    - navigation.sections
    - navigation.expand
    - navigation.top
    - navigation.indexes
    - search.highlight
    - search.suggest
    - content.code.copy
    - content.tooltips

plugins:
  - search:
      lang: en
  - tags:
      tags_file: tags.md

markdown_extensions:
  - abbr
  - admonition
  - attr_list
  - def_list
  - footnotes
  - md_in_html
  - toc:
      permalink: true
  - pymdownx.highlight:
      anchor_linenums: true
  - pymdownx.inlinehilite
  - pymdownx.snippets
  - pymdownx.superfences
  - pymdownx.tabbed:
      alternate_style: true
  - pymdownx.details
  - pymdownx.tasklist:
      custom_checkbox: true
  - pymdownx.critic
  - pymdownx.caret
  - pymdownx.keys
  - pymdownx.mark
  - pymdownx.tilde

extra:
  social: []

# === Wiki Navigation ===
# The LLM agent updates this section as the wiki grows.
# Categories mirror Karpathy's LLM Wiki architecture:
#   - Overview  → index, synthesis, tags
#   - Wiki      → entity pages, concept pages, comparisons
#   - Sources   → ingested documents (one page per source)
#   - Raw       → direct access to raw source content (linked, not separate)

nav:
  - Home: index.md
  - Wiki:
      - wiki/index.md
  - Sources:
      - sources/index.md
  - Raw Sources: raw/
  - Schema: schema/AGENTS.md
  - Log: log.md