Migrate to Materialx/Properdocs

.gitattributes

@@ -0,0 +1,2 @@
+# SCM syntax highlighting & preventing 3-way merges
+pixi.lock merge=binary linguist-language=YAML linguist-generated=true -diff

.gitignore

@@ -19,3 +19,6 @@ site/*
 
 # Mac stuff
 .DS_Store
+# pixi environments
+.pixi/*
+!.pixi/config.toml

README.md

@@ -9,11 +9,10 @@ Uses [Material for MkDocs](https://squidfunk.github.io/mkdocs-material/) theme
 ## To build locally
 
 1. Create a python environment containing the packages in requirements.txt.
-We recommend using [mambaforge](https://mamba.readthedocs.io/en/latest/installation.html).
+We recommend using [pixi](https://pixi.prefix.dev/latest/)
 
 2. Build the site and start the docs server:
 
 ```bash
-mkdocs build
-mkdocs serve
+pixi run properdocs serve -o
 ```

docs/stylesheets/extra.css

@@ -1,8 +1,12 @@
 [data-md-color-scheme="default"] {
   --md-primary-fg-color: #0033A0;
+  --md-primary-fg-color--light: #0033A0;
+  --md-primary-fg-color--dark: #0033A0;
   --md-code-hl-color: #99C5ff;
 }
 [data-md-color-scheme="slate"] {
   --md-primary-fg-color: #0033A0;
+  --md-primary-fg-color--light: #0033A0;
+  --md-primary-fg-color--dark: #0033A0;
   --md-typeset-a-color: #4C9AFF;
 }

pixi.toml

@@ -0,0 +1,15 @@
+[workspace]
+authors = ["Jenny Fothergill <jennyfothergill@boisestate.edu>"]
+channels = ["conda-forge"]
+name = "docs"
+platforms = ["osx-arm64"]
+version = "0.1.0"
+
+[tasks]
+
+[dependencies]
+python = ">=3.14.7,<3.15"
+
+[pypi-dependencies]
+mkdocs-materialx = ">=10.2.0, <11"
+properdocs = ">=1.6.7, <2"

mkdocs.yml → properdocs.yml

@@ -37,9 +37,10 @@ theme:
     - navigation.instant
     - navigation.sections
     - toc.integrate
-  name: material
+  name: materialx
   logo: images/boisestate-B-1color-orange-rgb.png
   favicon: images/boisestate-B-1color-orange-rgb.png
+  topbar_style: primary
   palette:
   - scheme: default
     toggle:

requirements.txt

@@ -1,3 +1,3 @@
-mkdocs==1.6.1
-mkdocs-material==9.7.7
-Pygments==2.20.0
+properdocs==1.6.7
+mkdocs-materialx==9.7.6
+Pygments==2.21.0