[TASK] Switch Documentation Rendering to PHP

.editorconfig

@@ -23,3 +23,8 @@ trim_trailing_whitespace = true
 indent_style = space
 indent_size = 4
 max_line_length = 80
+
+# Makefile
+[{Makefile,**.mk}]
+# Use tabs for indentation (Makefiles require tabs)
+indent_style = tab

.github/workflows/test-documentation.yml

@@ -0,0 +1,17 @@
+name: test documentation
+
+on: [ push, pull_request ]
+
+jobs:
+  tests:
+    name: documentation
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Test if the documentation will render without warnings
+        run: |
+          mkdir -p Documentation-GENERATED-temp \
+          && docker run --rm --pull always -v $(pwd):/project \
+             ghcr.io/typo3-documentation/render-guides:latest --config=Documentation --no-progress --fail-on-log

.gitignore

@@ -1 +1,2 @@
 *GENERATED*
+/.idea

Documentation/CoreSupport/Tca/Index.rst

@@ -185,7 +185,7 @@ DataHandler commands for localization
 
 Localizing a record can be done by the
 :ref:`"localize" command <t3coreapi:tce-command-keywords>` of the
-:ref:`DataHandler <datahandler-basics>`. This is the command that is sent
+:ref:`DataHandler <t3coreapi:datahandler-basics>`. This is the command that is sent
 when you press the translate buttons in :guilabel:`Web > List` or
 :guilabel:`Web > Page` for an element.
 

Documentation/LocalizedContent/Index.rst

@@ -134,7 +134,7 @@ about the records in the default language at all.
 ..  tip::
     For more information on how to add languages and configure their
     behaviour in the site configuration, see
-    :ref:`Adding Languages <sitehandling-addinglanguages>`.
+    :ref:`Adding Languages <t3coreapi:sitehandling-addingLanguages>`.
 
 
 ..  _localized-content-all-language:
@@ -170,7 +170,7 @@ is valid for all languages.
 Localizing inline elements (IRRE)
 =================================
 
-When localizing a record with :ref:`inline elements (IRRE) <columns-inline>`,
+When localizing a record with :ref:`IRRE / inline <t3tca:columns-inline-introduction>`,
 the inline elements will be grayed out and not automatically localized. TYPO3
 will display two buttons to help you localize and keep the elements in
 sync.

Documentation/guides.xml

@@ -0,0 +1,33 @@
+<?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://docs.typo3.org/m/typo3/guide-frontendlocalization/main/en-us/"
+               project-contact="https://typo3.slack.com/archives/C028JEPJL"
+               project-repository="https://github.com/TYPO3-Documentation/TYPO3CMS-Guide-FrontendLocalization"
+               project-issues="https://github.com/TYPO3-Documentation/TYPO3CMS-Guide-FrontendLocalization/issues"
+               edit-on-github-branch="main"
+               edit-on-github="TYPO3-Documentation/TYPO3CMS-Guide-FrontendLocalization"
+               typo3-core-preferred="stable"
+               interlink-shortcode="typo3/guide-frontendlocalization"
+    />
+    <project title="Frontend Localization Guide"
+             release="main (development)"
+             version="main (development)"
+             copyright="since 2012 by the TYPO3 contributors"
+    />
+    <inventory id="t3coreapi"
+               url="https://docs.typo3.org/m/typo3/reference-coreapi/main/en-us/"
+    />
+    <inventory id="t3editors"
+               url="https://docs.typo3.org/m/typo3/tutorial-editors/main/en-us/"
+    />
+    <inventory id="t3tca"
+               url="https://docs.typo3.org/m/typo3/reference-tca/main/en-us/"
+    />
+    <inventory id="t3tsref"
+               url="https://docs.typo3.org/m/typo3/reference-typoscript/main/en-us/"
+    />
+</guides>

Makefile

@@ -0,0 +1,14 @@
+.PHONY: help
+help: ## Displays this list of targets with descriptions
+    @echo "The following commands are available:\n"
+    @grep -E '^[a-zA-Z0-9_-]+:.*?## .*$$' $(MAKEFILE_LIST) | sort | awk 'BEGIN {FS = ":.*?## "}; {printf "\033[32m%-30s\033[0m %s\n", $$1, $$2}'
+
+.PHONY: docs
+docs: ## Generate projects documentation (from "Documentation" directory)
+	mkdir -p Documentation-GENERATED-temp
+	docker run --rm --pull always -v "$(shell pwd)":/project -t ghcr.io/typo3-documentation/render-guides:latest --config=Documentation
+
+.PHONY: test-docs
+test-docs: ## Test the documentation rendering
+	mkdir -p Documentation-GENERATED-temp
+	docker run --rm --pull always -v "$(shell pwd)":/project -t ghcr.io/typo3-documentation/render-guides:latest --config=Documentation --no-progress --fail-on-log