[FEAT] Live render

.ddev/web-build/Dockerfile.inotify

@@ -0,0 +1,7 @@
+ENV extension=inotify
+SHELL ["/bin/bash", "-c"]
+# Install the needed development packages
+RUN (apt-get update || true) && DEBIAN_FRONTEND=noninteractive apt-get install -y -o Dpkg::Options::="--force-confnew" --no-install-recommends --no-install-suggests build-essential php-pear php${DDEV_PHP_VERSION}-dev
+RUN pecl install ${extension}
+RUN echo "extension=${extension}.so" > /etc/php/${DDEV_PHP_VERSION}/mods-available/${extension}.ini && chmod 666 /etc/php/${DDEV_PHP_VERSION}/mods-available/${extension}.ini
+RUN phpenmod ${extension}

.dockerignore

@@ -5,4 +5,7 @@ tools/
 vendor/
 Dockerfile
 *.rst
-build
+.Build
+Documentation*
+.phpdoc
+.cache

.github/workflows/main.yaml

@@ -31,6 +31,7 @@ jobs:
         with:
           coverage: "none"
           php-version: "${{ matrix.php }}"
+          extensions: 'inotify, pcntl'
 
       - name: "Install dependencies with Composer"
         uses: "ramsey/composer-install@v2"
@@ -55,6 +56,7 @@ jobs:
         with:
           coverage: "none"
           php-version: "${{ env.DEFAULT_PHP_VERSION }}"
+          extensions: 'inotify, pcntl'
 
       - name: "Install dependencies with Composer"
         uses: "ramsey/composer-install@v2"
@@ -91,6 +93,7 @@ jobs:
         with:
           coverage: "none"
           php-version: "${{ env.DEFAULT_PHP_VERSION }}"
+          extensions: 'inotify, pcntl'
 
       - name: "Install dependencies with Composer"
         uses: "ramsey/composer-install@v2"

Dockerfile

@@ -1,4 +1,10 @@
-FROM composer:2 AS builder
+FROM php:8.1-cli-alpine AS builder
+
+COPY --from=ghcr.io/php/pie:bin /pie /usr/bin/pie
+COPY --from=composer:2 /usr/bin/composer /usr/bin/composer
+
+RUN apk add --update $PHPIZE_DEPS
+RUN pie install arnaud-lb/inotify && docker-php-ext-install pcntl
 
 WORKDIR /opt/guides
 COPY . /opt/guides
@@ -7,6 +13,13 @@ RUN composer install --no-dev --no-interaction --no-progress  \
     --no-suggest --optimize-autoloader --classmap-authoritative
 
 FROM php:8.1-cli-alpine
+
+COPY --from=ghcr.io/php/pie:bin /pie /usr/bin/pie
+RUN apk add --update $PHPIZE_DEPS
+RUN pie install arnaud-lb/inotify && docker-php-ext-install pcntl
+
+RUN apk del $PHPIZE_DEPS && rm -rf /var/cache/apk/* /tmp/* /usr/share/php/* /usr/local/lib/php/doc/* /usr/local/lib/php/test/*
+
 COPY . /opt/guides
 WORKDIR /opt/guides
 

README.rst

@@ -36,7 +36,7 @@ Usage with Docker (via custom container)
 
 Build the custom local Docker container::
 
-    docker build --file Dockerfile --tag typo3-docs:local .
+    make docker-build
 
 
 Execute the Docker container that is provided locally, build Documentation

composer.json

@@ -9,6 +9,7 @@
         "ext-libxml": "*",
         "brotkrueml/twig-codehighlight": "^1.0",
         "league/flysystem": "^1.1.10",
+        "phpdocumentor/dev-server": "^1.9",
         "phpdocumentor/filesystem": "^1.9",
         "phpdocumentor/guides": "^1.9",
         "phpdocumentor/guides-cli": "^1.9",
@@ -17,9 +18,11 @@
         "phpdocumentor/guides-restructured-text": "^1.9",
         "phpdocumentor/guides-theme-bootstrap": "^1.7",
         "phpdocumentor/guides-theme-rst": "^1.7",
+        "psr/http-message": "^1.1",
         "symfony/clock": "^6.4",
         "symfony/finder": "^6.4",
         "symfony/http-client": "^6.4",
+        "symfony/polyfill-php84": "^1.33",
         "symfony/yaml": "^6.4",
         "t3docs/console-command": "^0.2.0",
         "t3docs/guides-php-domain": "^1.0",