---
name: bookstack-upload
description: 'Lädt freigegebene Vault-Notizen (Tag #review-done) aus dem Ordner /Bookstack über die BookStack-API hoch — legt Seiten an oder aktualisiert sie, löst Regal/Buch/Kapitel aus dem Frontmatter auf und fragt nach, wenn die Zuordnung fehlt. Nutze diesen Skill, wenn von BookStack-Upload, Wiki-Upload, „hochladen nach Bookstack", „Doku veröffentlichen" oder vom Verarbeiten des /Bookstack-Ordners die Rede ist.'
---

# BookStack-Upload

Spielt freigegebene Dokumentation aus dem Vault in die BookStack-Instanz.

## Voraussetzungen prüfen

Setze `BOOKSTACK_URL`, `BOOKSTACK_TOKEN_ID` und `BOOKSTACK_TOKEN_SECRET` voraus. Sind sie
nicht gesetzt, meldet das Skript das verständlich — gib die Meldung weiter und brich ab.
Frage niemals nach dem Token und schreibe ihn nirgends hin.

## Ablauf

1. **Immer zuerst der Probelauf.** Ohne `--anwenden` schreibt nichts:

   ```
   python -m bookstack.hochladen
   ```

   Arbeitsverzeichnis: `D:\Claude\Code Projekte\active - Bookstack Upload\skill\scripts`

2. **Bericht lesen.** Er listet je Notiz ANLEGEN, AKTUALISIEREN, ÜBERSPRUNGEN oder FEHLER.

3. **Fehlende Zuordnung klären.** Meldet der Bericht für eine Notiz, dass Buch oder
   Kapitel nicht existiert oder `bookstack_book` fehlt:

   - Vorhandene Struktur zeigen: `python -m bookstack.hochladen --baum`
   - Dem Anwender die Regale und Bücher aus dieser Ausgabe zur Auswahl stellen und
     fragen, wo die Notiz landen soll. Nicht raten.
   - Die Antwort ins Frontmatter der Notiz schreiben (`bookstack_shelf`,
     `bookstack_book`, `bookstack_chapter`).
   - Soll etwas Neues angelegt werden, den Anwender das ausdrücklich bestätigen lassen
     und dann `--struktur-anlegen` ergänzen.

4. **Bericht vorlegen und Freigabe einholen.** Erst nach ausdrücklichem „ja" schreiben:

   ```
   python -m bookstack.hochladen --anwenden
   ```

5. **Ergebnis melden.** Was wurde angelegt, was aktualisiert, was übersprungen. Hinweise
   zu nicht übertragenen Bildern und nicht auflösbaren Wikilinks (offene Verweise)
   weitergeben.

## Grenzen

- `--anwenden` niemals ungefragt ausführen. Der Upload ist nach außen sichtbar.
- Notizen mit offenem `#review` werden bewusst übersprungen. Nicht umgehen.
- Bilder werden in die BookStack-Bildergalerie hochgeladen und eingebunden. Nicht
  gefundene oder abgelehnte Bilder erscheinen als Hinweis im Bericht.
- Wikilinks auf bereits hochgeladene Notizen werden zu echten Seitenlinks. Verweise auf
  noch nicht hochgeladene Notizen bleiben Klartext und werden im Bericht gemeldet.