Update plantuml JAR - Fix ability to use hexagon in plantuml diagrams

Dockerfile

@@ -62,7 +62,6 @@ RUN export DEBIAN_FRONTEND="noninteractive" \
     && rm -rf /var/lib/apt/lists/* \
     && mkdir -p /docs-package/pdf /app /docs-src/book /docs-src/templates /docs-src/features
 
-
 COPY ./composer.json \
     ./composer.lock \
     ./package.json \
@@ -72,6 +71,8 @@ COPY ./composer.json \
 COPY ./src /app/src
 COPY ./bin /app/bin
 
+ADD https://github.com/plantuml/plantuml/releases/download/v1.2022.2/plantuml-1.2022.2.jar /app/bin/plantuml.jar
+
 COPY --from=production-dependencies /usr/bin/composer /usr/local/bin/composer
 COPY --from=npm-dependencies /app/node_modules /app/node_modules
 

Makefile

@@ -0,0 +1,19 @@
+.PHONY: *
+
+CLEAR_CONFIG_CACHE=rm -f storage/app/vars/*
+OPTS=
+
+help:
+	@grep -E '^[a-zA-Z_-]+:.*?## .*$$' $(MAKEFILE_LIST) | sort | awk 'BEGIN {FS = ":.*?## "}; {printf "\033[36m%-30s\033[0m %s\n", $$1, $$2}'
+
+build: ## Builds the development image needed to run tests etc.
+	docker buildx build --load --target=development --tag=test-image .
+
+test: build ## Run the unit and integration tests
+	docker run --rm --entrypoint=php test-image vendor/bin/phpunit
+
+cs: build ## Run coding standards checks
+	docker run --rm --entrypoint=php test-image vendor/bin/phpcs
+
+static-analysis: build ## Run the static analysis checks
+	docker run --rm --entrypoint=php test-image vendor/bin/psalm

src/Formatter/RenderPlantUmlDiagramInline.php

@@ -24,6 +24,7 @@
 
 final class RenderPlantUmlDiagramInline implements PageFormatter
 {
+    /** Note: this is added by the `Dockerfile` build, it no longer exists in the repo itself */
     private const PLANTUML_JAR = __DIR__ . '/../../bin/plantuml.jar';
 
     /** @throws RuntimeException */

test/fixture/docbook/test.md

@@ -33,5 +33,6 @@ Links [here](https://www.google.com). **Bold**, _italic_, ~~strikethrough~~, `in
 ```puml
 @startuml
 Bob->Alice : hello
+hexagon TestingHexagon
 @enduml
 ```