Server Installation/hugo: Unterschied zwischen den Versionen

Aus Opennet
Wechseln zu: Navigation, Suche
(Entwicklung)
(Preview Blogeinträge (Quelle: RSS Feed): Links zum Quellcode angepasst)
Zeile 23: Zeile 23:
  
 
Der Ablauf hierfür ist folgender:
 
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 Python Skript [https://github.com/opennet-initiative/hugo/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] :
+
* Ein Deployment Skript [https://github.com/opennet-initiative/hugo/blob/master/on-hugo-deploy-prod.sh 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)
+
** schreibt das Ergebnis von on-rss2md.py in die Hugo Verzeichnisstruktur (dies wird später eingebunden von [https://github.com/opennet-initiative/hugo/blob/master/content/_index/blog.md blog.md])
 
** generiert die Webseiten erneut
 
** generiert die Webseiten erneut
 
** kopiert die neuen Dateien in das Apache www Verzeichnis
 
** kopiert die neuen Dateien in das Apache www Verzeichnis
 
* Deployment Skript wird als Cronjob täglich gestartet
 
* Deployment Skript wird als Cronjob täglich gestartet
 
  
 
== Installation ==
 
== Installation ==

Version vom 17. April 2022, 13:43 Uhr

< Server Installation

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

Unser Hugo Quelltext ist zu finden unter https://github.com/opennet-initiative/hugo

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 on-hugo-deploy-prod.sh :
    • schreibt das Ergebnis von on-rss2md.py in die Hugo Verzeichnisstruktur (dies wird später eingebunden von 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 [2] eingebunden):

  • Server hikaru. Hier ist alles installiert. Der Webserver läuft hier auch.
  • lokaler User 'hugo'
  • geclontes git repo [3] in /home/hugo/
  • cronjob für tägliches Deployment Skript

Historie

Meine Werkzeuge
Namensräume

Varianten
Aktionen
Start
Opennet
Kommunikation
Karten
Werkzeuge