Merge pull request #2 from shnizzedy/furo-theme

👽️ Inject version dropdowns in furo theme

Author: nx10

docs/_sources/_static/custom.css

@@ -1,3 +1,19 @@
+/* docs version dropdown: top bar */
+.brand > select {
+  background: transparent;
+  border: none;
+  color: var(--color-header-text);
+}
+
+/* docs version dropdown: side bar */
+.sidebar-brand-text > select {
+    background-color: transparent;
+    border: none;
+    color: var(--color-sidebar-link-text--top-level);
+    text-decoration: underline;
+    text-decoration-color: var(--color-link-underline);
+}
+
 .svg-flowchart > svg {
   width: 100%;
   height: auto;

scripts/versionList.js renamed to docs/_sources/_static/versionList.js

@@ -24,9 +24,10 @@ function createDropdown(here) {
 function versionDropdown() {
   const here = window.location.href;
   const dochome = "https://" + here.split('/').slice(2, 5).join('/');
-  const navTitles = document.getElementsByClassName("nav-item-0");
+  const navTitles = document.querySelectorAll(".brand,.sidebar-brand-text");
   createDropdown(here).then(dropdown => {
     for (let item of navTitles) {
+      item.parentElement.removeAttribute("href");
       let newTitle = document.createElement("div");
       let newTitlePrefix = document.createElement("a");
       newTitlePrefix.setAttribute("href", dochome);

docs/_sources/_templates/layout.html

@@ -9,5 +9,4 @@
       gtag('js', new Date());
       gtag('config', 'UA-19224662-10');
     </script>
-    <script defer src="https://fcp-indi.github.io/scripts/versionList.js"></script>
 {% endblock %}

docs/_sources/conf.py

@@ -171,7 +171,7 @@ def yaml_to_rst(path):
 
 # General information about the project.
 project = 'C-PAC'
-copyright = '2012‒2022, C-PAC Developers. C-PAC is licensed under LGPL-3' \
+copyright = '2012‒2023, C-PAC Developers. C-PAC is licensed under LGPL-3' \
             '.0-or-later'
 # The version info for the project you're documenting, acts as replacement for
 # |version| and |release|, also used in various other places throughout the
@@ -435,6 +435,8 @@ def _unireplace(release_note, unireplace):
 html_css_files = [
     'custom.css',
 ]
+html_js_files = [
+    ('versionList.js', {'defer': 'defer'})]
 
 # If not '', a 'Last updated on:' timestamp is inserted at every page bottom,
 # using the given strftime format.