SHA256
30 lines
1.2 KiB
Markdown
30 lines
1.2 KiB
Markdown
# 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
|