plantuml: Generate images manually so we are serving static data

.github/actions/spelling/expect.txt

@@ -605,6 +605,7 @@ pidof
 pids
 Piljk
 pki
+plantuml
 popafter
 postconf
 postfixadmin
@@ -631,6 +632,7 @@ proctitle
 proofpoint
 proxymap
 pubout
+puml
 putscript
 pvo
 pwcheck
@@ -825,6 +827,7 @@ toolarge
 transitioning
 Troost
 tscript
+tsvg
 TTLs
 tuxfamily
 typedef
@@ -838,6 +841,7 @@ UIDPLUS
 uids
 uidv
 uidvalidity
+UML
 unaccessed
 unaliased
 unauth

assets/plantuml/README.md

@@ -0,0 +1,30 @@
+# PlantUML Data
+
+This directory contains PlantUML files that are used to create diagrams for
+the documentation.
+
+## Docker
+
+[PlantUML](https://plantuml.com/) files are converted to SVG by using a Java
+program.
+
+It is easiest to run the program by using a pre-configured Docker container.
+
+The output command is as follows:
+
+```
+docker run --rm -v /path/to/your/puml/files:/data \
+  -v /path/to/your/output/directory:/output plantuml/plantuml \
+  -tsvg /data/your_diagram.puml \
+  -o /output
+```
+
+For example, if running from this directory to convert foo.puml, and storing
+the SVG file in the "docs/core/images" directory (so it can be referenced via
+Markdown from within VitePress), run:
+
+```
+mkdir -p ../../docs/core/images
+docker run --rm -v ./:/data -v ../../docs/core/images:/output \
+  plantuml/plantuml -tsvg /data/foo.puml -o /output
+```

docs/core/config/submission.md

@@ -84,7 +84,7 @@ service:
 
 ## Flow Diagram
 
-<!-- @include: @docs/core/config/include/submission_flow.inc -->
+![Submission Flow Diagram](/docs/core/config/images/submission_flow.svg)
 
 ## Configuration
 

lib/markdown.js

@@ -1,7 +1,6 @@
 import containerPlugin from 'markdown-it-container'
 import fg from 'fast-glob'
 import deflistPlugin from 'markdown-it-deflist'
-import { plantuml } from "@mdit/plugin-plantuml";
 import path from 'path'
 import { createMarkdownRenderer } from 'vitepress'
 import { dovecotSetting, frontmatterIter, loadData } from './utility.js'
@@ -18,7 +17,6 @@ export function dovecotMdExtend(md) {
 	})
 	md.use(deflistPlugin)
 	md.use(dovecot_markdown)
-	md.use(plantuml)
 
 	return md
 }

package.json

@@ -1,7 +1,6 @@
 {
   "name": "dovecot-ce-documentation",
   "devDependencies": {
-    "@mdit/plugin-plantuml": "^0.22.3",
     "@sindresorhus/slugify": "^2.2.1",
     "camelcase": "^8.0.0",
     "commander": "^13.1.0",