mkdocs.yml

site_name: 'Pi-hole documentation'
site_url: 'https://docs.pi-hole.net/'
repo_url: 'https://github.com/pi-hole/pi-hole'
edit_uri: '../docs/blob/master/docs/'
copyright: 'Copyright © 2021 Pi-hole LLC'
remote_branch: gh-pages
theme:
  name: 'material'
  custom_dir: overrides
#  icon:
#    repo: fontawesome/brands/github-alt
  favicon: 'images/favicon.ico'
  logo: 'images/logo.svg'
  language: 'en'
  font:
    text: 'Source Sans Pro'
    code: 'Roboto Mono'
  features:
    - navigation.top
    - navigation.instant
    - search.suggest
    - search.highlight
    - search.share
  palette:

    # Light mode
    - media: "(prefers-color-scheme: light)"
      scheme: default
      primary: indigo
      accent: indigo
      toggle:
        icon: material/lightbulb-outline
        name: Switch to dark mode

    # Dark mode
    - media: "(prefers-color-scheme: dark)"
      scheme: slate
      primary: indigo
      accent: indigo
      toggle:
        icon: material/lightbulb
        name: Switch to light mode

markdown_extensions:
  # Code highlighting in ``` ``` blocks
  - codehilite:
      guess_lang: true
  # Table of Contents
  - toc:
      permalink: true
  # block-styled side content
  - admonition
  # linkifies URL and email links without having to wrap them in Markdown syntax. Also, allows shortens repository issue, pull request, and commit links.
  - pymdownx.magiclink
  # Task lists (https://facelessuser.github.io/pymdown-extensions/extensions/tasklist/)
  - pymdownx.tasklist:
      custom_checkbox: true
  # Highlight words with ==mark me==
  - pymdownx.mark
  # Adds support for deletion ~~Delete me~~ and subscript text~a\ subscript~
  - pymdownx.tilde
  # This extension is a convenience extension which includes many pymdownx extensions
  # (https://facelessuser.github.io/pymdown-extensions/extensions/extra/)
  - pymdownx.extra
  # (https://facelessuser.github.io/pymdown-extensions/extensions/details/)
  - pymdownx.details
  # Tabbed provides a syntax to easily add tabbed Markdown content.
  # https://facelessuser.github.io/pymdown-extensions/extensions/tabbed/
  - pymdownx.tabbed
  # Adds syntax for defining footnotes in Markdown documents (https://python-markdown.github.io/extensions/footnotes/)
  - footnotes
  # Adds the ability to define abbreviations
  - abbr
  # Include files in other documents like {!some/dir/in/docs/filename.md!}
  - markdown_include.include:
      base_path: docs
  # Metadata support in pages
  # (https://squidfunk.github.io/mkdocs-material/extensions/metadata/)
  - meta

nav:
  - Overview: index.md
  - 'About Pi-hole':
    - 'Contact Us': main/contact.md
    - 'Pi-hole Origins': main/origins.md
    - 'On the Web': main/coverage.md
  - 'Getting Started':
    - 'Prerequisites': main/prerequisites.md
    - 'Installation': main/basic-install.md
    - 'Post-Install': main/post-install.md
    - 'Updating': main/update.md
    - 'Uninstalling': main/uninstall.md
  - 'Pi-hole Core':
    - 'The &nbsp<samp>pihole</samp>&nbsp command': core/pihole-command.md
  - 'Databases':
    - 'Overview': database/index.md
    - 'Query database': database/ftl.md
    - 'Domain database':
      - 'Overview': database/gravity/index.md
      - 'Group management': database/gravity/groups.md
      - 'Examples': database/gravity/example.md
      - 'Database recovery': database/gravity/recovery.md
  - 'FTLDNS':
    - 'Overview': ftldns/index.md
    - 'Configuration': ftldns/configfile.md
    - 'Interfaces': ftldns/interfaces.md
    - 'DNS resolver': ftldns/dns-resolver.md
    - 'DNS cache': ftldns/dns-cache.md
    - 'Blocking mode': ftldns/blockingmode.md
    - 'Privacy levels': ftldns/privacylevels.md
    - 'Compatibility': ftldns/compatibility.md
    - 'dnsmasq warnings': ftldns/dnsmasq_warn.md
    - 'Advanced':
        - 'Install from source': ftldns/compile.md
        - 'Telnet API': ftldns/telnet-api.md
        - 'Signals': 'ftldns/signals.md'
        - 'Cache dump': ftldns/cache_dump.md
        - 'Packet dump': ftldns/package_dump.md
        - 'Debugging':
            - 'gdb': ftldns/debugging.md
            - 'valgrind': ftldns/valgrind.md
        - 'In-depth manual': ftldns/in-depth.md
  - 'RegEx blocking':
    - "Overview": regex/overview.md
    - "Testing": regex/testmode.md
    - "Tutorial": regex/tutorial.md
    - "Pi-hole extensions": regex/pi-hole.md
    - "Approximate matching": regex/approximate.md
  - 'Docker':
    - 'DHCP': docker/DHCP.md
  - 'Contributing':
    - 'Contributing on GitHub': guides/github/contributing.md
    - 'Developer Certificate of Origin (DCO)': guides/github/dco.md
    - 'How to sign-off commits': guides/github/how-to-signoff.md
    - 'How to fork and rebase': guides/github/how-to-fork-rebase.md
  - 'Guides':
    - 'DNS':
      - 'unbound': guides/dns/unbound.md
      - 'cloudflared (DoH)': guides/dns/cloudflared.md
      - 'Upstream DNS Providers': guides/dns/upstream-dns-providers.md
    - 'VPN':
      - 'WireGuard':
        - 'Overview': guides/vpn/wireguard/overview.md
        - 'Concept': guides/vpn/wireguard/concept.md
        - 'Install server': guides/vpn/wireguard/server.md
        - 'Add client(s)': guides/vpn/wireguard/client.md
        - 'Optional extra features':
          - 'Make local devices accessible': guides/vpn/wireguard/internal.md
          - 'Tunnel all Internet traffic': guides/vpn/wireguard/route-everything.md
        - 'Troubleshooting': guides/vpn/wireguard/faq.md
      - 'OpenVPN':
        - 'Overview': guides/vpn/openvpn/overview.md
        - 'Installation': guides/vpn/openvpn/installation.md
        - 'Setup OpenVPN Server': guides/vpn/openvpn/setup-openvpn-server.md
        - 'Firewall Configuration': guides/vpn/openvpn/firewall.md
        - 'Connecting clients':
          - 'General': guides/vpn/openvpn/clients.md
          - 'Android': guides/vpn/openvpn/android-client.md
        - 'Optional: Only route DNS via VPN': guides/vpn/openvpn/only-dns-via-vpn.md
        - 'Optional: Dual operation: LAN & VPN at the same time': guides/vpn/openvpn/dual-operation.md
        - 'Optional: Full and DNS-only': guides/vpn/openvpn/dual-VPN.md
        - 'Optional: Dynamic DNS': guides/vpn/openvpn/dynDNS.md
        - 'Troubleshooting': guides/vpn/openvpn/troubleshooting.md
    - 'Misc':
      - 'Benchmarking': guides/misc/benchmark.md
      - 'Tor & Pi-hole':
        - 'Overview': guides/misc/tor/overview.md
        - 'Basic Setup': guides/misc/tor/setup.md
        - 'Using Tor': guides/misc/tor/using-tor.md
        - 'Performance and other issues': guides/misc/tor/performance-issues.md
        - 'Using DNSSEC': guides/misc/tor/dnssec.md
      - 'Whitelist and Blacklist editing': guides/misc/whitelist-blacklist.md
    - 'Web server':
      - 'NGINX': guides/webserver/nginx.md
      - 'Caddy': guides/webserver/caddy.md
      - 'Traefik (not in Docker)': guides/webserver/traefik-nodocker.md
  - 'Router setup':
    - 'Fritz!Box (EN)': routers/fritzbox.md
    - 'Fritz!Box (DE)': routers/fritzbox-de.md
    - 'ASUS router': routers/asus.md
  - 'FAQ': main/faq.md
  - 'Community Projects': main/projects.md

extra:
  social:
    - icon: fontawesome/solid/earth-americas
      link: https://pi-hole.net/
      name: Website
    - icon: fontawesome/brands/github
      link: https://github.com/pi-hole
      name: GitHub

extra_css:
  - extra.css

plugins:
  - search
  - git-revision-date-localized
  - redirects:
      redirect_maps:
        'ftldns/database.md': database/index.md
        'main/presentations.md': index.md
        'main/prerequesites.md': main/prerequisites.md
        'guides/unbound.md': guides/dns/unbound.md
        'guides/upstream-dns-providers.md': guides/dns/upstream-dns-providers.md
        'guides/dns-over-https.md': guides/dns/cloudflared.md
        'guides/vpn/overview.md': guides/vpn/openvpn/overview.md
        'guides/vpn/installation.md': guides/vpn/openvpn/installation.md
        'guides/vpn/setup-openvpn-server.md': guides/vpn/openvpn/setup-openvpn-server.md
        'guides/vpn/firewall.md': guides/vpn/openvpn/firewall.md
        'guides/vpn/clients.md': guides/vpn/openvpn/clients.md
        'guides/vpn/android-client.md': guides/vpn/openvpn/android-client.md
        'guides/vpn/only-dns-via-vpn.md': guides/vpn/openvpn/only-dns-via-vpn.md
        'guides/vpn/dual-operation.md': guides/vpn/openvpn/dual-operation.md
        'guides/vpn/dual-VPN.md': guides/vpn/openvpn/dual-VPN.md
        'guides/vpn/dynDNS.md': guides/vpn/openvpn/dynDNS.md
        'guides/vpn/troubleshooting.md': guides/vpn/openvpn/troubleshooting.md
        'guides/benchmark.md': guides/misc/benchmark.md
        'guides/tor/overview.md': guides/misc/tor/overview.md
        'guides/tor/setup.md': guides/misc/tor/setup.md
        'guides/tor/using-tor.md': guides/misc/tor/using-tor.md
        'guides/tor/performance-issues.md': guides/misc/tor/performance-issues.md
        'guides/tor/dnssec.md': guides/misc/tor/dnssec.md
        'guides/whitelist-blacklist.md': guides/misc/whitelist-blacklist.md
        'guides/nginx-configuration.md': 'guides/webserver/nginx.md'
        'guides/caddy-configuration.md': 'guides/webserver/caddy.md'
        'guides/traefik-configuration-nodocker.md': 'guides/webserver/traefik-nodocker.md'
        'ftldns/regex/index.md': regex/overview.md
        'ftldns/regex/overview.md': regex/overview.md
        'ftldns/regex/tutorial.md': regex/tutorial.md