From 7687fcf6cdc7d064ec136def4b48e4710407b726 Mon Sep 17 00:00:00 2001
From: Michael Altfield <michael@michaelaltfield.net>
Date: Thu, 23 Jul 2020 14:48:29 +0545
Subject: [PATCH] improving usability of lower-left rtd menu

This commit makes several changes to the rtd theme's version.html template such that the lower-left rtd menu now has:

 1. Support to display nav links to alternate languages by defining them as a list of tuples (just like versions and downloads)

 2. Adds a new variable 'display_lower_left' so that the lower-left menu can be toggled independently, while the "On Read the Docs" section is toggled with the READTHEDOCS boolean.

 3. Adds a conditional to the 'versions' section to display the current version in bold (same as readthedocs.io does)

 4. Add a conditional to the 'downloads' section to only display the downloads section if there's a non-empty downloads list

For more information about this change, see:

 * https://tech.michaelaltfield.net/2020/07/23/sphinx-rtd-github-pages-2/
---
 sphinx_rtd_theme/versions.html | 20 +++++++++++++++++++-
 1 file changed, 19 insertions(+), 1 deletion(-)

diff --git a/sphinx_rtd_theme/versions.html b/sphinx_rtd_theme/versions.html
index 7368659c4..7452ea291 100644
--- a/sphinx_rtd_theme/versions.html
+++ b/sphinx_rtd_theme/versions.html
@@ -1,4 +1,4 @@
-{% if READTHEDOCS %}
+{% if READTHEDOCS or display_lower_left %}
 {# Add rst-badge after rst-versions for small badge style. #}
   <div class="rst-versions" data-toggle="rst-versions" role="note" aria-label="versions">
     <span class="rst-current-version" data-toggle="rst-current-version">
@@ -7,18 +7,35 @@
       <span class="fa fa-caret-down"></span>
     </span>
     <div class="rst-other-versions">
+      {% if languages|length >= 1 %}
+      <dl>
+        <dt>{{ _('Languages') }}</dt>
+        {% for slug, url in languages %}
+          {% if slug == current_language %} <strong> {% endif %}
+          <dd><a href="{{ url }}">{{ slug }}</a></dd>
+          {% if slug == current_language %} </strong> {% endif %}
+        {% endfor %}
+      </dl>
+      {% endif %}
+      {% if versions|length >= 1 %}
       <dl>
         <dt>{{ _('Versions') }}</dt>
         {% for slug, url in versions %}
+          {% if slug == current_version %} <strong> {% endif %}
           <dd><a href="{{ url }}">{{ slug }}</a></dd>
+          {% if slug == current_version %} </strong> {% endif %}
         {% endfor %}
       </dl>
+      {% endif %}
+      {% if downloads|length >= 1 %}
       <dl>
         <dt>{{ _('Downloads') }}</dt>
         {% for type, url in downloads %}
           <dd><a href="{{ url }}">{{ type }}</a></dd>
         {% endfor %}
       </dl>
+      {% endif %}
+      {% if READTHEDOCS %}
       <dl>
         {# Translators: The phrase "Read the Docs" is not translated #}
         <dt>{{ _('On Read the Docs') }}</dt>
@@ -29,6 +46,7 @@
             <a href="//{{ PRODUCTION_DOMAIN }}/builds/{{ slug }}/?fromdocs={{ slug }}">{{ _('Builds') }}</a>
           </dd>
       </dl>
+      {% endif %}
     </div>
   </div>
 {% endif %}