[TASK] [WIP] Add docker implementation

Some issues remain with render-guides, made a PR for that:

phpDocumentor/guides#817

Author: garvinhicking

.dockerignore

@@ -0,0 +1,29 @@
+**/.classpath
+**/.dockerignore
+**/.env
+**/.git
+**/.gitignore
+**/.project
+**/.settings
+**/.toolstarget
+**/.vs
+**/.vscode
+**/.next
+**/.cache
+**/*.*proj.user
+**/*.dbmdl
+**/*.jfm
+**/charts
+**/docker-compose*
+**/Dockerfile*
+**/node_modules
+**/npm-debug.log
+**/obj
+**/secrets.dev.yaml
+**/values.dev.yaml
+**/build
+**/dist
+**/Input
+**/Output
+**/Documentation
+**/Documentation-GENERATED-temp

Dockerfile

@@ -0,0 +1,45 @@
+# syntax=docker/dockerfile:1
+ARG NODE_VERSION=20
+ARG NODE_PORT=5173
+ARG MAIN_WORKDIR=/project
+
+FROM composer:2 as Builder
+
+WORKDIR /opt/guides
+COPY composer.* /opt/guides
+
+RUN composer install --no-interaction --no-progress  \
+    --optimize-autoloader --classmap-authoritative
+
+
+FROM node:${NODE_VERSION}-alpine
+
+# Use production node environment by default.
+ENV NODE_ENV production
+
+RUN apk add php82-cli php82-phar php82-dom php82-fileinfo --no-cache
+
+WORKDIR ${MAIN_WORKDIR}
+
+COPY --from=Builder /opt/guides /opt/guides
+
+# Download dependencies as a separate step to take advantage of Docker's caching.
+# Leverage a cache mount to /root/.npm to speed up subsequent builds.
+# Leverage a bind mounts to package.json and package-lock.json to avoid having to copy them into
+# into this layer.
+RUN --mount=type=bind,source=package.json,target=package.json \
+    --mount=type=bind,source=package-lock.json,target=package-lock.json \
+    --mount=type=cache,target=/root/.npm \
+    npm ci --omit=dev
+
+# Run the application as a non-root user.
+# USER node
+
+# Copy the rest of the source files into the image.
+COPY . .
+
+# Expose the port that the application listens on.
+EXPOSE ${NODE_PORT}
+
+# Run the application.
+CMD npm run dev

Makefile

@@ -0,0 +1,21 @@
+.PHONY: docker-build
+docker-build: ## Build docker image 'typo3-documentation-browsersync:local' for local debugging
+	docker build -t typo3-documentation-browsersync:local .
+    #docker composer up --build
+
+.PHONY: docker-enter
+docker-enter: ## Enter a locally build image
+	docker run -it --entrypoint=sh --rm \
+           -v "./Input:/project/Documentation" \
+           -v "./Output:/project/Documentation-GENERATED-temp" \
+           typo3-documentation-browsersync:local
+
+.PHONY: render-docs
+render-docs: ## Render Documentation using typo3-documentation/render-guides
+	docker run --rm --pull always \
+	       -v "./Input:/project/Documentation" \
+	       -v "./Output:/project/Documentation-GENERATED-temp" \
+           ghcr.io/typo3-documentation/render-guides:latest  --no-progress Documentation
+
+# Within the container:
+# docker run --rm --pull always -v "./Documentation:/project/Documentation" -v "./Documentation-GENERATED-temp:/project/Documentation-GENERATED-temp" ghcr.io/typo3-documentation/render-guides:latest --no-progress Documentation

compose.yaml

@@ -0,0 +1,11 @@
+services:
+  server:
+    build:
+      context: .
+    environment:
+      NODE_ENV: production
+    ports:
+      - "${HOST_PORT:-5173}:${CONTAINER_PORT:-5173}"
+    environment:
+      - HOST_PORT
+      - CONTAINER_PORT

composer.json

@@ -3,8 +3,19 @@
     "description": "Standalone project (NodeJS, browsersync) to render and hot-reload changes in ReST documentation to your browser window",
     "license": "MIT",
     "require": {
-        "php": "^8.1"
+        "php": "^8.2",
+        "t3docs/render-guides": "dev-main"
     },
+    "repositories": [
+        {
+            "type": "vcs",
+            "url": "https://github.com/TYPO3-Documentation/render-guides"
+        },
+        {
+            "type": "vcs",
+            "url": "https://github.com/brotkrueml/twig-codehighlight"
+        }
+    ],
     "require-dev": {
         "phpstan/phpstan": "^1.10",
         "symfony/console": "^6.4",