Files
build_webstatic/.hermes/skills.md
T
2026-07-11 13:43:52 +02:00

1.2 KiB

GCBoK.WebStaticBuilder — Agent Skills

Quelle der Wahrheit für Agenten-Kollaboration an diesem Tool.

Was das Tool ist

Eigenständiger Static-Site-Generator (C#/.NET 10, Assembly webstatic), MIT. Kein Python. Suchindex via npx pagefind (optional). Früher Submodul der GCBoK-Website (www/build), jetzt unter /opt/GitCover/webstatic.

Kanonischer Build/Verify

dotnet build -c Release
dotnet bin/Release/net10.0/webstatic.dll build --env work --verbose
dotnet bin/Release/net10.0/webstatic.dll serve --port 8000

Konventionen

  • Namespace GCBoK.WebStaticBuilder; Program.cs braucht using GCBoK.WebStaticBuilder;.
  • Package-Versionen explizit pinnen; <ManagePackageVersionsCentrally>false</ManagePackageVersionsCentrally> gesetzt.
  • Pfade generisch über Directories + BuildConfig.Paths (nie www/ hartkodieren).
  • i18n via {{ i18n.* }} + i18n.json (Fallback EN).
  • Config-Priorität: CLI > webstatic.json > Defaults.

Bekannte Fallstricke

  • NU1015 → Version pinnen. CS0103 in Program.cs → using. CS8361 → Ternär in Klammern.
  • BuildSectionsHtml gibt string zurück (nicht StringBuilder) für .Replace.

Struktur

plans/ docs/ diary/ src/ tests/ webstatic.example/ install.sh LICENSE