mkdocs.yml

site_name: pyRevit
repo_url: https://github.com/pyrevitlabs/pyRevit
repo_name: pyrevitlabs/pyRevit

extra:
  homepage: https://pyrevitlabs.io

theme:
  name: material
  logo: static/pyRevitLogo.svg
  favicon: images/favicon.ico
  features:
    - content.code.select
    - content.code.copy
    - toc.follow
    - navigation.top
    - navigation.path
    - navigation.tabs
    - navigation.tabs.sticky
    - navigation.tracking
    - navigation.instant
    - navigation.instant.prefetch
    - navigation.sections
  palette:
    # Palette toggle for light mode
    - media: "(prefers-color-scheme: light)"
      scheme: default
      toggle:
        icon: material/brightness-7
        name: Switch to dark mode
    # Palette toggle for dark mode
    - media: "(prefers-color-scheme: dark)"
      scheme: slate
      toggle:
        icon: material/brightness-4
        name: Switch to light mode

extra_css:
  - styles.css

watch:
  - pyrevitlib/pyrevit

plugins:
  - search
  - gen-files:
      scripts:
        - docs/gen_ref_pages.py
  - section-index
  - mkdocstrings:
      default_handler: python
      handlers:
        python:
          paths: [pyrevitlib]
          options:
            members_order: source
            merge_init_into_class: true
            show_if_no_docstring: true
            show_category_heading: true
            inherited_members: true
            filters:
              - "!^_"
              - "^_HostApplication"
  - exclude:
      glob:
        - "*.py"
        - "*.rst"
  - literate-nav:
      nav_file: SUMMARY.md

markdown_extensions:
  - pymdownx.highlight:
      anchor_linenums: true
      line_spans: __span
      pygments_lang_class: true
  - pymdownx.inlinehilite
  - pymdownx.snippets
  - pymdownx.superfences
  - pymdownx.details
  - pymdownx.caret
  - pymdownx.keys
  - pymdownx.highlight
  - admonition
  - md_in_html
  - toc

nav:
  - Home: README.md
  - Developer Notes:
    - Repository organization: repo-organization.md
    - Developer Guide: dev-guide.md
    - Architecture: architecture.md
    - Contributing: CONTRIBUTING.md
    - Code Of Conduct: CODE_OF_CONDUCT.md
  - Security: SECURITY.md
  - Credits: CREDITS.md
  - Reference API: reference/