From 2de4370609ea7bd83c5d618f85b7b2cab6d0ee60 Mon Sep 17 00:00:00 2001
From: Charles G Waldman <cgw@alum.mit.edu>
Date: Fri, 1 May 2026 12:02:05 -0500
Subject: [PATCH 1/2] add furo to CI

---
 .gitlab-ci.yml | 5 +----
 1 file changed, 1 insertion(+), 4 deletions(-)

diff --git a/.gitlab-ci.yml b/.gitlab-ci.yml
index 73ee45c..03ab118 100644
--- a/.gitlab-ci.yml
+++ b/.gitlab-ci.yml
@@ -15,7 +15,7 @@ workflow:
 docs:userguide:
   image: sphinxdoc/sphinx:latest
   script:
-    - pip install -q sphinx_rtd_theme sphinx_tabs sphinxcontrib-bibtex
+    - pip install -q furo sphinx_rtd_theme sphinx_tabs sphinxcontrib-bibtex
     - sphinx-build -W -b html docs/source_docs/ build/docs
     - sphinx-build -W -b html docs/picvva/ build/picvva
   stage: build-docs
@@ -54,6 +54,3 @@ deploy:docs:
     - docker
   rules:
     - if: $CI_COMMIT_BRANCH == "main"
-
-
-
-- 
GitLab


From 9b204f0edede475daef10215e375a8a0437bee16 Mon Sep 17 00:00:00 2001
From: Charles G Waldman <cgw@alum.mit.edu>
Date: Mon, 4 May 2026 15:01:51 -0500
Subject: [PATCH 2/2] add furo to README

---
 README.md | 14 +++++++-------
 1 file changed, 7 insertions(+), 7 deletions(-)

diff --git a/README.md b/README.md
index b4b707c..5fb0545 100644
--- a/README.md
+++ b/README.md
@@ -30,20 +30,20 @@ can be built locally by:
 
 1. Install sphinx:
 
-```shell
-> pip install sphinx sphinx_rtd_theme sphinx-tabs sphinxcontrib-bibtex
+```console
+$ pip install sphinx furo sphinx_rtd_theme sphinx-tabs sphinxcontrib-bibtex
 ```
 
 2. Build the documentation (HTML):
 
-```shell
+```console
 $ make  # note, "make html" also works
 ```
 
 The HTML pages will be located in the `build/html` directory.
 Open the `index.html` with your favorite browser:
 
-```shell
+```console
 $ firefox build/html/index.html
 ```
 
@@ -54,14 +54,14 @@ distribution's package repository.  On Ubuntu something like
 ``sudo apt-get install texlive-xetex`` should do the trick.
 More info at https://www.tug.org/texlive/
 
-```shell
+```console
 $ make pdf
 ```
 
-The output file `mfix.pdf` will be in `build/latex`.  PDF output is 
+The output file `mfix.pdf` will be in `build/latex`.  PDF output is
 experimental at this time and there may be some formatting issues.
 
 4. Cleaning up:
-``` shell
+```console
 $ make clean
 ```
-- 
GitLab