Restoring the new navigation

Author: nastena1606

mkdocs-base.yml

@@ -3,7 +3,7 @@
 site_name: Percona Distribution for PostgreSQL
 site_description: Documentation
 site_author: Percona LLC
-copyright:  <a href="https://www.percona.com/about">Percona LLC</a> and/or its affiliates © 2025 — <a href="#__consent">Cookie Consent</a>
+copyright:  <a href="https://www.percona.com/about">Percona LLC</a> and/or its affiliates © 2024 — <a href="#__consent">Cookie Consent</a>
 
 repo_name: percona/postgresql-docs
 repo_url: https://github.com/percona/postgresql-docs
@@ -99,8 +99,8 @@ markdown_extensions:
   pymdownx.inlinehilite: {}
   pymdownx.snippets:
       base_path: ["snippets"]
-      #      auto_append:
-      #        - services-banner.md
+      auto_append:
+        - services-banner.md
   pymdownx.emoji:
       emoji_index: !!python/name:material.extensions.emoji.twemoji
       emoji_generator: !!python/name:material.extensions.emoji.to_svg
@@ -125,84 +125,58 @@ plugins:
   macros:
       include_yaml:
         - 'variables.yml' # Use in markdown as '{{ VAR }}'
+# exclude: # Don't process these files
+#      glob:
+#         - file.md
+  with-pdf: # https://github.com/orzih/mkdocs-with-pdf
+          output_path: '_pdf/PerconaDistributionPostgreSQL-17.pdf'
+          cover_title: 'Distribution for PostgreSQL Documentation'
+
+          cover_subtitle: 17.0 (October 3, 2024)
+          author: 'Percona Technical Documentation Team'
+          cover_logo: docs/_images/Percona_Logo_Color.png
+          debug_html: false
+          custom_template_path: _resource/templates
+          enabled_if_env: ENABLE_PDF_EXPORT
   mike:
       version_selector: true
       css_dir: css
       javascript_dir: js
       canonical_version: null
-  print-site:
-    add_to_navigation: false
-    print_page_title: 'Percona Distribution for PostgreSQL documentation'
-    add_print_site_banner: false
-    # Table of contents
-    add_table_of_contents: true
-    toc_title: 'Table of Contents'
-    toc_depth: 2
-    # Content-related
-    add_full_urls: false
-    enumerate_headings: false
-    enumerate_headings_depth: 1
-    enumerate_figures: true
-    add_cover_page: true
-    cover_page_template: "docs/templates/pdf_cover_page.tpl"
-    path_to_pdf: ""
-    include_css: true
-    enabled: true
 
 extra:
   version:
     provider: mike
   #homepage:
   #  https://docs.percona.com
-  postgresrecommended: 17
-# Google Analytics configuration
-  analytics:
-    provider: google
-    property: G-J4J70BNH0G
-    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: >- 
-            Thank you for your feedback! Help us improve by using our 
-            <a href="https://docs.google.com/forms/d/1bkWACehjqlwA0AKf-qTJcXvYbOSYgze8iTPXjntqmNo/edit" target="_blank" rel="noopener">
-            feedback form</a>.
+  postgresrecommended: 16
 
 nav:
-  - index.md
+  - 'Home': 'index.md'
   - get-help.md
+  - 'Percona Server for PostgreSQL': postgresql-server.md
   - Get started: 
-      - installing.md
+      - Quickstart guide: installing.md
       - 1. Install: 
-          - apt.md
-          - yum.md
-          - tarball.md
-          -  docker.md
+          - Via apt: apt.md
+          - Via yum: yum.md
+          - From tarballs: tarball.md
+          - Run in Docker: docker.md
           - enable-extensions.md
           - repo-overview.md
-      - 2. Connect to PostgreSQL: 
-          - connect.md
-      - 3. Manipulate data in PostgreSQL: 
-          - crud.md  
-      - 4. What's next: 
-          - whats-next.md 
+      - 2. Connect to PostgreSQL: connect.md
+      - 3. Manipulate data in PostgreSQL: crud.md  
+      - 4. What's next: whats-next.md 
   - Extensions:
-      - extensions.md
+      - 'Extensions': extensions.md
       - contrib.md
-      - percona-ext.md
+      - Percona-authored extensions: percona-ext.md
       - third-party.md
   - Solutions:
-      - solutions.md
+      - Overview: solutions.md
       - High availability:
           - 'Overview': 'solutions/high-availability.md'
-          - 'Measuring high availability': solutions/ha-measure.md
+          - solutions/ha-measure.md
           - 'Architecture': solutions/ha-architecture.md
           - Components:
             - 'ETCD': 'solutions/etcd-info.md'
@@ -218,28 +192,30 @@ nav:
               - 'HAProxy setup': 'solutions/ha-haproxy.md'
           - solutions/ha-test.md
       - Backup and disaster recovery:
-          - solutions/backup-recovery.md
+          - 'Overview': 'solutions/backup-recovery.md'
           - solutions/dr-pgbackrest-setup.md
       - Spatial data handling:
-        - solutions/postgis.md
-        - solutions/postgis-deploy.md
-        - solutions/postgis-testing.md
-        - solutions/postgis-upgrade.md
-      - ldap.md
+        - Overview: solutions/postgis.md
+        - Deployment: solutions/postgis-deploy.md
+        - Query spatial data: solutions/postgis-testing.md
+        - Upgrade spatial database: solutions/postgis-upgrade.md
+      - LDAP authentication:
+          - ldap.md
   - Upgrade:
-      - major-upgrade.md
+      - "Major upgrade": major-upgrade.md
       - minor-upgrade.md
       - migration.md
-  - troubleshooting.md
-  - uninstalling.md
-  - release-notes.md
-  - release-notes-v17.5.md
-  - release-notes-v17.4.md
-  - release-notes-v17.2.md
-  - release-notes-v17.0.md
-  - telemetry.md
-  - licensing.md
-  - trademark-policy.md
-
-
+  - Troubleshooting guide: troubleshooting.md
+  - How to: how-to.md
+  - Uninstall: uninstalling.md
+  - Release Notes:
+      - "Release notes index": "release-notes.md"
+      - release-notes-v17.0.md
+      - release-notes-v17.2.md
+      - release-notes-v17.4.md
+      - release-notes-v17.5.md
+  - Reference:
+      - Telemetry: telemetry.md
+      - Licensing: licensing.md
+      - Trademark policy: trademark-policy.md
 

mkdocs.yml

@@ -52,10 +52,21 @@ nav:
   - Solutions:
       - Overview: solutions.md
       - High availability:
-          - 'High availability': 'solutions/high-availability.md'
-          - 'Deploying on Debian or Ubuntu': 'solutions/ha-setup-apt.md'
-          - 'Deploying on RHEL or derivatives': 'solutions/ha-setup-yum.md'
-          - solutions/pgbackrest.md
+          - 'Overview': 'solutions/high-availability.md'
+          - solutions/ha-measure.md
+          - 'Architecture': solutions/ha-architecture.md
+          - Components:
+            - 'ETCD': 'solutions/etcd-info.md'
+            - 'Patroni': 'solutions/patroni-info.md'
+            - 'HAProxy': 'solutions/haproxy-info.md'
+            - 'pgBackRest': 'solutions/pgbackrest-info.md'
+          - solutions/ha-components.md
+          - Deployment:
+              - 'Initial setup': 'solutions/ha-init-setup.md'
+              - 'etcd setup': 'solutions/ha-etcd-config.md'
+              - 'Patroni setup': 'solutions/ha-patroni.md'
+              - solutions/pgbackrest.md
+              - 'HAProxy setup': 'solutions/ha-haproxy.md'
           - solutions/ha-test.md
       - Backup and disaster recovery:
           - 'Overview': 'solutions/backup-recovery.md'