Merge pull request #21 from hermes-hmc/20-migrate

migrate to poetry, update theme, repair page

Author: poikilotherm

.readthedocs.yaml

@@ -0,0 +1,17 @@
+version: 2
+
+build:
+  os: ubuntu-20.04
+  tools:
+    python: "3.10"
+  jobs:
+    post_install:
+      - pip install "poetry>=1.2.0,<1.3.0"
+      - poetry config virtualenvs.create false
+      - poetry install
+
+# Build documentation with Sphinx
+sphinx:
+  builder: html
+  configuration: conf.py
+  fail_on_warning: true

_static/custom.css

@@ -1,6 +1,17 @@
+.funding {
+    font-size: 75%;
+    position: absolute;
+    bottom: 1rem;
+}
+
+/* Workaround for sidebar scrollbar, see also https://github.com/executablebooks/sphinx-book-theme/issues/732 */
+.bd-sidebar-primary div#rtd-footer-container {
+    position:fixed;
+}
+
 img.member {
     max-width: 15%;
-    border-radius: 50%;
+    border-radius: 50% !important;
     margin-top: 0.3em;
 }
 

_templates/funding.html

@@ -0,0 +1,8 @@
+<div class="funding">
+  Funded by the <i>Initiative and Networking Fund</i> of the
+  <a href='https://www.helmholtz.de/en/about-us/structure-and-governance/initiating-and-networking/' target='_blank'>
+    Helmholtz Association
+  </a>
+  in the framework of the
+  <a href='https://helmholtz-metadaten.de' targe='_blank'>Helmholtz Metadata Collaboration</a>
+</div>

conf.py

@@ -83,7 +83,7 @@
 
 # Custom sidebar templates, maps document names to template names.
 html_sidebars = {
-    "**": ["sidebar-logo.html", "sbt-sidebar-nav.html"]
+    "**": ["navbar-logo.html", "sbt-sidebar-nav.html", "funding.html"]
 }
 
 # Enable and customize the permanent headerlinks with a nice icon (chain symbol from FontAwesome)
@@ -92,19 +92,19 @@
 
 html_theme_options = {
     "home_page_in_toc": True,
-    "extra_navbar": "<div>Funded by the <i>Initiative and Networking Fund</i> of the <a \
-                     href='https://www.helmholtz.de/en/about-us/structure-and-governance/initiating-and-networking/' \
-                    target='_blank'>Helmholtz Association</a> in the framework of the \
-                    <a href='https://helmholtz-metadaten.de' targe='_blank'>Helmholtz Metadata \
-                    Collaboration</a></div>",
     "repository_url": "https://github.com/hermes-hmc/project",
     "use_repository_button": True,
+    "navigation_with_keys": False,
 }
 
 html_css_files = [
     'custom.css',
 ]
 
+html_context = {
+    "default_mode": "light",
+}
+
 # -- Options for OpenGraph Tags ----------------------------------------------
 
 ogp_site_url = "https://project.software-metadata.pub/"