Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Statische Seiten anbieten

Mit Hubzilla sind Sie auch in der Lage, statische Webseiten anzubieten.

Beispiel: mdBook-Seiten

So ist dieses Buch hier nicht mit Hubzilla, sondern mit dem Seitengenerator mdBook erstellt. Ich nutze dieses System gerne und habe den Workflow inzwischen verinnerlicht. Den gesamten Inhalt erstellt man damit mit Marksown-Dateien, die dann in einer weiteren Markdown-Datei (SUMMARY.md) in eine unsortierte Liste verlinkt werden. mdBook kann die Seite mit einem eigenen kleinen Webserver lokal so anzeigen, wie sie letztlich auch auf dem Server ausgeliefert wird. Änderungen an den Quell-Dateien werden dabei ständig sofort übernommen, sodass man jederzeit sieht, wie sich diese auf das Gesamtwerk auswirken.

Mit einem anderen Befehl erzeugt mdBook dann die komplette Struktur der statischen Webseite in einem eigenen Verzeichnis. Diesen Inhalt muss man nur auf den Server hochladen und die Seite ist online.

Ich habe versuchsweise die mdBook-Webseite “Nostr KnowledgeDB”, die ich normalerweise unter https://ninfo.tnevlos.xyz/ öffentlich anbiete, in das Verzeichnis “nostr_kdb” meines Kanals “thesmokinggnu@klacker.org” hochgeladen. Ruft man nun die Datei https://klacker.org/cloud/thesmokinggnu/nostr_kdb/index.html auf, wird die mdBook-Seite ganz normal dargestellt und man kann innerhalb der Seite mit sämtlichen Features, die mdBook bietet, surfen.

mdBook-Seite in der Hubzilla-Cloud

Beispiel: Hugo-Seiten

Ein sehr bekanntes System zur Erzeugung statischer Webpräsenzen ist Hugo. Auch Hugo-Wenseiten kann man benutzbar in der Hubzilla-Cloud anbieten. Man muss dafür in der Datei hugo.toml bei baseURL die URL des Hubzilla Cloud-Verzeichnisses eintragen und (wichtig) einen weiteren Eintrag uglyURLs = true anfügen (dieser sorgt dafür, dass Verweise innerhalb der Seitenstruktur immer als vollständige Dateinamen referenziert werden).

Als Beispiel habe ich das “berühmte” Quickstart-Beispiel aus der Hugo-Dokumentation verwendet und die erzeugte Seitenstruktur in das Verzeichnis “gohugoqs” hochgeladen. Ruft man nun https://hub.hubzilla.hu/cloud/pepecyb/gohugoqs/index.html auf, wird die Hugo-Webseite vollständig nutzbar dargestellt.

Hugo-Seite in der Hubzilla-Cloud

Beispiel: Publii

Ein weiteres, sehr komfortables System zur Erstellung statischer Webseiten mit dem Komfort eines modernen CMS ist die Software Publii. Ich habe hier zur Demonstration ein Mini-Blog mit dem Standard-Theme “Simple” (es gibt noch etliche andere Themes: Marketplace - Themes) und zwei Demo-Artikeln erstellt. Das hat keine fünf Minuten gedauert.

publii-demo

Wie auch bei Hugo ist es erforderlich, dass Verlinkungen innerhalb der Seitenstruktur das jeweilige Dokument vollständig referenzieren. Um das zu erreichen wählt man auf der Seite “Seiteneinstellungen” ➔ “Erweiterte Optionen” die Option “Immer index.html zu URL’s hinzufügen” aus.

publii-demo-settings

Für das Erstellen wählt man für den “Server” und dort “Relative URL’s verwenden” und für den Ausgabetyp “Unkomprimierter Katalog”. Den Inhalt des damit erzeugten Verzeichnisses muss man einfach nur in die Cloud hochladen und die statische Seite ist dann in der Cloud an entsorechnder Stelle über index.html erreichbar:

publii-page

Das Beispiel-Blog ist hier erreichbar: https://klacker.org/cloud/tutorial01/publiidemo/index.html.