Add external project sidebar stubs and redirect logic via sources.external.json

Author: CameronBrooks11

.github/workflows/pages.yml

@@ -36,6 +36,9 @@ jobs:
       - name: Import external docs
         run: bash scripts/import_sources.sh
 
+      - name: Generate external project stubs
+        run: python3 scripts/generate_external_redirects.py
+
       - name: Build with Jekyll
         run: bundle exec jekyll build --baseurl "${{ steps.pages.outputs.base_path }}"
         env:

projects/external.md

@@ -0,0 +1,10 @@
+---
+layout: page
+title: External Projects
+permalink: /projects/external/
+parent: Projects
+has_children: true
+nav_order: 2
+---
+
+The following external projects are rendered in their own GitHub Pages sites but are listed here for navigation purposes.

scripts/generate_external_redirects.py

@@ -0,0 +1,42 @@
+#!/usr/bin/env python3
+"""
+Generate redirect stub pages for external projects.
+Each page redirects to a GitHub Pages site and is nested under 'Projects > External Projects'.
+"""
+
+import json
+from pathlib import Path
+
+CONFIG = Path("sources.external.json")
+OUT_DIR = Path("docs/projects/external")
+
+
+def main():
+    with CONFIG.open("r", encoding="utf-8") as f:
+        data = json.load(f)
+
+    projects = data.get("external_projects", [])
+    OUT_DIR.mkdir(parents=True, exist_ok=True)
+
+    for i, proj in enumerate(projects, 1):
+        name = proj["name"]
+        title = proj.get("title", name)
+        url = proj["url"]
+        path = OUT_DIR / f"{name}.md"
+
+        content = f"""---
+layout: redirect
+title: {title}
+parent: External Projects
+grand_parent: Projects
+nav_order: {i}
+redirect_to: {url}
+---
+"""
+
+        path.write_text(content.strip() + "\n", encoding="utf-8")
+        print(f"✔ Generated redirect: {path}")
+
+
+if __name__ == "__main__":
+    main()

sources.external.json

@@ -0,0 +1,24 @@
+{
+    "external_projects": [
+        {
+            "name": "Slice_TEMP",
+            "title": "Slice TEMP",
+            "url": "/Slice_TEMP/"
+        },
+        {
+            "name": "Slice_DCMT",
+            "title": "Slice DCMT",
+            "url": "/Slice_DCMT/"
+        },
+        {
+            "name": "can-nano-shield",
+            "title": "CAN Nano Shield",
+            "url": "/can-nano-shield/"
+        },
+        {
+            "name": "can-nano-shield-fieldbus",
+            "title": "CAN Nano Fieldbus",
+            "url": "/can-nano-shield-fieldbus/"
+        }
+    ]
+}