fmt/mkdocs.yml

site_name: '{fmt}'

docs_dir: doc

repo_url: https://github.com/fmtlib/fmt

# Make the docs work locally without a server.
use_directory_urls: false

theme:
  name: material
  features:
    - navigation.tabs
    - toc.integrate

extra_javascript:
  - https://cdnjs.cloudflare.com/ajax/libs/highlight.js/10.7.2/highlight.min.js
  - fmt.js

extra_css:
  - https://cdnjs.cloudflare.com/ajax/libs/highlight.js/10.7.2/styles/default.min.css
  - fmt.css

markdown_extensions:
  - pymdownx.highlight:
      # Use JavaScript syntax highlighter instead of Pygments because it
      # automatically applies to code blocks extracted through Doxygen.
      use_pygments: false
      anchor_linenums: true
      line_spans: __span
      pygments_lang_class: true
  - pymdownx.inlinehilite
  - pymdownx.snippets

plugins:
  - mkdocstrings:
      default_handler: cxx

nav:
  - Usage: usage.md
  - API: api.md
  - Syntax: syntax.md
  # Make the {fmt} link work locally.
  - '': index.md

extra:
  version:
    provider: mike