[TASK] Migrate to PHP-based documentation rendering

.github/workflows/cgl.yaml

@@ -54,3 +54,9 @@ jobs:
       # Migration
       - name: Run Rector migration
         run: composer migration:rector -- --dry-run
+
+      # Documentation
+      - name: Check documentation build
+        run: |
+          mkdir -p .Build/docs
+          composer docs:build -- --no-progress --fail-on-log

Documentation/guides.xml

@@ -0,0 +1,16 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<guides xmlns="https://www.phpdoc.org/guides" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+        xsi:schemaLocation="https://www.phpdoc.org/guides ../vendor/phpdocumentor/guides-cli/resources/schema/guides.xsd"
+        links-are-relative="true"
+>
+    <extension class="\T3Docs\Typo3DocsTheme\DependencyInjection\Typo3DocsThemeExtension"
+               project-home="https://extensions.typo3.org/extension/handlebars"
+               project-contact="https://typo3.slack.com/archives/C0281DBRFCZ"
+               project-repository="https://github.com/CPS-IT/handlebars"
+               project-issues="https://github.com/CPS-IT/handlebars/issues" edit-on-github-branch="main"
+               edit-on-github="CPS-IT/handlebars" typo3-core-preferred="stable"
+    />
+    <project title="Handlebars" release="0.7.26" copyright="since 2020 by coding. powerful. systems. CPS GmbH"/>
+    <inventory id="t3coreapi" url="https://docs.typo3.org/m/typo3/reference-coreapi/main/en-us/"/>
+    <inventory id="t3tsref" url="https://docs.typo3.org/m/typo3/reference-typoscript/main/en-us/"/>
+</guides>

composer.json

@@ -102,9 +102,9 @@
 			"@docs:build",
 			"@docs:open"
 		],
-		"docs:build": "docker-compose run --rm docs",
+		"docs:build": "docker compose run --rm docs",
 		"docs:cleanup": "rm -rf .Build/docs",
-		"docs:open": "open .Build/docs/Result/project/0.0.0/Index.html",
+		"docs:open": "open .Build/docs/Index.html",
 		"fix": [
 			"@fix:composer",
 			"@fix:editorconfig",

docker-compose.yml

@@ -1,9 +1,8 @@
-version: '3.6'
-
 services:
   docs:
-    image: ghcr.io/t3docs/render-documentation:develop
-    command: makehtml
+    image: ghcr.io/typo3-documentation/render-guides
+    entrypoint: ['/opt/guides/entrypoint.sh', '--config', 'Documentation', '--output', '/result']
+    pull_policy: always
     volumes:
-      - .:/PROJECT:ro
-      - .Build/docs:/RESULT
+      - .:/project:ro
+      - .Build/docs:/result

version-bumper.yaml

@@ -1,9 +1,6 @@
 presets:
   - typo3-commit-guidelines
-  - name: typo3-extension
-    options:
-      # @todo Migrate to PHP-based documentation rendering
-      documentation: legacy
+  - typo3-extension
 
 releaseOptions:
   commitMessage: '[RELEASE] Release of EXT:handlebars {%version%}'