[PR-23855] pack of improvements and fixes (#365)

**1. Redirect cases extension**
New case handler has been added
`/path/page.html?q=1` --> `/path/page/?q=1`
Read nginx's `default.conf` comment for full list of cases

**2. Navbar burger button fix**
The PyData theme, which is used as the basis for the Book theme starting from v0.16, introduced the bug with the navbar burger button.
The Pydata version has been downgraded to 0.15.4
See for more details 
pydata/pydata-sphinx-theme#2067

**3. Add a hidden title to the main page**
No H1 title on the main page caused `<no title>` value in title meta tag and <no title> name in navigation URL at the bottom of the second page
Fixed by adding the title but hiding it with styles 

**4. requirements.txt cleanup**
Leftover packages clean up

Author: en-ver

nginx/conf.d/default.conf

@@ -30,23 +30,6 @@ server {
     absolute_redirect off;
     port_in_redirect on;
 
-    # Rewrite .html → no .html
-    location ~* ^/.+\.html$ {
-        # Avoid redirect loops if this is an internal sub-request (fallback)
-        if ($uri != $request_uri) {
-            break;
-        }
-
-        # If it ends with "index.html", remove "index.html"
-        # e.g. /path/index.html => /path/
-        # e.g. /index.html => /
-        rewrite "^/(.*)index\.html$" /$1 permanent;
-
-        # Otherwise remove ".html" and append slash
-        # e.g. /overview.html => /overview/
-        rewrite "^/(.+)\.html$" /$1/ permanent;
-    }
-
     # Serve static assets with long cache
     location ~* \.(?:css|js|jpe?g|png|gif|ico|svg|woff2?|ttf|eot|otf|webp)$ {
         expires 1y;
@@ -55,23 +38,33 @@ server {
         try_files $uri =404;
     }
 
-    # Redirect requests starting with /search/?q=& to /
-    # Fix of the Furo theme bug described here https://talkable.atlassian.net/browse/PR-23789
-    # location /search/ {
-    #     if ($arg_q = "") {
-    #         return 301 /;
-    #     }
-    # }
-
     # Serve robots.txt from a specific file
     location = /robots.txt {
         alias /var/www/robots.txt;
         access_log off;
         log_not_found off;
     }
 
-    # Default static-file behavior
     location / {
+
+        # Handle requests where the user explicitly requests an "index" page,
+        # with or without the ".html" extension. It removes the "index" part from the URL.
+        # For example:
+        #   /index.html       →  /
+        #   /index            →  /
+        #   /folder/index.html?q=1  →  /folder/?q=1
+        if ($request_uri ~ ^(.*/)?index(?:\.html)?(?:\?(.*))?$) {
+            return 301 $1$is_args$args;
+        }
+
+        # Strip the ".html" extension and append a trailing slash.
+        # For example:
+        #   /about.html       →  /about/
+        #   /folder/page.html?q=1  →  /folder/page/?q=1
+        if ($request_uri ~ ^(.+)\.html(?:\?(.*))?$) {
+            return 301 $1/$is_args$args;
+        }
+
         try_files $uri $uri/ =404;
     }
 }

packages.txt

@@ -5,5 +5,10 @@
 sphinx-copybutton
 sphinx-sitemap
 sphinx-autobuild
-sphinx-book-theme
 sphinx-design
+
+sphinx-book-theme
+pydata-sphinx-theme==0.15.4
+# The Book theme version has been hardcoded due to an navbar issue starting from PyData v0.16.
+# For more details, see https://github.com/pydata/pydata-sphinx-theme/issues/2067.
+# Please ensure the issue has been resolved before updating the version.

requirements.txt

@@ -1,32 +1,29 @@
 accessible-pygments==0.0.5
 alabaster==1.0.0
 anyio==4.8.0
-babel==2.16.0
-beautifulsoup4==4.12.3
-certifi==2024.12.14
+babel==2.17.0
+beautifulsoup4==4.13.3
+certifi==2025.1.31
 charset-normalizer==3.4.1
 click==8.1.8
 colorama==0.4.6
 docutils==0.21.2
-furo==2024.8.6
 h11==0.14.0
 idna==3.10
 imagesize==1.4.1
 Jinja2==3.1.5
 MarkupSafe==3.0.2
 packaging==24.2
-pydata-sphinx-theme==0.16.1
+pydata-sphinx-theme==0.15.4
 Pygments==2.19.1
 requests==2.32.3
 sniffio==1.3.1
 snowballstemmer==2.2.0
 soupsieve==2.6
 Sphinx==8.1.3
 sphinx-autobuild==2024.10.3
-sphinx-basic-ng==1.0.0b2
 sphinx-book-theme==1.1.3
 sphinx-copybutton==0.5.2
-sphinx-favicon==1.0.1
 sphinx-sitemap==2.6.0
 sphinx_design==0.6.1
 sphinxcontrib-applehelp==2.0.0

source/_templates/layout.html

@@ -2,11 +2,7 @@
 
 {# Set the title and sitename divider to '|' and hide 'no title' if the page has no title #}
 {% block htmltitle %}
-  {% if title == "<no title>" %}
-    <title>{{ docstitle|e }}</title>
-  {% else %}
-    <title>{{ title|striptags|e }} | {{ docstitle|e }}</title>
-  {% endif %}
+  <title>{{ title|striptags|e }} | {{ docstitle|e }}</title>
 {% endblock %}
 
 {# Google Tag Manager injection #}

source/index.rst

@@ -8,6 +8,17 @@
 .. meta::
    :description: Talkable campaigns, features and integration docs for referral program launch and settings.
 
+.. raw:: html
+
+   <div style="visibility: hidden; height: 0; overflow: hidden;">
+
+Main
+====
+
+.. raw:: html
+
+   </div>
+
 .. grid:: 1 2 2 2
 
     .. grid-item::