Installation & automatische Updates

Was ist das?

Dieses Paket ist ein kleines, eigenständiges Server-Handbuch im GitBook-Stil. Es braucht keine Datenbank und keinen Node-/GitBook-Build.

Installation auf Plesk

1. ZIP entpacken.
2. Den Inhalt von BIGPAPA_SERVER_HANDBUCH_WEB_V1 in eine Subdomain oder einen Webordner hochladen, z. B. docs.deine-domain.de.
3. PHP 8.1 oder neuer auswählen.
4. Prüfen, ob die PHP-Erweiterung zip / ZipArchive aktiv ist.
5. index.php aufrufen.

Neue Dokumentation hinzufügen

Variante A – Markdown-Datei

Lege .md oder .txt in docs/ ab. Unterordner werden automatisch als Kategorien verwendet.

Variante B – neuen BIGPAPA-Block als ZIP

Lade die komplette neue Block-ZIP einfach nach:

blocks/BIGPAPA_METEO_BLOCK_11.zip

Das Handbuch sucht darin automatisch nach GitBook-/Dokumentations-Markdown und fügt die Seiten in die Navigation ein. Die Resource-Dateien im ZIP werden nicht ausgeführt und nicht entpackt.

Automatische Aktualisierung

Die Seite bildet aus Dateinamen und Änderungszeiten einen Fingerabdruck. Der Browser prüft diesen regelmäßig. Wird auf dem Webserver eine Datei ersetzt oder ein neuer Block hochgeladen, lädt sich die Doku automatisch neu.

Sicherheit

• keine Datenbank
• kein Login im Paket enthalten
• ZIP-Dateien werden nur gelesen
• PHP führt keine Dateien aus den Block-ZIPs aus
• Markdown wird vor der Ausgabe HTML-escaped

Wenn die Doku nicht öffentlich sein soll, kannst du sie in Plesk zusätzlich mit Verzeichnisschutz absichern.