# Automatisierung Webexport aus docs

## Ausgangslage

Der Webexport soll nicht mehr mehrere manuell gepflegte Dokumentlisten enthalten.

Die zentrale Markdown-Dokumentliste `docs` in `_AUSWERTUNG/06_Webseite/script.js` ist kuenftig die einzige Quelle fuer die Markdown-Dokumentverwaltung im Webexport.

## Umgesetzte Automatisierung

Aus `docs` werden automatisch erzeugt oder aufgebaut:

- Navigation im Webexport
- Startseitenuebersicht
- Dokumentindex fuer die Startseite
- `sitemap.xml`
- `search.json`

Zusaetzlich werden aus dem vorhandenen Dateibestand automatisch erzeugt:

- PDF-Index aus `_AUSWERTUNG/06_Webseite/docs/`
- Excel-Index aus `_AUSWERTUNG/06_Webseite/excel/`
- `robots.txt` mit Verweis auf `https://grunst.net/sewobe/sitemap.xml`

## Generator

Der Generator liegt unter:

`_AUSWERTUNG/06_Webseite/generate_webexport.js`

Ausfuehrung:

```bash
cd _AUSWERTUNG/06_Webseite
node generate_webexport.js
```

Der Generator liest `docs` und `PROJECTS` direkt aus `script.js`. Dadurch entsteht keine zweite Markdown-Dokumentliste.

## Bewertung weiterer Bestandteile

`search.json` kann vollstaendig aus `docs` und den Markdown-Dateien erzeugt werden. Es enthaelt Projekt, Titel, Dateipfad, URL und Kurztext je Dokument.

Die Startseitenuebersicht kann vollstaendig aus `docs` aufgebaut werden. Manuelle Linklisten auf Markdown-Dokumente sind nicht mehr erforderlich.

Der Dokumentindex kann vollstaendig aus `docs` aufgebaut werden.

Der PDF-Index kann nicht sinnvoll aus `docs` abgeleitet werden, weil PDF-Unterlagen keine Markdown-Dokumente sind. Er wird daher aus dem Ordner `docs/` erzeugt.

Der Excel-Index kann nicht sinnvoll aus `docs` abgeleitet werden, weil Excel-Unterlagen keine Markdown-Dokumente sind. Er wird daher aus dem Ordner `excel/` erzeugt.

`robots.txt` wird erzeugt und verweist auf die automatisch erzeugte Sitemap.

`sitemap.xml` wird vollstaendig aus `docs` erzeugt. Aufgenommen werden die Startseite `https://grunst.net/sewobe/` sowie alle Markdown-Dokumente unter `https://grunst.net/sewobe/md/<Dateiname>`.

## Projektstandard

Nach jeder fachlichen oder technischen Aenderung unter `_AUSWERTUNG/` muessen fachliche Quelle und Webexport synchronisiert werden.

Ein Arbeitsauftrag gilt erst als abgeschlossen, wenn Markdown, `docs`, Navigation, Startseite, `sitemap.xml`, `search.json`, PDF-/Excel-Index, `robots.txt`, `README_Webexport.md` und `AGENTS.md` geprueft und bei Bedarf aktualisiert wurden.