There didn't seem to be a way to convince sphinx-multiversion to use

the correct version in the breadcrumbs.

So this changes the html_title (which is the first thing displayed in the
breadcrumbs) to "PSI/J" and inserts the version dropdown after that. This
also seems to make better sense from a usability perspective since there
is only one control to both display and change the version.

Author: hategan

docs/_templates/layout.html

@@ -16,6 +16,11 @@
         {{ super() }}
 {% endblock %}
 
+{% block rootrellink %}
+    <li><a href="{{ pathto(theme_roottarget) }}">{{shorttitle|e}}</a>{% if versions %}{% include "../../web/_includes/versionselect.html" %}{% endif %}{{reldelim1}}</li>
+{% endblock %}
+
+
 {% block footer %}
         {{ super() }}
 

docs/_templates/versioning.html

@@ -35,17 +35,25 @@
 ]
 
 if web_docs:
-	templates_path = ['_templates']
-	# Multi-version
-	smv_branch_whitelist = '^mathcmeifyoucan$'
-	smv_remote_whitelist = None
-	smv_released_pattern = r'^\d+\.\d+\.\d+(\..*)?$'
-	smv_outputdir_format = 'v/{ref.name}'
+    templates_path = ['_templates']
+    # Unfortunately sphinx-multiversion does not properly deal with 
+    # setting the title to the proper version. You either get some
+    # default like "0.0.1" or you get whatever the current conf.py
+    # sets (i.e., the latest version).
+    # See, e.g., https://github.com/Holzhaus/sphinx-multiversion/issues/61
+    #
+    # But we already have the version selector that displays the version,
+    # so we can display that where the broken version would otherwise
+    # have appeared.
+    html_title = "PSI/J"
+    # Multi-version
+    smv_branch_whitelist = '^matchmeifyoucan$'
+    smv_remote_whitelist = None
+    smv_released_pattern = r'^\d+\.\d+\.\d+(\..*)?$'
+    smv_outputdir_format = 'v/{ref.name}'
 
 
 html_sidebars = {'**': ['globaltoc.html', 'relations.html', 'sourcelink.html', 'searchbox.html']}
-if web_docs:
-	html_sidebars['**'].insert(0, 'versioning.html')
 
 # These are needed for the dhtml trickery
 html_static_path = ["_static"]
@@ -67,17 +75,23 @@
 autodoc_typehints = "description"
 autodoc_typehints_format = "short"
 
+release = None
+version = None
+src_dir = None
+
+def read_version(docs_dir):
+    global release, version, src_dir
+    src_dir = os.path.abspath(os.path.join(docs_dir, '../src'))
 
-script_dir = os.path.normpath(os.path.dirname(__file__))
-src_dir = os.path.abspath(os.path.join(script_dir, '../src'))
+    sys.path.insert(0, src_dir)
 
-print(src_dir + "/")
+    import psij
+    release = psij.__version__
+    version = release
 
-sys.path.insert(0, src_dir)
 
-import psij
-release = psij.__version__
-version = release
+my_dir = os.path.normpath(os.path.dirname(__file__))
+read_version(my_dir)
 
 intersphinx_mapping = {
     'python': ('https://docs.python.org/3', None),
@@ -90,6 +104,7 @@
 
 # run api doc
 def run_apidoc(sphinx):
+    read_version(sphinx.srcdir)  # this sets src_dir based on the version being compiled
     output_path = os.path.join(sphinx.srcdir, '.generated')
     main(['-f', '-o', output_path, src_dir])
 

docs/conf.py

@@ -1,3 +1,3 @@
             <div id="version-selector">
-                <v-select prefix="Version" :items="getSortedVersionLabels()" @change="setVersion" v-model="version"></v-select>
+                <v-select :items="getSortedVersionLabels()" @change="setVersion" v-model="version"></v-select>
             </div>

web/_includes/versionselect.html

@@ -235,8 +235,18 @@ pre {
 /*** Versioning ***/
 
 #version-selector {
-    margin-top: 4pt;
-    margin-right: 4pt;
+    display: inline-block;
+    margin: 0;
+}
+
+#version-selector .v-input__control, #version-selector .v-input__slot,
+#version-selector .v-select__slot, #version-selector .v-select__selection {
+    width: fit-content;
+    text-overflow: none;
+}
+
+#version-selector .v-input__control {
+    height: 18pt;
 }
 
 #version-selector .v-text-field__prefix {