Add KERN landing page, references, and link checking workflows

.github/workflows/links.yml

@@ -0,0 +1,32 @@
+name: Dead links
+
+on:
+  push:
+    branches: [main]
+  schedule:
+    - cron: '0 8 * * 1'   # every Monday 08:00 UTC
+
+jobs:
+  lychee:
+    name: Link check
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Check links
+        uses: lycheeverse/lychee-action@v2
+        with:
+          args: >
+            --config .lychee.toml
+            '**/*.html'
+          fail: true
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Create issue on scheduled failure
+        if: failure() && github.event_name == 'schedule'
+        uses: peter-evans/create-issue-from-file@v5
+        with:
+          title: 'Dead links detected'
+          content-filepath: ./lychee/out.md
+          labels: bug, content

.github/workflows/qa.yml

@@ -0,0 +1,130 @@
+name: QA
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+
+  # ── 0. Build freshness ──────────────────────────────────────────────────────
+  build-fresh:
+    name: Build freshness check
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - name: Install dependencies
+        run: pip install -r requirements.txt
+      - name: Check generated files match templates
+        run: python3 build.py --check
+
+  # ── 1. Typos ────────────────────────────────────────────────────────────────
+  typos:
+    name: Typo check
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: crate-ci/typos@v1
+
+  # ── 2. German spelling ─────────────────────────────────────────────────────
+  cspell-de:
+    name: German pages spelling
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+      - name: Spell-check German pages
+        run: |
+          npx --yes \
+            -p cspell \
+            -p @cspell/dict-de-de \
+            -p @cspell/dict-de-at \
+            cspell lint --config cspell.de.json
+
+  # ── 3. English spelling ────────────────────────────────────────────────────
+  cspell-en:
+    name: English pages spelling
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+      - name: Spell-check English pages
+        run: |
+          npx --yes \
+            -p cspell \
+            cspell lint --config cspell.en.json
+
+  # ── 4. HTML validity ────────────────────────────────────────────────────────
+  html:
+    name: HTML validation
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+      - run: npm install -g html-validate
+      - name: Validate HTML
+        run: |
+          html-validate \
+            index.html \
+            kern/ \
+            technology/ \
+            references/ \
+            includes/nav.html \
+            includes/footer.html
+
+  # ── 5. Meta descriptions ────────────────────────────────────────────────────
+  meta:
+    name: Meta descriptions
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - name: Every KERN page must have a meta description
+        run: |
+          missing=0
+          while IFS= read -r file; do
+            if ! grep -qi '<meta name="description"' "$file"; then
+              echo "::error file=$file::Missing meta description"
+              missing=$((missing + 1))
+            fi
+          done < <(find index.html kern/ technology/ references/ -name "*.html")
+
+          if [ "$missing" -gt 0 ]; then
+            echo "::error::$missing page(s) missing <meta name=\"description\">"
+            exit 1
+          fi
+          echo "All KERN pages have meta descriptions ✓"
+
+  # ── 6. Image size budget ────────────────────────────────────────────────────
+  images:
+    name: Image size budget
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - name: Warn on images > 500 KB
+        run: |
+          limit=$((500 * 1024))
+          oversized=0
+          while IFS= read -r img; do
+            size=$(stat -c%s "$img")
+            if [ "$size" -gt "$limit" ]; then
+              kb=$((size / 1024))
+              echo "::warning file=$img::${kb} KB — consider compressing (budget: 500 KB)"
+              oversized=$((oversized + 1))
+            fi
+          done < <(find images/ -type f \( \
+            -iname "*.jpg" -o -iname "*.jpeg" \
+            -o -iname "*.png" -o -iname "*.gif" \
+            -o -iname "*.webp" \))
+
+          if [ "$oversized" -gt 0 ]; then
+            echo "$oversized image(s) over budget — see warnings above"
+          else
+            echo "All images within 500 KB budget ✓"
+          fi

.gitignore

@@ -1 +1,24 @@
-new/node_modules
+new/node_modules
+.venv
+__pycache__
+*.pyc
+*.pyo
+*.pyd
+*.db
+*.sqlite3
+*.log
+*.env
+*.DS_Store
+.idea
+.vscode
+*.swp
+*.swo
+*.bak
+*.tmp
+*.egg-info
+dist
+build
+*.egg
+*.egg-info
+*.egg-info/
+*.egg-info/*

.htmlvalidate.json

@@ -0,0 +1,19 @@
+{
+  "extends": ["html-validate:recommended"],
+  "rules": {
+    "attr-quotes": "error",
+    "no-dup-attr": "error",
+    "no-dup-id": "error",
+
+    "no-inline-style": "off",
+    "require-sri": "off",
+    "void-style": "off",
+    "no-trailing-whitespace": "off",
+    "long-title": "off",
+    "tel-non-breaking": "off",
+    "script-type": "off",
+    "no-unknown-elements": "off"
+  },
+  "elements": ["html5"],
+  "transform": {}
+}

.lychee.toml

@@ -0,0 +1,39 @@
+# Lychee link checker configuration
+# Docs: https://lychee.cli.rs/usage/configuration/
+
+timeout        = 20
+max_retries    = 3
+retry_wait_time = 3
+threads        = 8
+
+# 429 = Too Many Requests (rate-limited, not a dead link)
+accept = ["200..=299", "429"]
+
+exclude_loopback = true
+include_mail     = false
+
+exclude = [
+  # JavaScript pseudo-links
+  "^javascript:",
+  "^#$",
+
+  # Google services — blocked in CI environments
+  "googletagmanager\\.com",
+  "googleapis\\.com",
+  "google\\.com/maps",
+  "google\\.com/recaptcha",
+
+  # Social platforms — aggressively rate-limit CI IPs
+  "linkedin\\.com",
+  "twitter\\.com",
+  "x\\.com",
+  "instagram\\.com",
+  "facebook\\.com",
+
+  # Localhost and staging
+  "localhost",
+  "127\\.0\\.0\\.1",
+]
+
+# Output dead links to a file so the scheduled issue workflow can attach it
+output = "lychee/out.md"

.typos.toml

@@ -0,0 +1,55 @@
+[files]
+extend-exclude = [
+  # Binary / generated / legacy directories
+  "images/**",
+  "archive/**",
+  "slides/**",
+  "ttf/**",
+  "csv/**",
+  "data/**",
+  "showcase/**",
+  "media/**",
+  "news/**",
+  # German content pages are checked by cspell-de
+  "de/**/*.html",
+  "locales/de.yaml",
+  # Old Webflow CSS/JS
+  "company/css/**",
+  "company/js/**",
+  # Backup files
+  "*.bak",
+  "*.min.js",
+]
+
+[default.extend-words]
+# Energy sector protocols and standards
+MIOTY    = "MIOTY"
+EEBUS    = "EEBUS"
+SunSpec  = "SunSpec"
+aFRR     = "aFRR"
+FCR      = "FCR"
+SCADA    = "SCADA"
+OCPP     = "OCPP"
+BESS     = "BESS"
+HEMS     = "HEMS"
+
+# Austrian / German regulatory terms
+EnFG     = "EnFG"
+EAG      = "EAG"
+
+# Brands and product names
+KERN     = "KERN"
+Lumenaza = "Lumenaza"
+cybergrid = "cybergrid"
+VERBUND  = "VERBUND"
+TTTech   = "TTTech"
+joulie   = "joulie"
+egon     = "egon"
+
+# Place names
+Heiligenkreuz = "Heiligenkreuz"
+Wetzlas       = "Wetzlas"
+Steiermark    = "Steiermark"
+
+# German words used in content
+Stadtwerke    = "Stadtwerke"

404.html

@@ -14,8 +14,8 @@
     }
 
     :root {
-      --primary-green: #00ff88;
-      --dark-bg: #0a0a0a;
+      --primary-green: #F59E0B;
+      --dark-bg: #1C2333;
       --text-primary: #ffffff;
       --text-secondary: #e0e0e0;
       --text-muted: #999999;
@@ -49,10 +49,10 @@
 
     @keyframes glow {
       0%, 100% {
-        text-shadow: 0 0 20px rgba(0, 255, 136, 0.5);
+        text-shadow: 0 0 20px rgba(245, 158, 11, 0.5);
       }
       50% {
-        text-shadow: 0 0 40px rgba(0, 255, 136, 0.8);
+        text-shadow: 0 0 40px rgba(245, 158, 11, 0.8);
       }
     }