Set upper limit on version of nbconvert (HinodeXRT#215)

* Update .gitignore

* Run nbclean

* Remove empty cell at end of notebook

* Rename notebook without underscore

* Update GitHub Action to install pandoc from repo

* Make GitHub Action more concise

* Set upper limit on nbconvert

* Revert some changes

...while adding some backticks

* Revert a change

* Remove upper limit on nbconvert

* Build docs on macOS rather than Ubuntu

* Use brew to install graphviz & pandoc

* Revert "Use brew to install graphviz & pandoc"

This reverts commit b72ac70.

* Revert "Build docs on macOS rather than Ubuntu"

This reverts commit 632ed78.

* Revert "Remove upper limit on nbconvert"

This reverts commit 0e2ce80.

Author: namurphy

.github/workflows/testing.yml

@@ -71,7 +71,7 @@ jobs:
         include:
 
         - name: Documentation
-          python: '3.10'
+          python: '3.12'
 
     steps:
 
@@ -88,8 +88,16 @@ jobs:
     - name: Install nox
       run: python -m pip install --progress-bar off --upgrade nox
 
-    - name: Install graphviz and pandoc
-      run: sudo apt install graphviz pandoc
+    - name: Install graphviz
+      run: sudo apt install graphviz
+
+    - name: Install pandoc
+      run: |
+        PANDOC_VERSION="3.1.11.1"
+        wget -q https://github.com/jgm/pandoc/releases/download/${PANDOC_VERSION}/pandoc-${PANDOC_VERSION}-1-amd64.deb
+        sudo dpkg -i pandoc-${PANDOC_VERSION}-1-amd64.deb
+        rm pandoc-${PANDOC_VERSION}-1-amd64.deb
+        pandoc --version
 
     - name: Build documentation
       run: nox -e build_docs_nitpicky -- -q

docs/notebooks/data_analysis/Deconvolving_XRT_images.ipynb

@@ -90,14 +90,6 @@
     "fig.subplots_adjust(wspace=0.5)\n",
     "plt.show()"
    ]
-  },
-  {
-   "cell_type": "code",
-   "execution_count": null,
-   "id": "549d08ea",
-   "metadata": {},
-   "outputs": [],
-   "source": []
   }
  ],
  "metadata": {

docs/notebooks/data_analysis/Remove_lightleak.ipynb

@@ -5,7 +5,7 @@
    "id": "075bbcc4",
    "metadata": {},
    "source": [
-    "# Using the remove_lightleak function to analyze XRT composite images"
+    "# Using the `remove_lightleak` function to analyze XRT composite images"
    ]
   },
   {
@@ -130,14 +130,6 @@
     "fig.subplots_adjust(wspace=0.5)\n",
     "plt.show()"
    ]
-  },
-  {
-   "cell_type": "code",
-   "execution_count": null,
-   "id": "eda9e234",
-   "metadata": {},
-   "outputs": [],
-   "source": []
   }
  ],
  "metadata": {

requirements/docs.txt

@@ -8,6 +8,7 @@ docutils >= 0.18
 ipykernel
 ipython
 jinja2 != 3.1
+nbconvert < 7.14
 nbsphinx >= 0.9
 numpydoc >= 1.2
 pillow

setup.cfg

@@ -64,6 +64,7 @@ docs =
     ipykernel
     ipython
     jinja2 != 3.1
+    nbconvert < 7.14
     nbsphinx >= 0.9
     numpydoc >= 1.2
     pillow