mkdocs.yml

site_name: hikari
site_url: https://docs.hikari-py.dev/
site_dir: public/docs

repo_url: https://github.com/hikari-py/hikari/
repo_name: hikari-py/hikari
edit_uri: blob/master/docs/

watch: [ hikari, README.md, CHANGELOG.md, changes/, scripts/docs ]
copyright: © 2021-present davfsa

#strict: true

theme:
  name: material
  font:
    code: JetBrains Mono

  logo: logo.png
  favicon: logo.png

  icon:
    repo: fontawesome/brands/github
    edit: material/pencil
    view: material/eye
    admonition:
      note: octicons/tag-16
      abstract: octicons/checklist-16
      info: octicons/info-16
      tip: octicons/squirrel-16
      success: octicons/check-16
      question: octicons/question-16
      warning: octicons/alert-16
      failure: octicons/x-circle-16
      danger: octicons/zap-16
      bug: octicons/bug-16
      example: octicons/beaker-16
      quote: octicons/quote-16

  palette:
    - media: "(prefers-color-scheme: light)"
      scheme: default
      primary: deep purple
      accent: deep purple
      toggle:
        icon: material/lightbulb
        name: Switch to dark mode

    - media: "(prefers-color-scheme: dark)"
      scheme: slate
      primary: deep purple
      accent: deep purple
      toggle:
        icon: material/lightbulb-outline
        name: Switch to light mode

  features:
    - content.tabs.link
    - search.highlight
    - search.suggest
    - search.share
    - content.action.edit
    - navigation.tabs
    - navigation.indexes
    - navigation.top
    - toc.follow

markdown_extensions:
  - abbr
  - admonition
  - attr_list
  - def_list
  - footnotes
  - meta
  - md_in_html
  - toc:
      permalink: "#"

  # Python Markdown Extensions
  - pymdownx.snippets
  - pymdownx.caret
  - pymdownx.details
  - pymdownx.keys
  - pymdownx.mark
  - pymdownx.superfences
  - pymdownx.tilde
  - pymdownx.emoji:
      emoji_index: !!python/name:material.extensions.emoji.twemoji
      emoji_generator: !!python/name:material.extensions.emoji.to_svg
  - pymdownx.betterem:
      smart_enable: all
  - pymdownx.tabbed:
      alternate_style: true
      combine_header_slug: true
      slugify: !!python/object/apply:pymdownx.slugs.slugify
        kwds:
          case: lower
  - pymdownx.tasklist:
      custom_checkbox: true

plugins:
  - autorefs
  - search
  - minify:
      minify_html: true
      htmlmin_opts:
          remove_comments: true
      cache_safe: true
#  - glightbox:
#      touchNavigation: true
#      loop: false
#      effect: zoom
#      slide_effect: slide
#      width: 100%
#      height: auto
#      zoomable: true
#      draggable: true
#      auto_caption: false
#      caption_position: bottom
#      skip_classes:
#         - no-lightbox
  - towncrier:
      hide_if_empty: !ENV [HIDE_EMPTY_TOWNCRIER_DRAFT, true]
  - gen-files:
      scripts:
      - scripts/docs/gen_ref_pages.py
  - literate-nav:
      nav_file: summary.md
  - mkdocstrings:
      enabled: !ENV [ENABLE_MKDOCSTRINGS, true]
      default_handler: python
      enable_inventory: true
      handlers:
        python:
          import:
            - https://docs.python.org/3/objects.inv
            - https://docs.aiohttp.org/en/stable/objects.inv
            - https://www.attrs.org/en/stable/objects.inv
            - https://multidict.readthedocs.io/en/stable/objects.inv
            - https://yarl.readthedocs.io/en/stable/objects.inv
          options:
            filters: ["!^_"]
            heading_level: 3
            annotations_path: brief
            docstring_section_style: spacy
            docstring_style: numpy
            inherited_members: false
            merge_init_into_class: true
            separate_signature: true
            show_signature_annotations: true
            show_source: false
            show_submodules: false
            signature_crossrefs: true
            show_symbol_type_heading: true
            show_symbol_type_toc: true
#            show_root_toc_entry: false
            find_stubs_package: true
            extensions:
                - griffe_inherited_docstrings