SalishSeaCast · douglatornell · Jan 14, 2026 · Jan 14, 2026 · Jan 14, 2026 · Jan 14, 2026
diff --git a/.gitattributes b/.gitattributes
@@ -0,0 +1,2 @@
+# SCM syntax highlighting & preventing 3-way merges
+pixi.lock merge=binary linguist-language=YAML linguist-generated=true -diff
diff --git a/.github/workflows/sphinx-linkcheck.yaml b/.github/workflows/sphinx-linkcheck.yaml
@@ -13,15 +13,5 @@ jobs:
   sphinx-linkcheck:
     permissions:
       contents: read
-    strategy:
-      fail-fast: false
-      matrix:
-        # Need to specify Python version here because we use test env which gets its
-        # Python version via matrix
-        python-version: [ '3.13' ]
-    uses: UBC-MOAD/gha-workflows/.github/workflows/sphinx-linkcheck.yaml@main
-    with:
-      python-version: ${{ matrix.python-version }}
-      conda-env-file: environment-rtd.yaml
-      conda-env-name: salishseacast-docs
-      docs-dir: .
+
+    uses: UBC-MOAD/gha-workflows/.github/workflows/pixi-sphinx-linkcheck.yaml@main
diff --git a/.gitignore b/.gitignore
@@ -3,6 +3,10 @@
 ### Sphinx documentation
 _build/
 
+# pixi environments
+.pixi/*
+!.pixi/config.toml
+
 
 ### Vim template
 # Swap

diff --git a/.pre-commit-config.yaml b/.pre-commit-config.yaml
@@ -12,4 +12,5 @@ repos:
       - id: trailing-whitespace
       - id: end-of-file-fixer
       - id: check-yaml
+      - id: check-toml
       - id: check-added-large-files
diff --git a/.readthedocs.yaml b/.readthedocs.yaml
@@ -5,15 +5,22 @@ version: 2
 build:
   os: ubuntu-22.04
   tools:
-    python: "mambaforge-23.11"
+    python: "latest"
 
-conda:
-  environment: environment-rtd.yaml
+  jobs:
+    create_environment:
+      - asdf plugin add pixi
+      - asdf install pixi latest
+      - asdf global pixi latest
+    install:
+      - pixi install
+    build:
+      html:
+        - pixi run sphinx-build -T -b html ./ $READTHEDOCS_OUTPUT/html
 
 sphinx:
-    builder: html
-    configuration: conf.py
-    fail_on_warning: false
+  configuration: conf.py
+  fail_on_warning: false
 
 # Only build HTML and JSON formats
 formats: []
diff --git a/README.md b/README.md
@@ -5,6 +5,7 @@ Salish Sea MEOPAR Documentation
 
 [![Creative Commons Attribution Attribution 3.0 Unported](https://img.shields.io/badge/license-CC--BY-lightgrey.svg)](https://creativecommons.org/licenses/by/3.0/deed.en_US)
 [![Git on GitHub](https://img.shields.io/badge/version%20control-git-blue.svg?logo=github)](https://github.com/SalishSeaCast/docs)
+[![Pixi Badge](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/prefix-dev/pixi/main/assets/badge/v0.json)](https://pixi.sh)
 [![Documentation Status](https://readthedocs.org/projects/salishsea-meopar-docs/badge/?version=latest)](https://salishsea-meopar-docs.readthedocs.io/en/latest/)
 [![sphinx-linkcheck](https://github.com/SalishSeaCast/docs/workflows/sphinx-linkcheck/badge.svg)](https://github.com/SalishSeaCast/docs/actions?query=workflow:sphinx-linkcheck)
 [![Issue Tracker](https://img.shields.io/github/issues/SalishSeaCast/docs?logo=github)](https://github.com/SalishSeaCast/docs/issues)

diff --git a/conf.py b/conf.py
@@ -102,7 +102,7 @@
 
 # List of patterns, relative to source directory, that match files and
 # directories to ignore when looking for source files.
-exclude_patterns = ['_build']
+exclude_patterns = ['_build', '.pixi']
 
 # The name of the Pygments (syntax highlighting) style to use.
 pygments_style = 'sphinx'

diff --git a/environment-rtd.yaml b/environment-rtd.yaml
diff --git a/pixi.lock b/pixi.lock
diff --git a/pixi.toml b/pixi.toml
@@ -0,0 +1,32 @@
+[workspace]
+authors = ["Doug Latornell <dlatornell@eoas.ubc.ca>"]
+channels = ["conda-forge"]
+name = "salishseacast-docs"
+platforms = ["linux-64", "osx-64", "osx-arm64", "win-64"]
+readme = "README.md"
+repository = "https://github.com/SalishSeaCast/docs"
+documentation = "https://salishsea-meopar-docs.readthedocs.io/en/latest/"
+
+[tasks]
+docs = "make clean html"
+linkcheck = "make clean linkcheck"
+update-reqs = "python -m pip list --format=freeze >> requirements.txt"
+
+[dependencies]
+ipython = "*"
+pandoc = "*"
+python = "3.14.*"
+# For repo QA
+pip = ">=25.3,<26"
+pre-commit = "*"
+# For documentation
+nbsphinx = "==0.9.5"
+sphinx = "==8.1.3"
+sphinx-notfound-page = "==1.0.4"
+sphinx-rtd-theme = "==3.0.0"
+
+[pypi-dependencies]
+# For build on readthedocs
+commonmark = ">=0.9.1, <0.10"
+recommonmark = ">=0.7.1, <0.8"
+readthedocs-sphinx-ext = ">=2.2.5, <3"
diff --git a/requirements.txt b/requirements.txt
@@ -1,86 +1,101 @@
-# Python packages and versions used in recent docs development environment
+# Python packages and versions used most recently in docs development environment
 #
-# Create/update this file with:
-#   (salishseacast-docs)$ python -m pip list --format=freeze >> requirements.txt
+# This file is retained so that we will continue to get security update notifications
+# and PRs from dependabot. It will be dropped when dependabot adds support for
+# the `pixi.lock` file.
+#
+# Update this file with:
+#   pixi run update-reqs
 
 alabaster==1.0.0
-asttokens==3.0.0
-attrs==25.3.0
+asttokens==3.0.1
+attrs==25.4.0
 babel==2.17.0
-beautifulsoup4==4.13.5
-bleach==6.2.0
-certifi==2025.8.3
-cffi==1.17.1
-cfgv==3.3.1
-charset-normalizer==3.4.3
+beautifulsoup4==4.14.3
+bleach==6.3.0
+Brotli==1.2.0
+certifi==2026.1.4
+cffi==2.0.0
+cfgv==3.5.0
+charset-normalizer==3.4.4
+colorama==0.4.6
+commonmark==0.9.1
 decorator==5.2.1
 defusedxml==0.7.1
 distlib==0.4.0
 docutils==0.21.2
-exceptiongroup==1.3.0
 executing==2.2.1
 fastjsonschema==2.21.2
 filelock==3.20.3
-identify==2.6.14
-idna==3.10
+h2==4.3.0
+hpack==4.1.0
+hyperframe==6.1.0
+identify==2.6.16
+idna==3.11
 imagesize==1.4.1
-ipython==9.5.0
+importlib_metadata==8.7.0
+ipython==9.9.0
 ipython_pygments_lexers==1.1.1
 jedi==0.19.2
 Jinja2==3.1.6
-jsonschema==4.25.1
+jsonschema==4.26.0
 jsonschema-specifications==2025.9.1
-jupyter_client==8.6.3
-jupyter_core==5.8.1
+jupyter_client==8.8.0
+jupyter_core==5.9.1
 jupyterlab_pygments==0.3.0
-MarkupSafe==3.0.2
-matplotlib-inline==0.1.7
-mistune==3.1.4
-nbclient==0.10.2
+MarkupSafe==3.0.3
+matplotlib-inline==0.2.1
+mistune==3.2.0
+nbclient==0.10.4
 nbconvert==7.16.6
 nbformat==5.10.4
 nbsphinx==0.9.5
-nodeenv==1.9.1
+nodeenv==1.10.0
 packaging==25.0
-pandocfilters==1.5.1
+pandocfilters==1.5.0
 parso==0.8.5
 pexpect==4.9.0
-pickleshare==0.7.5
 pip==25.3
-platformdirs==4.4.0
-pre_commit==4.3.0
+platformdirs==4.5.1
+pre_commit==4.5.1
 prompt_toolkit==3.0.52
 ptyprocess==0.7.0
 pure_eval==0.2.3
 pycparser==2.22
 Pygments==2.19.2
+PySocks==1.7.1
 python-dateutil==2.9.0.post0
-PyYAML==6.0.2
+pytz==2025.2
+PyYAML==6.0.3
 pyzmq==27.1.0
-referencing==0.36.2
+readthedocs-sphinx-ext==2.2.5
+recommonmark==0.7.1
+referencing==0.37.0
 requests==2.32.5
-rpds-py==0.27.1
+rpds-py==0.30.0
 setuptools==80.9.0
 six==1.17.0
 snowballstemmer==3.0.1
-soupsieve==2.8
+soupsieve==2.8.1
 Sphinx==8.1.3
 sphinx-notfound-page==1.0.4
-sphinx-rtd-theme==3.0.0
+sphinx_rtd_theme==3.0.0
 sphinxcontrib-applehelp==2.0.0
 sphinxcontrib-devhelp==2.0.0
 sphinxcontrib-htmlhelp==2.1.0
 sphinxcontrib-jquery==4.1
 sphinxcontrib-jsmath==1.0.1
 sphinxcontrib-qthelp==2.0.0
-sphinxcontrib-serializinghtml==2.0.0
+sphinxcontrib-serializinghtml==1.1.10
 stack_data==0.6.3
-tinycss2==1.4.0
-tornado==6.5.2
+tinycss2==1.5.1
+tomli==2.4.0
+tornado==6.5.3
 traitlets==5.14.3
 typing_extensions==4.15.0
 ukkonen==1.0.1
 urllib3==2.6.3
 virtualenv==20.36.1
-wcwidth==0.2.13
+wcwidth==0.2.14
 webencodings==0.5.1
+zipp==3.23.0
Original file line number	Diff line number	Diff line change
		@@ -0,0 +1,2 @@
		# SCM syntax highlighting & preventing 3-way merges
		pixi.lock merge=binary linguist-language=YAML linguist-generated=true -diff