mkdocs.yml

# dependencies:
# pip install mkdocs mkdocs-material pymdown-extensions
site_name: "Kapitan: Keep your ship together"
site_url: "https://kapitan.dev"
strict: true
plugins:
  - blog:
      archive: false
      blog_dir: pages/blog
      post_url_date_format: dd/MM/yyyy
  - tags:
      tags_file: tags.md
  - search
theme:
  name: material
  custom_dir: overrides
  logo: images/logo.min.svg
  favicon: images/logo.min.svg
  features:
    - announce.dismiss
    - content.code.annotate
    - content.tabs.link
    - navigation.instant
    - navigation.indexes
    - navigation.tabs
    - navigation.tabs.sticky
    - navigation.top
    - navigation.tracking
    - search.highlight
    - search.share
    - search.suggest
    - toc.follow
    - toc.integrate
  palette:
    # Palette toggle for light mode
    - scheme: default
      media: "(prefers-color-scheme: light)"
      primary: blue
      toggle:
        icon: material/brightness-7
        name: Switch to dark mode

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

extra:
  consent:
    title: Cookie consent
    description: >-
      We use cookies to recognize your repeated visits and preferences, as well
      as to measure the effectiveness of our documentation and whether users
      find what they're searching for. With your consent, you're helping us to
      make our documentation better.
  social:
    - icon: fontawesome/brands/twitter
      link: https://twitter.com/kapitandev
      name: kapitan on Twitter
    - icon: fontawesome/brands/slack
      link: https://kubernetes.slack.com/archives/C981W2HD3
      name: "#kapitan slack channel"
  analytics:
    provider: custom
use_directory_urls: true
nav:
  - Home: README.md
  - Trusted by: ADOPTERS.md
  - Getting started: getting_started.md
  - Documentation:
      - Core Concepts: pages/kapitan_overview.md
      - Inventory:
        - Introduction: pages/inventory/introduction.md
        - Targets: pages/inventory/targets.md
        - Classes: pages/inventory/classes.md
        - Parameters Interpolation: pages/inventory/parameters_interpolation.md
        - Advanced: pages/inventory/advanced.md
        - reclass-rs Backend: pages/inventory/reclass-rs.md
      - Input Types:
          - Introduction: pages/input_types/introduction.md
          - Kadet: pages/input_types/kadet.md
          - Jinja: pages/input_types/jinja.md
          - Helm: pages/input_types/helm.md
          - Jsonnet: pages/input_types/jsonnet.md
          - External: pages/input_types/external.md
          - Copy: pages/input_types/copy.md
          - Remove: pages/input_types/remove.md
      - References: references.md
      - Advanced Kapitan:
        - Remote repositories: pages/remote_repositories.md
        - External dependencies: pages/external_dependencies.md
      - CLI reference:
          - compile: pages/commands/kapitan_compile.md
          - inventory: pages/commands/kapitan_inventory.md
          - lint: pages/commands/kapitan_lint.md
          - searchvar: pages/commands/kapitan_searchvar.md
          - validate: pages/commands/kapitan_validate.md
          - kapitan dotfile: pages/commands/kapitan_dotfile.md
  - Blog:
    - pages/blog/index.md
  - Support:
      - Ask for support: support.md
      - Related Projects: related.md
  - Contribute:
      - Sponsor Us: pages/contribute/sponsor.md
      - Talk about Kapitan: pages/contribute/talk.md
      - Active contributions:
        - Documentation: pages/contribute/documentation.md
        - Kapitan Code: pages/contribute/code.md
        - Proposals: proposals.md
  - Generators: https://generators.kapitan.dev
  - Tesoro: https://github.com/kapicorp/tesoro
  - Kapitan Reference: https://github.com/kapicorp/kapitan-reference
  - FAQ: FAQ.md

markdown_extensions:
  - md_in_html
  - admonition
  - pymdownx.tabbed:
      alternate_style: true
  - pymdownx.superfences:
      custom_fences:
        - name: mermaid
          class: mermaid
          format: !!python/name:pymdownx.superfences.fence_code_format
  - pymdownx.arithmatex
  - pymdownx.betterem:
      smart_enable: all
  - pymdownx.caret
  - pymdownx.critic
  - pymdownx.details
  - pymdownx.snippets:
      base_path: examples
  - pymdownx.emoji:
      emoji_index: !!python/name:material.extensions.emoji.twemoji
      emoji_generator: !!python/name:material.extensions.emoji.to_svg
      options:
        custom_icons:
          - overrides/.icons
  - pymdownx.inlinehilite
  - pymdownx.magiclink
  - pymdownx.mark
  - pymdownx.smartsymbols
  - pymdownx.superfences
  - pymdownx.tasklist:
      custom_checkbox: true
  - pymdownx.tilde
  - markdown_include.include:
      base_path: docs
  - attr_list
  - abbr

repo_name: "kapicorp/kapitan"
repo_url: "https://github.com/kapicorp/kapitan"

copyright: >
  <a href="#__consent">Change cookie settings</a>