Fix issues with multi-version docs (#700)

* trigger sphinx docs deployment also upon merges to main

* add theme switcher to end of navbar

* move theme switcher to its original position in the navbar

Author: niksirbi

.github/workflows/docs_build_and_deploy.yml

@@ -53,6 +53,7 @@ jobs:
       contents: write
     if: |
       (github.event_name == 'push' && github.ref_type == 'tag') ||
+      (github.event_name == 'push' && github.ref == 'refs/heads/main') ||
       (github.event_name == 'workflow_dispatch' && github.ref == 'refs/heads/main')
     runs-on: ubuntu-latest
     steps:

docs/source/conf.py

@@ -159,7 +159,7 @@
     "logo": {
         "text": f"{project} v{release}",
     },
-    "navbar_end": ["version-switcher", "navbar-icon-links"],
+    "navbar_end": ["version-switcher", "theme-switcher", "navbar-icon-links"],
     "footer_start": ["footer_start"],
     "footer_end": ["footer_end"],
     "external_links": [],