fix(docs): Mkdocs javascript fixes. (#421)

* fix(docs): Add javascript missing in the docs build

* feat(docs): Check if UV is availsble to build docs

* fix(docs): try mkdocs graphviz fork

* fix(docs): try and fix javascript and abbreviation addons not being included in the docs

* fix(docs): Fix name of graphviz javascript file

* fix(docs): Addon Javascript now works properly.

* fix(docs): Update Dependencies

* fix(docs): Ignore mkdocs javascript files for spelling tests

* fix(docs): Again try and fix javascript mkdocs spell errors

Author: stevenj

.config/dictionaries/project.dic

@@ -7,6 +7,7 @@ camelcase
 canvaskit
 cardano
 Chromedriver
+chtml
 codegen
 colordiff
 cowsay
@@ -52,6 +53,7 @@ gosec
 graphviz
 idents
 ipynb
+javascripts
 JDBC
 jorm
 jormungandr
@@ -130,11 +132,11 @@ uniseg
 unshallow
 voteplan
 wasi
+wasip
 wasmtime
 webkitallowfullscreen
 WORKDIR
 xerrors
 xvfb
 zstd
 zstdcat
-wasip

cspell.json

@@ -55,6 +55,7 @@
         "**/**/go.sum",
         "**/**/pyproject.toml",
         "examples/flutter/example/**",
+        "earthly/docs/common/javascript/**"
     ],
     "flagWords": [
         "don;t: don't"

earthly/docs/Earthfile

@@ -56,7 +56,7 @@ deps:
 common:
     FROM scratch
 
-    COPY --dir common/includes common/macros common/overrides common/std-theme.yml /std
+    COPY --dir common/includes common/javascript common/macros common/overrides common/std-theme.yml /std
 
     SAVE ARTIFACT /std
 
@@ -98,6 +98,8 @@ BUILD:
 
     RUN /scripts/build.sh
 
+    RUN mv /docs/javascript/* /site/assets/javascripts
+
     SAVE ARTIFACT /site/*
 
 

earthly/docs/common/javascript/tex-mml-chtml.js

@@ -1,7 +1,7 @@
 # cspell: words Diagramsnet, pymdownx, linenums, inlinehilite, superfences,
 # cspell: words tasklist, betterem, materialx, twemoji, smartsymbols,
 # cspell: words kroki, excalidraw, glightbox, cips, pygments, arithmatex, fontawesome
-# cspell: words massillia, mathjax
+# cspell: words massilia, mathjax
 
 site_author: The Project Catalyst Team
 copyright: (c) 2023 Input Output Global Ltd.
@@ -117,7 +117,6 @@ extra:
       make our documentation better.
 
 extra_javascript:
-  - javascript/massillia-graphviz.js
-  - javascript/mathjax.js
-  - https://unpkg.com/mathjax@3/es5/tex-mml-chtml.js
-    
+  - assets/javascripts/massilia-graphviz.js
+  - assets/javascripts/mathjax.js
+  - assets/javascripts/tex-mml-chtml.js

earthly/docs/common/std-theme.yml

@@ -7,7 +7,7 @@ readme = "Readme.md"
 
 [tool.poetry.dependencies]
 python = "^3.13"
-mkdocs-material = { version = "^9.6.12", extras = ["recommended","git","imaging"] }
+mkdocs-material = { version = "9.6.16", extras = ["recommended","git","imaging"] }
 
 ### MkDocs Plugins we add.