mkdocs.yml

site_name: Fractal Server

repo_url: https://github.com/fractal-analytics-platform/fractal-server
repo_name: fractal-server

markdown_extensions:
- admonition
- pymdownx.details
- pymdownx.emoji
- pymdownx.magiclink
- pymdownx.snippets:
    check_paths: true
- pymdownx.superfences
- pymdownx.tabbed:
    alternate_style: true
- pymdownx.tasklist
- toc:
    permalink: true
- attr_list
- md_in_html


theme:
  name: "material"
  logo: https://raw.githubusercontent.com/fractal-analytics-platform/fractal-logos/refs/heads/main/common/fractal_logo.png
  favicon: https://raw.githubusercontent.com/fractal-analytics-platform/fractal-logos/refs/heads/main/common/fractal_favicon.png
  custom_dir: "docs/overrides"
  features:
    - content.code.annotate
    - content.code.copy
  palette:
  - media: "(prefers-color-scheme: light)"
    scheme: default
    primary: teal
    accent: green
    toggle:
      icon: material/weather-sunny
      name: Switch to dark mode
  - media: "(prefers-color-scheme: dark)"
    scheme: slate
    primary: teal
    accent: green
    toggle:
      icon: material/weather-night
      name: Switch to light mode
  icon:
    repo: fontawesome/brands/github
  navigation:
    expand: true

nav:
  - Home page: index.md
  - Install and deploy: install_and_deploy.md
  - Configuration: configuration.md
  - Internals: internals/
  - Code reference: reference/
  - Changelog: changelog.md
  - Web API: openapi.md
  - Development: development.md

watch:
  - fractal_server

plugins:
  - search
  - autorefs
  - gen-files:
      scripts:
        - docs/gen_ref_pages.py
  - literate-nav:
      nav_file: SUMMARY.md
  - section-index
  - mkdocstrings:
      default_handler: python
      handlers:
        python:
          options:
            show_signature_annotations: false
            docstring_section_style: "table"
            docstring_style: "google"
            show_source: true
            filters: []
            show_root_full_path: false
  - render_swagger

extra_css:
  - extra.css

copyright: |
  © Copyright 2022
  Friedrich Miescher Institute for Biomedical Research and
  University of Zurich
  (see <u><a href="https://github.com/fractal-analytics-platform/fractal-server/blob/main/LICENSE">
  LICENSE
  </a></u>).