privacyguides.org/config/mkdocs-common.yml

# Copyright (c) 2022-2024 Jonah Aragon <jonah@triplebit.net>

# Permission is hereby granted, free of charge, to any person obtaining a copy
# of this software and associated documentation files (the "Software"), to
# deal in the Software without restriction, including without limitation the
# rights to use, copy, modify, merge, publish, distribute, sublicense, and/or
# sell copies of the Software, and to permit persons to whom the Software is
# furnished to do so, subject to the following conditions:

# The above copyright notice and this permission notice shall be included in
# all copies or substantial portions of the Software.

# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
# FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE
# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
# FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS
# IN THE SOFTWARE.

docs_dir: "../docs"
site_url: "https://www.privacyguides.org/"
site_dir: "../site"

site_name: Privacy Guides
site_description:
  !ENV [
    SITE_DESCRIPTION,
    "Privacy Guides is your central privacy and security resource to protect yourself online.",
  ]
copyright:
  !ENV [FOOTER_COPYRIGHT, "&copy; 2019 Privacy Guides and contributors."]
edit_uri: edit/main/docs/

extra:
  generator: false
  context: !ENV [CONTEXT, "production"]
  deploy: !ENV DEPLOY_ID
  homepage_description:
    !ENV [
      DESCRIPTION_HOMEPAGE,
      "A socially motivated website which provides information about protecting your online data privacy and security.",
    ]
  translation_notice: !ENV DESCRIPTION_TRANSLATION
  translation_notice_cta: !ENV [DESCRIPTION_TRANSLATION_CTA, "Visit Crowdin"]
  translation_notice_language: !ENV LANG_ENGLISH
  social:
    - icon: simple/mastodon
      link: https://mastodon.neat.computer/@privacyguides
      name: !ENV [SOCIAL_MASTODON, "Mastodon"]
    - icon: simple/matrix
      link: https://matrix.to/#/#privacyguides:matrix.org
      name: !ENV [SOCIAL_MATRIX, "Matrix"]
    - icon: simple/discourse
      link: https://discuss.privacyguides.net/
      name: !ENV [SOCIAL_FORUM, "Forum"]
    - icon: simple/github
      link: https://github.com/privacyguides
      name: !ENV [SOCIAL_GITHUB, "GitHub"]
    - icon: simple/torbrowser
      link: http://www.xoe4vn5uwdztif6goazfbmogh6wh5jc4up35bqdflu6bkdc5cas5vjqd.onion/
      name: !ENV [SOCIAL_TOR_SITE, "Hidden service"]
  alternate:
    - name: English
      link: /en/
      lang: en
      icon: https://raw.githubusercontent.com/twitter/twemoji/master/assets/svg/1f1fa-1f1f8.svg
    - name: Español
      link: /es/
      lang: es
      icon: https://raw.githubusercontent.com/twitter/twemoji/master/assets/svg/1f1ea-1f1f8.svg
    - name: Français
      link: /fr/
      lang: fr
      icon: https://raw.githubusercontent.com/twitter/twemoji/master/assets/svg/1f1eb-1f1f7.svg
    - name: עִברִית
      link: /he/
      lang: he
      icon: https://raw.githubusercontent.com/twitter/twemoji/master/assets/svg/1f1ee-1f1f1.svg
    - name: Italiano
      link: /it/
      lang: it
      icon: https://raw.githubusercontent.com/twitter/twemoji/master/assets/svg/1f1ee-1f1f9.svg
    - name: Nederlands
      link: /nl/
      lang: nl
      icon: https://raw.githubusercontent.com/twitter/twemoji/master/assets/svg/1f1f3-1f1f1.svg
    - name: 正體中文
      link: /zh-hant/
      lang: zh-Hant
      icon: https://raw.githubusercontent.com/twitter/twemoji/master/assets/svg/1f1ed-1f1f0.svg
    - name: русский
      link: /ru/
      lang: ru
      icon: https://raw.githubusercontent.com/twitter/twemoji/master/assets/svg/1f1f7-1f1fa.svg
  analytics:
    feedback:
      title: Was this page helpful?
      ratings:
        - icon: material/emoticon-happy-outline
          name: This page was helpful
          data: 1
          note: >-
            Thanks for your feedback!
        - icon: material/emoticon-sad-outline
          name: This page could be improved
          data: 0
          note: >-
            Thanks for your feedback! If you want to let us know more, please leave a post on our
            <a href="https://discuss.privacyguides.net/c/site-development/7" target="_blank" rel="noopener">forum</a>.
  consent:
    title: !ENV [ANALYTICS_CONSENT_TITLE, "Contribute anonymous statistics"]
    description:
      !ENV [
        ANALYTICS_CONSENT_BODY,
        "We use cookies to collect anonymous usage statistics. You can opt out if you wish.",
      ]
    cookies:
      analytics:
        name: Self-Hosted Analytics
        checked: true
      github:
        name: GitHub API
        checked: true
    actions:
      - reject
      - accept
      - manage

repo_url: https://github.com/privacyguides/privacyguides.org
repo_name: ""

theme:
  name: material
  language: en
  custom_dir: ../theme
  logo: ../../theme/assets/brand/logos/svg/logo/privacy-guides-logo-notext-colorbg.svg
  font:
    text: Public Sans
    code: DM Mono
  palette:
    - media: "(prefers-color-scheme)"
      scheme: default
      accent: deep purple
      toggle:
        icon: material/brightness-auto
        name: !ENV [THEME_DARK, "Switch to dark mode"]
    - media: "(prefers-color-scheme: dark)"
      scheme: slate
      accent: amber
      toggle:
        icon: material/brightness-2
        name: !ENV [THEME_LIGHT, "Switch to light mode"]
    - media: "(prefers-color-scheme: light)"
      scheme: default
      accent: deep purple
      toggle:
        icon: material/brightness-5
        name: !ENV [THEME_AUTO, "Switch to system theme"]
  favicon: assets/brand/logos/png/favicon-32x32.png
  icon:
    repo: simple/github
  features:
    - navigation.tracking
    - navigation.tabs
    - navigation.sections
    - navigation.expand
    - navigation.path
    - navigation.indexes
    - content.tabs.link
    - content.tooltips
    - search.highlight

extra_css:
  - assets/stylesheets/extra.css?v=3.17.0
extra_javascript:
  - assets/javascripts/mathjax.js
  - assets/javascripts/randomize-element.js
  - assets/javascripts/resolution.js
  - assets/javascripts/feedback.js

watch:
  - ../theme
  - ../includes
  - mkdocs-common.yml

plugins:
  tags: {}
  search: {}
  macros: {}
  meta: {}
  git-committers:
    enabled: !ENV [GITCOMMITTERS, PRODUCTION, NETLIFY, false]
    repository: privacyguides/privacyguides.org
    branch: main
  git-revision-date-localized:
    enabled: !ENV [GITREVISIONDATE, PRODUCTION, NETLIFY, false]
    exclude:
      - index.md
    fallback_to_build_date: true
  privacy:
    assets_exclude:
      - cdn.jsdelivr.net/npm/mathjax@3/*
  optimize:
    enabled: !ENV [OPTIMIZE, PRODUCTION, NETLIFY, false]
  typeset: {}
  social:
    cards: !ENV [CARDS, PRODUCTION, NETLIFY, true]
    cards_dir: assets/img/social
    cards_layout_dir: config/layouts
    cards_layout: page
    # cards_layout: pride

markdown_extensions:
  admonition: {}
  pymdownx.details: {}
  pymdownx.superfences:
    custom_fences:
      - name: mermaid
        class: mermaid
        format: !!python/name:pymdownx.superfences.fence_code_format
  pymdownx.tabbed:
    alternate_style: true
  pymdownx.arithmatex:
    generic: true
  pymdownx.critic: {}
  pymdownx.caret: {}
  pymdownx.keys: {}
  pymdownx.mark: {}
  pymdownx.tilde: {}
  pymdownx.snippets:
    auto_append:
      - includes/abbreviations.en.txt
  pymdownx.tasklist:
    custom_checkbox: true
  attr_list: {}
  def_list: {}
  md_in_html: {}
  meta: {}
  abbr: {}
  pymdownx.emoji:
    emoji_index: !!python/name:material.extensions.emoji.twemoji
    emoji_generator: !!python/name:material.extensions.emoji.to_svg
  tables: {}
  footnotes: {}
  toc:
    permalink: true
    toc_depth: 4

nav:
  - !ENV [NAV_HOME, "Home"]: "index.md"
  - !ENV [NAV_KNOWLEDGE_BASE, "Knowledge Base"]:
      - "basics/why-privacy-matters.md"
      - "basics/threat-modeling.md"
      - "basics/common-threats.md"
      - "basics/common-misconceptions.md"
      - "basics/account-creation.md"
      - "basics/account-deletion.md"
      - !ENV [NAV_TECHNOLOGY_ESSENTIALS, "Technology Essentials"]:
          - "basics/passwords-overview.md"
          - "basics/multi-factor-authentication.md"
          - "basics/email-security.md"
          - "basics/vpn-overview.md"
      - !ENV [NAV_ADVANCED_TOPICS, "Advanced Topics"]:
          - "advanced/dns-overview.md"
          - "advanced/tor-overview.md"
          - "advanced/payments.md"
          - "advanced/communication-network-types.md"
      - !ENV [NAV_OPERATING_SYSTEMS, "Operating Systems"]:
          - "os/android-overview.md"
          - "os/ios-overview.md"
          - "os/linux-overview.md"
          - "os/macos-overview.md"
          - "os/qubes-overview.md"
      - kb-archive.md
  - !ENV [NAV_RECOMMENDATIONS, "Recommendations"]:
      - "tools.md"
      - !ENV [NAV_INTERNET_BROWSING, "Internet Browsing"]:
          - "tor.md"
          - "desktop-browsers.md"
          - "mobile-browsers.md"
      - !ENV [NAV_PROVIDERS, "Providers"]:
          - "cloud.md"
          - "dns.md"
          - "email-aliasing.md"
          - "email.md"
          - "financial-services.md"
          - "photo-management.md"
          - "search-engines.md"
          - "vpn.md"
      - !ENV [NAV_SOFTWARE, "Software"]:
          - "calendar.md"
          - "cryptocurrency.md"
          - "data-redaction.md"
          - "email-clients.md"
          - "encryption.md"
          - "file-sharing.md"
          - "frontends.md"
          - "multi-factor-authentication.md"
          - "news-aggregators.md"
          - "notebooks.md"
          - "passwords.md"
          - "productivity.md"
          - "real-time-communication.md"
      - !ENV [NAV_OPERATING_SYSTEMS, "Operating Systems"]:
          - "android.md"
          - "desktop.md"
          - "router.md"
      - !ENV [NAV_ADVANCED, "Advanced"]:
          - "device-integrity.md"
  - !ENV [NAV_ABOUT, "About"]:
      - "about/index.md"
      - "about/criteria.md"
      - "about/notices.md"
      - "about/privacy-policy.md"
      - "about/statistics.md"
      - !ENV [NAV_COMMUNITY, "Community"]:
          - "about/donate.md"
          - !ENV [NAV_ONLINE_SERVICES, "Online Services"]: "about/services.md"
          - !ENV [NAV_CODE_OF_CONDUCT, "Code of Conduct"]: "CODE_OF_CONDUCT.md"
          - "about/privacytools.md"
      - !ENV [NAV_CONTRIBUTING, "Contributing"]:
          - !ENV [NAV_WRITING_GUIDE, "Writing Guide"]:
              - "meta/writing-style.md"
              - "meta/admonitions.md"
              - "meta/brand.md"
              - "meta/translations.md"
          - !ENV [NAV_TECHNICAL_GUIDES, "Technical Guides"]:
              - "meta/uploading-images.md"
              - "meta/git-recommendations.md"
  - !ENV [NAV_CHANGELOG, "Changelog"]:
      "https://github.com/privacyguides/privacyguides.org/releases"
  - !ENV [NAV_FORUM, "Forum"]: "https://discuss.privacyguides.net/"
  - !ENV [NAV_BLOG, "Blog"]: "https://blog.privacyguides.org/"