mkdocs.yaml

# Project information
site_name: Ansible Workshop
site_author: Natron Tech AG
site_description: >-
  Documentation and guides for the Ansible Workshop by Natron Tech AG.

# Repository
repo_url: https://github.com/natrontech/workshop-ansible
repo_name: natrontech/workshop-ansible
edit_uri: ""

# Copyright
copyright: Copyright © 2024 Natron Tech AG

# Page tree
nav:
  - Home: index.md
  - Ansible explained: 
    - explained/index.md
    - Concepts: explained/concepts.md
    - Files: explained/files.md
    - Running Playbooks: explained/running-playbooks.md
    - Indempotency: explained/indempotency.md
    - Docs: explained/docs.md
  - Setup:
    - setup/index.md
    - Development:
      - setup/dev/index.md
      - Control Node Setup: setup/dev/control-node.md
    - Production:
      - setup/prod/index.md
      - Control Node Setup: setup/prod/control-node.md
      - Directory Structure: setup/prod/directory-structure.md
    - Connecting to hosts:
      - setup/connecting/index.md
      - Linux: setup/connecting/linux.md
      - Windows: setup/connecting/windows.md
      - Network devices: setup/connecting/network-devices.md
  - Basics:
    - basics/index.md
    - Inventory:
      - Creating: basics/inventory/create-inventory.md
      - Variables: basics/inventory/variables.md
      - Validating: basics/inventory/validate-inventory.md
    - Tasks:
      - Running your first tasks: basics/tasks/first-task.md
      - Gather facts: basics/tasks/gather-facts.md
      - Return: basics/tasks/return.md
      - Handlers: basics/tasks/handlers.md
      - Recap: basics/tasks/recap.md
      - Tags: basics/tasks/tags.md
      - Delegate: basics/tasks/delegate.md
      - Check diff: basics/tasks/check-diff.md
    - Control flow:
      - Conditionals: basics/control-flow/contitionals.md
      - Loop: basics/control-flow/loop.md
      - Block: basics/control-flow/block.md
      - Import and include: basics/control-flow/import.md
      - Execution strategy: basics/control-flow/execution-strategy.md
    - Secrets:
      - Vault: basics/secrets/vault.md
    - Modules:
      - debug: basics/modules/debug.md
      - template: basics/modules/template.md
    - Jinja2:
      - Variables: basics/jinja/variables.md
      - Filter: basics/jinja/filter.md
  - Advanced:
    - advanced/index.md
    - Linting:
      - Ansible Lint: advanced/linting/ansible-lint.md
      - Pre-commit hook: advanced/linting/precommit.md
    - CI/CD:
      - Gitlab: advanced/ci-cd/gitlab-ci.md
      - Ansible Runner: advanced/ci-cd/ansible-runner.md
    - Various:
      - Quoting: advanced/various/quoting.md
      - Global vars: advanced/various/global-vars.md
      - Loop and when: advanced/various/combine-when-loop.md
      - Loop until: advanced/various/loop-until.md
      - Indempotency in command module: advanced/various/rc-in-command.md
  - Examples:
    - examples/index.md
    - Cisco:
      - ACL: examples/cisco/acl.md
      - Interface: examples/cisco/interface.md
    - Linux:
      - DNS server: examples/linux/dns-server.md
      - Users: examples/linux/users.md
      - Update system: examples/linux/update-system.md
    - Windows:
      - Domain Setup: examples/windows/domain-setup.md
      - DNS record: examples/windows/dns-record.md

# Configuration
theme:
  favicon: assets/images/favicon.png
  logo: assets/images/favicon.png
  name: material
  language: en
  font:
    text: Roboto
    code: Roboto Mono
  icon:
    repo: fontawesome/brands/github
  features:
    - content.code.annotate
    - navigation.indexes
    - navigation.sections
    - navigation.tabs
    - navigation.top
    - navigation.tracking
    - search.highlight
    - search.share
    - search.suggest
    - navigation.prune
  palette:
    - media: "(prefers-color-scheme: light)"
      scheme: default
      primary: white
      accent: indigo
      toggle:
        icon: material/toggle-switch-off-outline
        name: Switch to dark mode
    - media: "(prefers-color-scheme: dark)"
      scheme: slate
      primary: black
      accent: indigo
      toggle:
        icon: material/toggle-switch
        name: Switch to light mode

# Plugins
plugins:
  - search:
      lang: en

# Customization
extra:
  social:
    - icon: fontawesome/brands/github
      link: https://github.com/natrontech
    - icon: fontawesome/brands/linkedin
      link: https://www.linkedin.com/company/natron-gmbh



# Markdown extensions
markdown_extensions:
  - pymdownx.emoji:
      emoji_index: !!python/name:materialx.emoji.twemoji
      emoji_generator: !!python/name:materialx.emoji.to_svg
  - attr_list
  - md_in_html
  - attr_list
  - pymdownx.superfences
  - pymdownx.tabbed:
      alternate_style: true
  - admonition
  - pymdownx.details
  - pymdownx.superfences
  - def_list
  - pymdownx.tasklist:
      custom_checkbox: true
  - footnotes