Server Installation/hugo: Unterschied zwischen den Versionen
Leo (Diskussion | Beiträge) K (→Überblick) |
Leo (Diskussion | Beiträge) (→Entwicklung) |
||
Zeile 8: | Zeile 8: | ||
== Entwicklung == | == Entwicklung == | ||
− | Quelltext | + | Der Hugo Quelltext ist zu finden unter https://git.hack-hro.de/opennet-initiative/static-frontpage |
− | .. | + | Wir nutzen das Theme Syna [https://about.okkur.org/syna/], welches als git submodule im obigen git eingebunden ist. |
− | ...Anpassungen | + | == Preview Blogeinträge (Quelle: RSS Feed) == |
+ | |||
+ | Eine Anforderung an die Webseite war das Anzeigen der letzten Blogeinträge. Diese sollten ausschnittsweise auf der Seite angezeigt werden. | ||
+ | |||
+ | Wir betreiben derzeit (Stand Jan 2021) unser Blog unter https://stadtgestalten.org/opennet/. Hier gibt es auch einen RSS Feed. | ||
+ | |||
+ | Eine mögliche Einbindung der Blogeinträge könnte auf unterschiedliche Wege stattfinden. Hier wurden unterschiedliche Möglichkeiten getestet und sich für einen möglichst einfache Weg letztendlich entschieden. Ziel war es möglichst wenige Anpassungen an Software durchzuführen, sodass ein Update bestehender Software immer möglich ist. | ||
+ | |||
+ | Der Ablauf hierfür ist folgender: | ||
+ | * Ein Python Skript [https://git.hack-hro.de/opennet-initiative/static-frontpage/-/blob/master/on-rss2md.py on-rss2md.py] ermöglicht das Herunterladen des Stadtgestalten RSS Feeds und generiert daraus Markdown Text mit Auszügen der Blogeinträge. | ||
+ | * Ein Deployment Skript [https://git.hack-hro.de/opennet-initiative/static-frontpage/-/blob/master/on-hugo-deploy-prod.sh] : | ||
+ | ** schreibt das Ergebnis von on-rss2md.py in die Hugo Verzeichnisstruktur (dies wird später eingebunden von https://git.hack-hro.de/opennet-initiative/static-frontpage/-/blob/master/content/_index/blog.md) | ||
+ | ** generiert die Webseiten erneut | ||
+ | ** kopiert die neuen Dateien in das Apache www Verzeichnis | ||
+ | * Deployment Skript wird als Cronjob täglich gestartet | ||
+ | |||
+ | |||
+ | == Installation == | ||
+ | |||
+ | Die aktuelle Installation besteht aus folgenden Bestandteilen (und ist auch im ansible [http://dev.on-i.de/browser/on_ansible/roles/www-frontpage] eingebunden): | ||
+ | |||
+ | * Server hikaru. Hier ist alles installiert. Der Webserver läuft hier auch. | ||
+ | * lokaler User 'hugo' | ||
+ | * geclontes git repo [https://git.hack-hro.de/opennet-initiative/static-frontpage] in /home/hugo/ | ||
+ | * cronjob für tägliches Deployment Skript | ||
== Historie == | == Historie == |
Version vom 16. Januar 2021, 22:35 Uhr
Inhaltsverzeichnis |
Überblick
Derzeit (Stand: Dez. 2020) werden Nutzer:innen beim Aufruf von https://www.opennet-initiative.de auf das Wiki umgeleitet. Hier gibt es eine angepasste Seite mit entsprechenden Informationen.
Es gibt den Bedarf die Präsentation der Startseite zu ändern und die Inhalte mehr grafisch aufzubereiten. Da diese Änderungen im Wiki sehr aufwändig wären, wurde sich entschieden, die Startseite des Webauftritts auf andere Art und Weise umzusetzen.
Wir haben uns für https://hugo.io als statischen Webseitengenerator entschieden. Dieses Tool ist einfach zu bedienen, bietet umfangreiche Layouts und ist einfach anzupassen.
Entwicklung
Der Hugo Quelltext ist zu finden unter https://git.hack-hro.de/opennet-initiative/static-frontpage
Wir nutzen das Theme Syna [1], welches als git submodule im obigen git eingebunden ist.
Preview Blogeinträge (Quelle: RSS Feed)
Eine Anforderung an die Webseite war das Anzeigen der letzten Blogeinträge. Diese sollten ausschnittsweise auf der Seite angezeigt werden.
Wir betreiben derzeit (Stand Jan 2021) unser Blog unter https://stadtgestalten.org/opennet/. Hier gibt es auch einen RSS Feed.
Eine mögliche Einbindung der Blogeinträge könnte auf unterschiedliche Wege stattfinden. Hier wurden unterschiedliche Möglichkeiten getestet und sich für einen möglichst einfache Weg letztendlich entschieden. Ziel war es möglichst wenige Anpassungen an Software durchzuführen, sodass ein Update bestehender Software immer möglich ist.
Der Ablauf hierfür ist folgender:
- Ein Python Skript on-rss2md.py ermöglicht das Herunterladen des Stadtgestalten RSS Feeds und generiert daraus Markdown Text mit Auszügen der Blogeinträge.
- Ein Deployment Skript [2] :
- schreibt das Ergebnis von on-rss2md.py in die Hugo Verzeichnisstruktur (dies wird später eingebunden von https://git.hack-hro.de/opennet-initiative/static-frontpage/-/blob/master/content/_index/blog.md)
- generiert die Webseiten erneut
- kopiert die neuen Dateien in das Apache www Verzeichnis
- Deployment Skript wird als Cronjob täglich gestartet
Installation
Die aktuelle Installation besteht aus folgenden Bestandteilen (und ist auch im ansible [3] eingebunden):
- Server hikaru. Hier ist alles installiert. Der Webserver läuft hier auch.
- lokaler User 'hugo'
- geclontes git repo [4] in /home/hugo/
- cronjob für tägliches Deployment Skript