Update website generator and container image tag helper scripts

docs/web/.gitignore

@@ -1,5 +1,5 @@
 # Output generated by `hugo`
 public/
 
-# Generated by update_docs.py, based the content in <repo-root>/docker/ and additional locations
+# Generated by update-docs.py, based on the content in <repo-root>/docker/ and additional locations
 src/content/

docs/web/Dockerfile

@@ -8,7 +8,7 @@ COPY docs/web/requirements.txt requirements.txt
 RUN pip install --no-cache-dir -r requirements.txt
 
 # Note: Add parameter for verbose output: --verbose
-RUN --mount=type=bind,ro,source=.,target=/repo python -m docs.web.update_docs --repository-path /repo --output-content-path /src/content
+RUN --mount=type=bind,ro,source=.,target=/repo /repo/docs/web/update-docs.py --repository-path /repo --output-content-path /src/content
 
 #####################################################################
 #                            Build Stage                            #

docs/web/README.md

@@ -5,7 +5,7 @@ A website is built with the [Hugo](https://gohugo.io/) static site generator, us
 
 ## Development
 
-**Build process:** The Markdown and Docker Compose files are collected and converted by `update_docs.py`, then `hugo` build is executed in a Docker container, producing a container image with `nginx` serving the static website.
+**Build process:** The Markdown and Docker Compose files are collected and converted by `update-docs.py`, then `hugo` build is executed in a Docker container, producing a container image with `nginx` serving the static website.
 
 Run `task docs:deploy` to build and locally deploy (using `docker/tools/homelab-docs.yaml`) the site.
 

docs/web/Taskfile.web.yaml

@@ -53,3 +53,8 @@ tasks:
     desc: Clear generated documentation content
     cmds:
       - rm -rf docs/web/public/
+
+  create-service-list:
+    desc: Create a YAML file describing the services
+    cmds:
+      - docs/web/export-services.py --output-file docs/services.yaml

docs/web/docker_scanner.py

@@ -4,7 +4,7 @@
 import os
 from pathlib import Path
 
-from .compose_processor import ComposeFileProcessor
+from compose_processor import ComposeFileProcessor
 
 
 class DockerComposeScanner:

docs/web/export_services.py → docs/web/export-services.py

@@ -9,9 +9,8 @@
 from pathlib import Path
 
 import yaml
-
-from .docker_scanner import DockerComposeScanner
-from .git_utils import get_git_root
+from docker_scanner import DockerComposeScanner
+from git_utils import get_git_root
 
 
 def str_presenter(dumper, data):
@@ -24,11 +23,11 @@ def str_presenter(dumper, data):
 
 
 def export_services(repository_path, output_file, docker_path="docker", verbose=False):
-    """Export all Docker Compose services to a YAML file.
+    """Export all Docker Compose services to a YAML file or stdout.
 
     Args:
         repository_path: Path to the repository root
-        output_file: Path to the output YAML file
+        output_file: Path to the output YAML file, or None for stdout
         docker_path: Relative path to docker directory (default: "docker")
         verbose: Enable verbose logging
     """
@@ -69,10 +68,20 @@ def export_services(repository_path, output_file, docker_path="docker", verbose=
 
         output_data["services"].append(service_data)
 
-    # Write to YAML file
-    logger.info(f"Writing {len(services)} services to {output_file}")
-    with open(output_file, "w") as f:
-        yaml.dump(output_data, f, width=math.inf, default_flow_style=False, sort_keys=False, allow_unicode=True, Dumper=yaml.Dumper)
+    # Write to YAML file or stdout
+    if output_file is not None:
+        logger.info(f"Writing {len(services)} services to {output_file}")
+        with open(output_file, "w") as stream:
+            yaml.dump(
+                output_data, stream, width=math.inf, default_flow_style=False,
+                sort_keys=False, allow_unicode=True, indent=2, Dumper=yaml.Dumper
+            )
+    else:
+        logger.info("Writing services to stdout")
+        yaml.dump(
+            output_data, sys.stdout, width=math.inf, default_flow_style=False,
+            sort_keys=False, allow_unicode=True, indent=2, Dumper=yaml.Dumper
+        )
 
     logger.info("Export complete")
 
@@ -90,7 +99,7 @@ def export_services(repository_path, output_file, docker_path="docker", verbose=
     parser.add_argument(
         "--output-file",
         type=str,
-        help="Specify the output YAML file path"
+        help="Specify the output YAML file path (defaults to stdout if omitted)"
     )
     parser.add_argument(
         "--docker-path",
@@ -103,8 +112,8 @@ def export_services(repository_path, output_file, docker_path="docker", verbose=
     # Get repository path
     repository_path = Path(args.repository_path) if args.repository_path else Path(get_git_root())
 
-    # Default output file if not specified
-    output_file = Path(args.output_file) if args.output_file else repository_path / "services.yaml"
+    # Default output to stdout if not specified
+    output_file = Path(args.output_file) if args.output_file else None
 
     # Export services
     try:

docs/web/update_docs.py → docs/web/update-docs.py

@@ -8,10 +8,9 @@
 from pathlib import Path
 
 import yaml
-
-from .docker_scanner import DockerComposeScanner
-from .git_utils import get_git_root
-from .link_processor import LinkProcessor
+from docker_scanner import DockerComposeScanner
+from git_utils import get_git_root
+from link_processor import LinkProcessor
 
 
 class DocsProcessor: