Merge branch 'master' into master

Author: lukelbd

.gitignore

@@ -16,6 +16,7 @@ dist
 # Local docs builds
 docs/api
 docs/_build
+docs/_static/pygments
 
 # Subfolder used to consider new colormaps
 sources

.travis.yml

@@ -28,7 +28,7 @@ before_install:
   - conda info -a
 
 install:
-  - conda env create -n proplot-dev --file ci/environment.yml
+  - conda env create --name proplot-dev --file ci/environment.yml
   - source activate proplot-dev
   - conda list
   - which conda

CHANGELOG.rst

@@ -1,8 +1,11 @@
 # Hard requirements for running tests
-# NOTE: Basemap is broken as of matplotlib >=3.3 so for documentation
+# NOTE: Keep up-to-date with docs/environment.yml!
+# NOTE: Basemap is broken as of matplotlib >= 3.3 so for documentation
 # use 3.2.1. Probably lots of basemap holdouts for next ~5 years.
 # NOTE: PyQt5 is needed by pyplot, RTD server *happens* to already have it
 # but creating local environment will fail.
+# NOTE: Jinja >= 3.0 and nbsphinx >= 0.8.2 seem to break default ReST roles when
+# jupytext notebooks are converted to HTML. Interpreted as italics instead.
 name: proplot-dev
 channels:
   - conda-forge
@@ -24,10 +27,11 @@ dependencies:
     - doc8
     - pytest
     - pytest-sugar
+    - pyqt5
     - sphinx>=3.0
     - sphinx-copybutton
     - sphinx_rtd_theme==0.4.3
     - jupytext
-    - nbsphinx
-    - git+https://github.com/lukelbd/sphinx-automodapi@v0.8.proplot-mods
-    - pyqt5
+    - jinja2==2.11.3
+    - nbsphinx==0.8.1
+    - git+https://github.com/lukelbd/sphinx-automodapi@v0.9.proplot-mods

ci/environment.yml

@@ -376,14 +376,6 @@ hr {
 }
 
 /* RTD versions box colors */
-/* Also make entire sidebar scrollable but add empty space to the bottom
- * of the colling region, rather than truncating the scrollable space */
-nav.wy-nav-side .ethical-rtd {
-  margin-bottom: 3em !important;  /* padding below ad or below sidebar */
-}
-nav.wy-nav-side {
-  padding-bottom: 0em !important;  /* entire sidebar is always scrollable */
-}
 .rst-versions .rst-current-version {
   padding: 0.66em;  /* match padding for list items */
   color: var(--versions-color);
@@ -407,6 +399,17 @@ nav.wy-nav-side {
   color: var(--main-color);
 }
 
+/* Make entire sidebar scrollable but add empty space to the bottom
+ * of the colling region, rather than truncating the scrollable space */
+/*
+ * nav.wy-nav-side .ethical-rtd {
+ *   margin-bottom: 3em !important;  #<{(| padding below ad or below sidebar |)}>#
+ * }
+ * nav.wy-nav-side {
+ *   padding-bottom: 0em !important;  #<{(| entire sidebar is always scrollable |)}>#
+ * }
+ */
+
 /* Next and previous buttons */
 .btn {
   border: 1px solid var(--block-color);