[TASK] Improve missing guide handling in CI (#36)

Now adds a "create" link to all missing guide links and sets all missing links as italic text.

Also fixes a missing user/group setting in a Makefile command.

Author: mabolek

Makefile

@@ -36,7 +36,7 @@ generate-tos: ## Generates table of contents in all Index.md files
 
 .PHONY: expand-tags
 expand-tags: ## Expands tags into Markdown
-	docker run --rm -v "$(shell pwd)":/app php:8.3-cli php app/bin/expand-tags
+	docker run --user $(shell id -u):$(shell id -g) --rm -v "$(shell pwd)":/app php:8.3-cli php app/bin/expand-tags
 
 .PHONY: prepare-docs ## Prepares files for rendering: Backing up, generating TOS, expanding tags, etc.
 prepare-docs: stage-docs index-files expand-links generate-tos expand-tags

bin/expand-links

@@ -32,6 +32,22 @@ foreach ($filesAndLinks['files'] as $file) {
                 . '(' . $link['toFile']
                 . ($link['titleAttribute'] ? ' "' . $link['titleAttribute'] . '"' : '')
                 . ')';
+        } elseif (
+            !str_starts_with($file['path'], '/00Incoming/')
+            && !str_starts_with($file['path'], '/80GuidesRegistry/')
+            && !str_starts_with($file['path'], '/90Contribute/')
+        ) {
+            $fileName = preg_replace(
+                '/[^A-Za-z0-9]/',
+                '',
+                iconv(
+                        'UTF-8',
+                        'ASCII//TRANSLIT',
+                        ucwords($link['linkText'])
+                )
+            ) . '.md';
+
+            $replaceLinkString = '*' . $link['linkText'] . '* [(CREATE)]' . '(' . newGuideUrl($fileName) . ' "Create this missing step-by-step guide")';
         }
 
         $fileContents = str_replace(
@@ -44,4 +60,10 @@ foreach ($filesAndLinks['files'] as $file) {
     if ($changedLinks > 0) {
         file_put_contents(SEARCH_PATH . $file['path'], $fileContents);
     }
-}
+}
+
+function newGuideUrl(string $fileName = 'GiveYourGuideAName.md') {
+    return 'https://github.com/TYPO3-Documentation/TYPO3CMS-Guide-StepByStep/new/contrib/Documentation/00Incoming?'
+            . 'filename=' . rawurlencode(basename($fileName))
+            . '&value=' . rawurlencode('Copy content the template from: https://raw.githubusercontent.com/TYPO3-Documentation/TYPO3CMS-Guide-StepByStep/refs/heads/contrib/Documentation/90Contribute/10Template/Index.md');
+}

bin/generate-tos

@@ -74,7 +74,7 @@ foreach ($filesAndLinks['links'] as $link) {
 
     $mentionedUris[] = $link['uri'];
 
-    $output .= '* ' . ($link['linkText'] ?? basename($link['uri'])) . ' [CREATE](' . newGuideUrl(basename($link['uri'])) . ')' . PHP_EOL;
+    $output .= '* ' . ($link['linkText'] ?? basename($link['uri'])) . ' [CREATE](' . newGuideUrl(basename($link['uri'])) . ' "Create this missing step-by-step guide")' . PHP_EOL;
 }
 
 file_put_contents(SEARCH_PATH . '/80GuidesRegistry/Index.md', $output);

bin/index-files

@@ -18,7 +18,6 @@ $allLinks = [];
 
 foreach ($files as $fullFilePath) {
     $file = str_replace(SEARCH_PATH, '', $fullFilePath);
-
     $allFiles[$file] = [
         'title' => null,
         'path' => $file,