mkdocs.yml

site_name: Redbox
site_description: Bringing Generative AI to the way the Civil Service works
site_author: Incubator for AI
repo_url: https://github.com/i-dot-ai/redbox

theme:
  
  logo: assets/briefcase_white.svg
  favicon: assets/i-dot-ai.svg

  name: "material"
  font:
    text: "Inter"
    code: "DM Mono"
  palette:
    # Palette toggle for light mode
    - media: "(prefers-color-scheme: light)"
      scheme: default
      primary: custom
      toggle:
        icon: material/weather-sunny
        name: Switch to dark mode

    # Palette toggle for dark mode
    - media: "(prefers-color-scheme: dark)"
      scheme: slate
      primary: custom
      toggle:
        icon: material/weather-night
        name: Switch to light mode

  features:
    - content.tooltips
    - search.suggest
    - search.highlight
    - content.tabs.link
    - navigation.indexes
    - content.tooltips
    - navigation.path
    - content.code.annotate
    - content.code.copy
    - content.code.select
    - navigation.tabs
  

nav:
  - Home: index.md
  - Installation:
    - Overview: installation/index.md
    - Local Development: installation/local.md
    - AWS Deployment: installation/aws.md
  - Architecture:
    - Overview: architecture/index.md
    - Workers and Queues: architecture/workers_and_queues.md
    - Transactions and Schema: architecture/transactions_and_schema.md
    - Docker and Dependencies: architecture/docker_and_dependencies.md
  - Frontends:
    - Overview: frontends/index.md
  - Code Reference: 
    - Home: code_reference/index.md
    - Models: 
      - Overview: code_reference/models/index.md
      - File: code_reference/models/file.md
      - Embedding: code_reference/models/embedding.md
      - Settings: code_reference/models/settings.md
    - Storage:
      - Overview: code_reference/storage/index.md
      - ElasticsearchStorageHandler: code_reference/storage/elasticsearch_storage_handler.md
  - Contributing: contributing.md

plugins:
    minify:
      minify_html: true
    search: null
    mermaid2: null
    git-revision-date-localized:
      type: timeago
      locale: en
      fallback_to_build_date: true
    glightbox: null
    mkdocstrings:
      handlers:
        python:
          paths:
            - redbox-core
          options:
            extensions:
            - griffe_typingdoc
            show_root_heading: true
            show_if_no_docstring: true
            inherited_members: true
            members_order: source
            separate_signature: true
            unwrap_annotated: true
            filters:
            - '!^_'
            merge_init_into_class: true
            docstring_section_style: spacy
            signature_crossrefs: true
            show_symbol_type_heading: true
            show_symbol_type_toc: true

markdown_extensions:
  - abbr
  - attr_list
  - meta
  - admonition
  - pymdownx.details
  - pymdownx.highlight
  - pymdownx.snippets
  - pymdownx.superfences
  - pymdownx.pathconverter
  - codehilite:
      guess_lang: true
      use_pygments: true
  - pymdownx.tabbed:
      alternate_style: true 
  - pymdownx.superfences:
      custom_fences:
        - name: mermaid
          class: mermaid
          format: !!python/name:pymdownx.superfences.fence_code_format
  - pymdownx.snippets:
      auto_append:
        - docs/abbreviations.md

extra:
  social:
    - icon: fontawesome/brands/github
      link: https://github.com/i-dot-ai/redbox
    - icon: fontawesome/solid/envelope
      link: mailto:i-dot-ai-enquiries@cabinetoffice.gov.uk
    - icon: fontawesome/solid/globe
      link: https://ai.gov.uk
  generator: false



extra_css:
  - stylesheets/extra.css