Merge pull request #20 from ronpandolfi/master

Docs build fixes

.readthedocs.yml

@@ -7,21 +7,15 @@ version: 2
 
 # Set the version of Python and other tools you might need
 build:
-  os: ubuntu-22.04
+  os: ubuntu-20.04
   tools:
     python: "3.9"
-    # You can also specify other tool versions:
-    # nodejs: "16"
-    # rust: "1.55"
-    # golang: "1.17"
 
 # Build documentation in the docs/ directory with Sphinx
 sphinx:
   configuration: docs/source/conf.py
 
-# If using Sphinx, optionally build your docs in additional formats such as PDF
-# formats:
-#    - pdf
+formats: all
 
 # Optionally declare the Python requirements required to build your docs
 python:
@@ -30,6 +24,3 @@ python:
       path: .
       extra_requirements:
         - docs
-#    - method: setuptools
-#      path: another/package
-  system_packages: true

docs/source/_templates/layout.html

@@ -14,7 +14,7 @@
 {% endblock %}
 
 {% block scripts %}
-{% if meta is defined and 'banner' in meta %}
+{% if meta is defined and meta is not none and 'banner' in meta %}
 <style>
     /* Hide document h1s (they show in the banners) */
     .document h1 {
@@ -27,7 +27,7 @@
 
 {% block mobile_nav %}
 {{ super() }}
-{% if meta is defined and 'banner' in meta %}
+{% if meta is defined and meta is not none and 'banner' in meta %}
 </nav>
 <div class="container" style="text-align: center; position: relative; width:100%; max-width: unset; height:{{ meta.banner_height|default('340px', true)}}; background-size:cover; background-position:center {{ meta.banner_align|default('center', true) }}; transform: translate3d(0px, 0px, 0px); background-image: linear-gradient(rgba({{meta.banner_shade|default(0, true)|float}}, {{meta.banner_shade|default(0, true)|float}}, {{meta.banner_shade|default(0, true)|float}}, {{1 - meta.banner_brightness|default(1, true)|float}}), rgba({{meta.banner_shade|default(0, true)|float}}, {{meta.banner_shade|default(0, true)|float}}, {{meta.banner_shade|default(0, true)|float}}, {{1 - meta.banner_brightness|default(1, true)|float}})), url('{{ meta.banner }}');">
     {% if 'banner_contents' in meta %}

docs/source/conf.py

@@ -74,6 +74,4 @@
     titles_only=False
 )
 
-# Configure execution (and output generation) of myst-nb files
-jupyter_execute_notebooks = "auto"
 autodoc_member_order = 'bysource'