Dies ist der Quellcode für die Webseite von KlimaLautern. Es ist eine GitHub Page.
Mehr Infos zu GitHub Pages.
Die Seiten sind in Markdown geschrieben.
Im Unterverzeichnis _posts kann man neue Blog-Beiträge hinterlegen.
Die Einträge sollten mit solchen Einträgen beginnen:
---
title: Unser Erstes Arbeitstreffen
layout: post
description: Die inhaltliche Arbeit beginnt mit dem ersten Arbeitstreffen
thumbnail: /images/2022-12-01-erstes-arbeitstreffen.jpg
tags: Veranstaltung
---
Hier steht Markdown-Text.
- Das Thumbnail wird auch beim Überblick genutzt.
- Bei den Tags gibt es im Moment nur Veranstaltungen, später können wir noch andere Tags einfügen.
- Darunter steht dann der Text als Markdown.
- Erstelle Dir einen GitHub-Account.
- Oben auf der Website mit dem Quellcode findest Du das Fork-Symbol. Damit erstellst Du einen eigenen Fork der Website.
- Den Fork findest Du dann bei GitHub dort, wo Du ihn gerade angelegt hast. Meiner ist hier: https://github.com/ewolff/klimalautern.github.io.
- Dort kannst Du nun Dateien anlegen, löschen oder editieren. Dazu sind Einträge im Menü vorhanden.
- Es gibt im Editor ein Preview, das aber nur einen Eindruck von dem Layout gibt. Die tatsächliche Seite wird anders aussehen.
- Da auch andere Personen an der Website arbeiten, ist es notwendig, den eigenen Fork aktuell zu halten. Dazu kann man den eigenen Fork syncen.
- Das sollte man immer tun, wenn der eigene Fork nicht mehr aktuell ist. GitHub meldet einem, wieviele "commit behind" der eigene Fork ist.
- Wenn Du eine Datei geändert oder ergänzt hast, musst Du sie jeweils commiten. Schreibe dazu einen aussagekrätigen Titel, damit man weiß, was Du getan hast.
- Mit dem Commit ist Deine eigener Fork aktualisiert, aber noch nicht die Website. Du kannst also nix kaputt machen.
- Der Commit soll direkt in den main-Branch gehen.
- Wenn soweit alles fertig ist, kannst Du einen Pull Request erstellen.
- Mit dem Pull Request schaffst Du die Voraussetzung dafür, dass die Änderungen an Deinem eigenen Fork auf die Website kommen. Es schaut aber nochmal jemand vorher über die Änderungen. Du kannst also nix kaputt machen.
- Gib dem Pull Request einen sinnvollen Namen.
- Fertig! Glückwunsch!