Updated build process

Author: Toflar

.github/workflows/build_and_deploy.yaml

@@ -20,8 +20,14 @@ jobs:
               with:
                   hugo-version: '0.120.4'
 
+            - name: Setup PHP
+              uses: shivammathur/setup-php@v2
+              with:
+                  php-version: 8.2
+                  coverage: none
+
             - name: Build all books
-              run: make build
+              run: ./book build-all
 
             - name: Deploy
               uses: appleboy/scp-action@master

Makefile

@@ -24,26 +24,18 @@ The documentation is built using the [Hugo site generator](https://gohugo.io/),
 thus you need to [install Hugo](https://gohugo.io/getting-started/installing/) 
 first on your system.
 
-Building is done using the `make` command. There are different commands available 
+Building is done using a PHP file. There are different commands available 
 depending on what part of the documentation you want to build.
 
 ```
-make build-dev
-make build-manual
+./book build-<book>
 ```
 
 Builds the entire documentation into the `build` directory.
 
 ```
-make live-dev
-make live-manual
+./book live-<book>
 ```
 
 Spins up the development server which automatically tracks changes in the `docs` 
-directory and rebuilds the front end. You can access the front end on [http://localhost:1313](http://localhost:1313).
-
-```
-make clean
-```
-
-Cleans the build directory.
+directory and rebuilds the front end. You can access the front end on [http://localhost:1313](http://localhost:1313).

README.md

@@ -0,0 +1,70 @@
+#!/usr/bin/env php
+<?php
+
+$books = $folders = array_map(function($dir) {
+    return basename($dir);
+}, glob(__DIR__ . '/docs/*', GLOB_ONLYDIR));
+
+$commands = ['build-all'];
+
+foreach ($books as $book) {
+    $commands[] = 'build-' . $book;
+    $commands[] = 'live-' . $book;
+}
+
+$command = $_SERVER['argv'][1] ?? '';
+
+if (!in_array($command, $commands, true)) {
+    echo 'Must run one of the following commands:' . "\n- " . implode("\n- ", $commands);
+    exit(1);
+}
+
+$runCommand = function (string $command) {
+    echo $command . "\n";
+    echo system($command);
+};
+
+$buildBook = function(string $book) use ($runCommand) {
+    $command = <<<COMMAND
+cd page; hugo \
+    --cleanDestinationDir \
+    --environment {book} \
+    --destination ../build/{book} \
+    --logLevel info \
+    --baseURL https://extensions.terminal42.ch/docs/{book}/
+COMMAND;
+
+    $runCommand(str_replace('{book}', $book, $command));
+};
+
+
+$liveBook = function(string $book) use ($runCommand) {
+    $command = <<<COMMAND
+cd page; hugo server \
+    --cleanDestinationDir \
+    --environment {book} \
+    --destination ../build/{book} \
+    --logLevel info
+COMMAND;
+
+    $runCommand(str_replace('{book}', $book, $command));
+};
+
+preg_match('/^(build|live)-(.*)/', $command, $matches);
+
+if ('build-all' === $matches[0]) {
+    foreach ($books as $book) {
+        $buildBook($book);
+    }
+    return;
+}
+
+if ('build' === $matches[1]) {
+    $buildBook($matches[2]);
+    return;
+}
+
+if ('live' === $matches[1]) {
+    $liveBook($matches[2]);
+    return;
+}

book

@@ -71,5 +71,4 @@ auth.json zu kopieren. Weitere Informationen findest du im [Handbuch von Compose
 
 {{% /tab %}}
 
-{{< /tabs >}}
-
+{{< /tabs >}}