Chaotikum Website

Content auf der Website erstellen

Jedes Mitglied des Chaotikums ist grundsätzlich aufgerufen Inhalte sowohl im Wiki als auch auf der Website (hier) zu schaffen, zu pflegen und zu verbessern. Wer sich unsicher ist kann diejenigen, die es bereits aktiv betreiben fragen. Einen formellen Freigabeprozess gibt es nicht. Benötigt wird ein Zugang zum Git-Repository der Website, wofür wiederum ein LDAP-Zugang notwendig ist (auch hier, einfach nachfragen sofern nicht vorhanden).

Die Website nutzt ein Jekyll und die Daten liegen im gitlab des Chaotikums. Der Master-Branch wird automatisch gebaut und deployed.

Auf deinem Rechner an der Website arbeiten

Wenn ich an der Website arbeite, sollte ich sie lokal testen. Dafür musst du zuerst den Inhalt dieses git-repositorties auf deinen Rechner klonen.

Wenn du unsicher bist, wie du mit git arbeitest, gibt es dazu verschiedene Resourcen, am besten einfach mal googlen.

Website lokal starten

Die Website wird mit Jekyll betrieben, das muss man also erstmal installieren. Das Tutorial findet man hier. Dort findet man auch aktuelle Hinweise zur minimalen Ruby Version die benötigt wird.

gem install bundler jekyll

Install depencies:

gem install bundler
bundle install

Build:

bundle exec jekyll build

Or launch a webserver with consecutive builds:

bundle exec jekyll serve

Ruby Versionen

Aktuell verwendet der Runner Ruby 2.5.5. Lokal kann man zum Beispiel auch Ruby 2.6.9 verwenden. Ganz moderne Ruby-Versionen funktionieren eher nicht so gut.

Truble Shouting

Persmissions

Bei

gem install bundler jekyll

kann die Rückmeldung

You don't have write permissions for...

kommen. Entweder versuche es mit Sudo oder installiere es mit --user-install. Siehe diesem Hinweis.

Failed To Build Native Extension

Bei

gem install bundler jekyll

kann die Rückmeldung Error installing jekyll: ERROR: Failed to build gem native extension.

kommen. Vermutluch utner MacOS? Hier sind einige Hinweise.

Vielleicht ist das Problem auch die Ruby version?

chruby 3.0.5 

Einen Blogpost schreiben

Worauf muss man achten, wenn man einen neuen Blogpost für die Chaotikum Website verfassen möchte?

Eine detailliert Anleitung zum Anlegen eines Blogposts findest du im Wiki.

Bilder und Galierien

Die (leider etwas aufwendige) Art Bilder auf die Website funktioniert über dieses Repository.

Eine detailliert Anleitung findest du im Wiki.

Projekte darstellen

Die Projektseite auf der Website wird mithilfe von Markdown Dateien in diesem Repository erstellt.

Eine detailliert Anleitung findest du im Wiki.

Events eintragen

Der Event-Kalender des Chaotikums wird auch über dieses Repository erstellt.

Eine detailliert Anleitung findest du im Wiki.

Werkstatt und Werkzeug

Auf der Website gibt es eine Auflistung von Werkzeugen über welche wir verfügen. Auch diese wird über dieses Repository erstellt.

Eine detailliert Anleitung findest du im Wiki.