Update to Python 3.12 (#37)

* Add Python 3.12 to GHA sphinx-linkcheck workflow

This lets us use the workflow to test whether all the packages the docs
build depends on have been updated to support Python 3.12.

* Add workflow_dispatch trigger to GHA linkcheck workflow

Enable workflow to be triggered from GitHub CLI, browser, or via API.

This is primarily to allow the workflow to be run via
    gh workflow run sphinx-linkcheck --ref py312
during the conda-forge Python 3.12 migration to test if the environment
is solvable yet.

* Change to just Python 3.12 for sphinx-linkcheck

sphinx-linkcheck workflow doesn't support Python versions matrix like
pytest-with-coverage in package repos does.

* Add Python 3.12 to GHA sphinx-linkcheck workflow

This lets us use the workflow to test whether all the packages the docs
build depends on have been updated to support Python 3.12.

* Add workflow_dispatch trigger to GHA linkcheck workflow

Enable workflow to be triggered from GitHub CLI, browser, or via API.

This is primarily to allow the workflow to be run via
    gh workflow run sphinx-linkcheck --ref py312
during the conda-forge Python 3.12 migration to test if the environment
is solvable yet.

* Change to just Python 3.12 for sphinx-linkcheck

sphinx-linkcheck workflow doesn't support Python versions matrix like
pytest-with-coverage in package repos does.

* Improve graham setup re: Miniforge install

Starting a new terminal session after the Miniforge install ensures that
the `conda` command is available for use.

* Add the sq alias to format squeue output on graham

* Fix broken link for HRDPS information page

* Update redirected link for NEMO-3.6 book

* Fix another broken link for HRDPS information page

* Change to Python 3.12 in build env

---------

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

.github/workflows/sphinx-linkcheck.yaml

@@ -5,6 +5,9 @@ on:
     branches: ['*']
   schedule:
     - cron: 43 4 8 * *  # 04:43 UTC on the 8th day of each month
+  # Enable workflow to be triggered from GitHub CLI, browser, or via API
+  # primarily for testing conda env solution for new Python versions
+  workflow_dispatch:
 
 jobs:
   sphinx-linkcheck:
@@ -15,7 +18,7 @@ jobs:
       matrix:
         # Need to specify Python version here because we use test env which gets its
         # Python version via matrix
-        python-version: [ '3.10' ]
+        python-version: [ '3.12' ]
     uses: UBC-MOAD/gha-workflows/.github/workflows/sphinx-linkcheck.yaml@main
     with:
       python-version: ${{ matrix.python-version }}

environment-rtd.yaml

@@ -26,6 +26,6 @@ dependencies:
   - ipython
   - nbsphinx
   - pip
-  - python=3.10
+  - python=3.12
   - sphinx
   - sphinx_rtd_theme=1.2