docs-home/mkdocs.yml at main · percona/docs-home · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
site_name: Percona Documentation
site_url: https://docs.percona.com/

# Theme setup
theme:
  name: material
  features:
    - navigation.indexes
  custom_dir: overrides
  logo: assets/percona-mark.svg
  favicon: assets/percona-favicon.svg
  palette:
    - media: "(prefers-color-scheme)"
      toggle:
        icon: material/brightness-auto
        name: Color theme set to Automatic. Click to change
    - media: "(prefers-color-scheme: light)"
      scheme: percona-light
      primary: custom
      accent: custom
      toggle:
        icon: material/brightness-7
        name: Color theme set to Light Mode. Click to change
    - media: "(prefers-color-scheme: dark)"
      scheme: percona-dark
      primary: custom
      accent: custom
      toggle:
        icon: material/brightness-4
        name: Color theme set to Dark Mode. Click to change

  features:
    - navigation.indexes
#    - navigation.instant
    - navigation.tracking
    - navigation.tabs
    - navigation.tabs.sticky
    - navigation.top
    - content.code.copy
    - content.code.annotate
    - toc.follow

extra_css:
  - css/design.css
  - css/landing.css
  - css/osano.css
  - css/extra.css
  - css/rating.css
  - css/algolia.css
  - css/kapa.css
  - https://cdn.jsdelivr.net/npm/@docsearch/css@3

extra_javascript:
  - js/hide-back-to-index.js
  - https://cdn.jsdelivr.net/npm/@docsearch/js@latest
  - js/init-algolia.js
  - js/rating.js
  - js/kapa.js

markdown_extensions:
  - admonition
  - pymdownx.details
  - md_in_html
  - attr_list
  - 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.snippets:
      base_path: ["snippets"]
  - pymdownx.superfences
  - pymdownx.tabbed:
      alternate_style: true

# Plugins configuration
plugins:
  blog:
    blog_dir: new
    categories_name: Updates per category
    pagination_per_page: 10
#    archive_date_format: yyyy MMMM
#    archive_url_date_format: yyyy/MM
  rss:
    match_path: new/posts/.*
    date_from_meta:
      as_creation: date
    feed_title: "Percona Documentation What's New Feed"
    image: https://docs.percona.com/assets/Percona-Logo.png
    length: 40

  tags:
    tags_file: new/tags.md
#  search:
#    separator: '[\s\-,:!=\[\]()"`/]+|\.(?!\d)|&[lg]t;|(?!\b)(?=[A-Z][a-z])'
  meta-descriptions:
    export_csv: false
    quiet: false
    enable_checks: false
    min_length: 50
    max_length: 160
  git-committers:
    enabled: !ENV [CI, false]
    repository: percona/docs-home
    branch: "main"

extra:
  analytics:
    provider: google
    property: G-J4J70BNH0G
  docsearch:
    api_key: "a5222c0ed6e9e6c67a77cfd2e26000e1"
    index_name: "Percona documentation"
    app_id: "QDKRBCAI99"

copyright: >-
  <a href="https://www.percona.com/about">Percona LLC</a> and its affiliates &copy; 2026 — <a href="#" onclick="Osano.cm.showDrawer('osano-cm-dom-info-dialog-open')">Cookie Preferences</a>

nav:
  - Home: index.md
  - What's new:
    - new/index.md
    - Get help from Percona: new/get-help.md
    - Updates per product: new/tags.md
  - PostgreSQL: percona-for-postgresql.md
  - MongoDB: percona-for-mongodb.md
  - MySQL: percona-for-mysql.md
  - Percona Operators: percona-operators.md
  - PMM: pmm.md
  - Valkey: "https://docs.percona.com/valkey/index.html"
  - Utilities: percona-utilities.md
 # - Percona Lab: percona-lab.md
  - Percona Lab projects: percona-projects.md
  - Legacy docs: "https://docs.percona.com/legacy-documentation/"