fix i18n & (I hope) mathjax

Author: briantoby

.github/workflows/test_builddocsite.yml

@@ -29,11 +29,11 @@ jobs:
       - name: Sphinx setup
         run: |
           pip install sphinx sphinx_readable_theme
-      - name: mkdocs setup
-        run: |
-          pip install mkdocs mkdocs-material python-markdown-math mkdocs-i18n
       - name: pandoc setup
         uses: pandoc/actions/setup@v1
+      - name: mkdocs setup
+        run: |
+          pip install mkdocs mkdocs-material python-markdown-math mkdocs-static-i18n
 
       - name: Checkout
         uses: actions/checkout@v4

MDhelp/README.md

@@ -28,15 +28,4 @@ These files have had only minor editing. A few need to be broken up:
       39 docs/singlecrystal.md
       94 docs/smallanglescattering.md
 
-Removed internationalization (i18n from mkdocs.yml) because of error
-message from mkdocs:
-
-    (/tmp/py313) py3.13 MDhelp % mkdocs build
-    ERROR   -  Config value 'plugins': Plugin 'i18n' option 'languages': Expected
-           type: <class 'dict'> but received: <class 'list'>
-
-when using:
-
-    pip install mkdocs mkdocs-material python-markdown-math mkdocs-i18n
-
-    Successfully installed babel-2.17.0 backrefs-5.9 certifi-2025.7.14 charset_normalizer-3.4.2 click-8.2.1 colorama-0.4.6 ghp-import-2.1.0 idna-3.10 jinja2-3.1.6 markdown-3.8.2 markupsafe-3.0.2 mergedeep-1.3.4 mkdocs-1.6.1 mkdocs-get-deps-0.2.0 mkdocs-i18n-0.4.6 mkdocs-material-9.6.15 mkdocs-material-extensions-1.3.1 packaging-25.0 paginate-0.5.7 pathspec-0.12.1 platformdirs-4.3.8 pygments-2.19.2 pymdown-extensions-10.16 python-dateutil-2.9.0.post0 python-markdown-math-0.9 pyyaml-6.0.2 pyyaml-env-tag-1.1 requests-2.32.4 six-1.17.0 urllib3-2.5.0 watchdog-6.0.0
+N.B. must use `mkdocs-static-i18n` not `mkdocs-i18n` as in `pip install mkdocs mkdocs-material python-markdown-math mkdocs-static-i18n`

MDhelp/mkdocs.yml

@@ -26,25 +26,25 @@ theme:
   favicon: images/gsas2.png
   logo:    images/gsas2.png
 
-# plugins:
-#   - i18n:
-#       docs_structure: suffix
-#       languages:
-#         - locale: en
-#           default: true
-#           name: English
-#           build: true
-#         - locale: ja
-#           name: 日本語
-#           build: true
+plugins:
+  - i18n:
+      docs_structure: suffix
+      languages:
+        - locale: en
+          default: true
+          name: English
+          build: true
+#        - locale: ja
+#          name: 日本語
+#          build: true
 
 markdown_extensions:
   - def_list
   - admonition
   - mdx_math
 
 extra_javascript: 
-  - http://cdn.mathjax.org/mathjax/latest/MathJax.js?config=TeX-AMS-MML_HTMLorMML
+  - https://cdn.mathjax.org/mathjax/latest/MathJax.js?config=TeX-AMS-MML_HTMLorMML
 
 #local build settings from https://www.mkdocs.org/user-guide/deploying-your-docs/#local-files