mkdocs.yml

---
site_name: "MkDocs Ansible Collection"
site_url: "https://mkdocs-ansible-collection.readthedocs.io/en/latest/"
repo_url: "https://github.com/cmsirbu/mkdocs-ansible-collection"

theme:
  name: "material"
  navigation_depth: 4
  features:
    - "content.action.edit"
    - "content.action.view"
    - "content.code.copy"
    - "navigation.footer"
    - "navigation.indexes"
    - "navigation.tabs"
    - "navigation.tabs.sticky"
    - "navigation.tracking"
    - "search.highlight"
    - "search.share"
    - "search.suggest"
  palette:
    # Palette toggle for light mode
    - media: "(prefers-color-scheme: light)"
      scheme: "default"
      primary: "orange"
      accent: "deep orange"
      toggle:
        icon: "material/weather-sunny"
        name: "Switch to dark mode"

    # Palette toggle for dark mode
    - media: "(prefers-color-scheme: dark)"
      scheme: "slate"
      primary: "orange"
      accent: "deep orange"
      toggle:
        icon: "material/weather-night"
        name: "Switch to light mode"

extra_css:
  - "extra.css"

plugins:
  - "search"
  - "ansible-collection":
      collections:
        - fqcn: "ansible.builtin"
        - fqcn: "ansible.posix"
        - fqcn: "networktocode.nautobot"
        - fqcn: "ansible.netcommon"
        - fqcn: "ansible.utils"
        - fqcn: "arista.eos"
          plugin_types: # NYI
            - "inventory"
            - "module"


markdown_extensions:
  - "admonition"
  - "toc":
      permalink: true
  - "attr_list"
  - "md_in_html"
  - "pymdownx.highlight":
      anchor_linenums: true
  - "pymdownx.inlinehilite"
  - "pymdownx.snippets"
  - "pymdownx.superfences":
      custom_fences:
        - name: "mermaid"
          class: "mermaid"
          format: !!python/name:pymdownx.superfences.fence_code_format
  - "footnotes"

watch:
  - "README.md"

nav:
  - "index.md"
  - "User Guide": "user_guide.md"
  - "Ansible Builtins": "ansible.builtin"
  - "Collection Showcase":
    - "showcase/index.md"
    - "ansible.posix"
    - "ansible.netcommon"
    - "ansible.utils"
    - "Arista EOS": "arista.eos"
  - "networktocode.nautobot"