1. Inhalt des Backup-Ordners
| Datei | Aufgabe |
|---|---|
| index.html | Layout, Suche, automatische Kategorienbildung und Darstellung der Anleitungskarten. |
| anleitungen.txt | Selbst gepflegte Liste der Anleitungen. Pro Anleitung genau eine Zeile. |
| manifest.webmanifest | App-/PWA-Informationen für die installierbare Bibliothek. |
| sw.js | Service Worker für die App-Funktion und den kontrollierten Cache. |
| icon-192.png | Kleines App-Symbol. |
| icon-512.png | Großes App-Symbol. |
| dieses PDF | Beschreibt Wiederherstellung und spätere Pflege. |
Für die neue Variante gehören alle sechs technischen Dateien in den Sicherungsordner. Die frühere Zwei-Dateien-Sicherung mit nur index.html und anleitungen.txt ist nicht mehr vollständig.
2. Bibliothek wiederherstellen
Cloudflare öffnen
Bei Cloudflare anmelden und Workers und Pages öffnen.
Neue Anwendung anlegen
Wenn die Bibliothek neu aufgebaut wird: Anwendung erstellen und anschließend Upload your static files wählen.
Backup-Ordner hochladen
Den vollständigen Backup-Ordner mit den sechs technischen Dateien hochladen. Cloudflare muss alle Dateien erkennen.
Namen vergeben und bereitstellen
Einen geeigneten Worker-Namen in Kleinbuchstaben mit Bindestrichen vergeben und die Anwendung bereitstellen.
Eigene Domain verbinden
Im Worker Domains und Routes öffnen, Domain hinzufügen wählen und die eigene Domain oder Subdomain verbinden.
Die eigene Domain öffnen. Die Bibliothek muss erscheinen. Bei leerer anleitungen.txt steht dort Noch keine Anleitungen eingetragen.
3. Aufbau von anleitungen.txt
Eine Anleitung = eine Zeile
Die Datei wird in TextEdit als reine Textdatei bearbeitet. Jede Zeile besteht aus vier Feldern: Kategorie | Titel | URL | Beschreibung.
macOS | USB Bootfähig | https://xn--usb-bootfhig-ocb.urschitz.page/ | Anleitung für einen bootfähigen macOS-USB-StickTrennzeichen: senkrechter Strich | (kein Slash /). Auf deutscher Mac-Tastatur: Option + 7. Vor und nach dem Strich jeweils genau ein Leerzeichen.
4. Bibliothek selbst pflegen
Neue Anleitung hinzufügen
In anleitungen.txt eine neue Zeile im Schema Kategorie | Titel | URL | Beschreibung einfügen und mit Cmd+S speichern.
Anleitung ändern
Die betreffende Zeile bearbeiten. Kategorie, Titel, URL oder Beschreibung können direkt geändert werden.
Anleitung entfernen
Die komplette Zeile der betreffenden Anleitung löschen und die Textdatei speichern.
Änderungen veröffentlichen
Den vollständigen Bibliotheksordner mit allen sechs technischen Dateien erneut über Cloudflare bereitstellen. Die eigene Domain bleibt unverändert verbunden.
Ergebnis prüfen
Die Bibliothek über die eigene Domain öffnen bzw. neu laden. Neue, geänderte oder entfernte Einträge müssen dort sichtbar sein.
Aktuelle Fassung sichern
Nach wichtigen Änderungen die aktuelle anleitungen.txt sichern. Bei technischen Änderungen auch die übrigen Dateien ersetzen. Im Backup-Ordner immer nur die aktuelle, getestete Fassung der sechs technischen Dateien aufbewahren.
Für die laufende Pflege wird normalerweise nur anleitungen.txt inhaltlich geändert. Beim Bereitstellen wird trotzdem immer der vollständige Bibliotheksordner hochgeladen.
5. Backup aktuell halten
Aktuelle Fassung sichern
Nach wichtigen Änderungen die aktuelle anleitungen.txt sichern. Bei technischen Änderungen auch die übrigen Dateien ersetzen. Im Backup-Ordner immer nur die aktuelle, getestete Fassung der sechs technischen Dateien aufbewahren.