mkdocs.yml

site_name: MkNodes (MkDocs plugin)
site_description: "Don´t write docs. Code them."
repo_url: "https://github.com/phil65/mkdocs_mknodes/"
site_url: https://phil65.github.io/mkdocs-mknodes/
site_author: Philipp Temminghoff
copyright: Copyright © 2023 Philipp Temminghoff
build_fn: mkdocs_mknodes.manual.root:Build.build
show_page_info: true
global_resources: false
theme:
    name: material
    custom_dir: overrides
    icon:
        logo: material/graph-outline
    palette:
        # Palette toggle for automatic mode
        - media: "(prefers-color-scheme)"
          toggle:
              icon: material/brightness-auto
              name: Switch to light mode

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

        # Palette toggle for dark mode
        - media: "(prefers-color-scheme: dark)"
          scheme: slate
          primary: custom
          toggle:
              icon: material/brightness-4
              name: Switch to system preference
    features:
        - announce.dismiss
        - content.action.edit
        - content.code.copy
        - content.code.select
        - content.code.annotate
        - content.tooltips
        # - content.tabs.link
        - navigation.tracking # update URL based on current item in TOC
        - navigation.path # shows breadcrumbs
        - navigation.tabs # make top level tabs
        - navigation.indexes # documents can be directly attached to sections (overview pages)
        - navigation.footer # next/previous page buttons in footer
        - navigation.top # adds back-to-top button
        # - navigation.sections # top-level sections are rendered as groups
        # - navigation.expand # expand all subsections in left sidebar by default
        - toc.follow # makes toc follow scrolling
        # - toc.integrate  # integrates toc into left menu
        - search.highlight
        - search.suggest
    # - search.share

plugins:
    - search
    - mknodes
    - mkdocstrings:
          default_handler: python
          handlers:
              python:
                  import:
                      - url: https://docs.python.org/3/objects.inv
                        domains: [std, py]
                      - url: https://phil65.github.io/mknodes/objects.inv
                        domains: [std, py]
                  options:
                      extensions:
                          - griffe_fieldz: { include_inherited: true }
                          # - griffe_pydantic:
                          #     schema: true
                      # https://mkdocstrings.github.io/python/usage/
                      show_signature_annotations: true
                      show_symbol_type_toc: true
                      show_symbol_type_heading: true
                      show_root_toc_entry: false
                      # merge_init_into_class: true
                      ignore_init_summary: true
                      inherited_members: false
                      signature_crossrefs: true
                      separate_signature: true
                      line_length: 90
                  preload_modules:
                      - mknodes
markdown_extensions:
    - attr_list
    - pymdownx.emoji
    - toc:
          permalink: true
# extra:
#   social:
# - icon: fontawesome/brands/github
#   link: https://github.com/phil65
# - icon: fontawesome/brands/gitter
#   link: https://matrix.to/#/#mknodes:gitter.im
# - icon: fontawesome/brands/python
#   link: https://pypi.org/project/mknodes/
# generator: false disable "made with Material"
# version:  # multiple doc versions
#   provider: mike