FediVerse Starterpacks bearbeiten

Du folgst Alice. Alice folgt Bob. Möchtest Du nicht auch Bob folgen?

Im FediVerse wird man glücklicherweise nicht mit solch aufdringlichen Vorschlägen von Algorithmen konfrontiert.

Aber manchmal wäre es schon schön, interessante Menschen und Initiativen bzw. ihre FediVerse-Profile leichter zu finden.

Das ist der Grund, warum es https://fedikirche.de gibt.

Dort sind in sog. Starterpacks FediVerse-Profile unter diversen Themen zusammengefasst, z.B. Inkusion oder katholische/ evangelische Gemeinden.

Geht man diese Listen durch, findet man bestimmt das eine oder andere Profil, dem es sich zu folgen lohnt.

Aber wie werden die Startepacks hinter den Kulissen bearbeitet?

Hier eine kleine Anleitung, die auch auf andere Projekte übertragen werden kann, die kollaborativ in einem Versionsverwaltungssystem gepflegt werden.

Versionsverwaltungssystem

In einem Versionsverwaltungssystem werden Änderungen an einer Datei durch Versionierung nachvollzieh- und vergleichbar. Es hat sich gerade in der dezentralen Zusammenarbeit bewährt.

Hier werden am konkreten Beispiel Grundfunktionen gezeigt. Die Startetpacks der FediKirche werden auf der (git/ Forgejo https://de.wikipedia.org/wiki/Forgejo) Plattform Codeberg gespeichert und bearbeitet.

Und so gehts:

Repository forken

• Bei codeberg.org einloggen oder registrieren
• Das Repo https://codeberg.org/kirche-im-netz/Startodon-Hub aufrufen
• Das Repo “forken”: Im oberen rechten Bereich auf [Fork] klicken

Nun wird das Repo in den eigenen Account übertragen, praktisch eine Kopie angelegt.

Repository auf den lokalen Rechner übertragen

Damit man mit den Code arbeiten kann, muss das Repo auf den lokalen Computer übertragen werden.

Das geht so:

• Im Webinterface des Repos oben rechts neben der URL auf das [Kopieren-Symbol] klicken
• Auf dem Computer in dem gewünschten Verzeichnis ein Terminal öffnen
• Den Befehl git clone und die kopierte URL ausführen
• In das Verzeichnis Startodon-Hub wechseln
• Das lokal Repo mit dem Originalen verknüpfen git remote add upstream https://codeberg.org/kirche-im-netz/Startodon-Hub.git

Ein neues Starterpack anlegen

Um ein neues Starterpack anzulegen, wird eine neue json-Datei mit dem entsprechenden Schema angelegt, in den Fork des Online-Repos übertragen und mit einem Pull-Request dem Original-Repo zugefügt.

Das geht so:

• Auf dem Computer in das Verzeichnis Startodon-Hub wechseln und ein Terminal öffnen
• Das lokale Repo mit eventuellen Änderungen aus dem Original-Repo mit zwei Befehlen synchronisieren:
  • git remote update
  • git merge upstream/pages
• Einen neuen Bearbeitungszweig (Branch) anlegen: git checkout -b meinNeuerBranch
• Mit einem Editor die neue Datei anlegen, die Struktur von einem bestehenden Starterpack übertragen und die neuen FediVerse-Handles eintragen.
• Mit git status -s die Änderungen anzeigen
• Mit git add meineGeänderteDatei die Übertragung vorbereiten
• Mit commit -m "diese Datei habe ich ergaenzt" einen Kommentar zufügen
• Mit git push -u origin meinNeuerBranch die Änderungen zum Online-Fork übertragen

Nun weiter im Abschnitt [Änderungen in das Original-Repo überführen]…

Ein Starterpack ändern

Um ein Starterpack zu ändern, wird die entsprechende Datei geändert, die Änderungen wieder in den Fork übertragen und ein Pull-Request eröffnet, damit die Änderungen in das ursprüngliche Repo übertragen werden.

Das geht so:

• Auf dem Computer in das Verzeichnis Startodon-Hub wechseln und ein Terminal öffnen
• Das lokale Repo mit eventuellen Änderungen aus dem Original-Repo mit zwei Befehlen synchronisieren:
  • git remote update
  • git merge upstream/pages
• Einen neuen Bearbeitungszweig (Branch) anlegen: git checkout -b meinNeuerBranch
• Nun mit dem Editor der Wahl die Änderungen vornehmen und Datei speichern
• Mit git status -s die Änderungen anzeigen
• Mit git add meineGeänderteDatei die Übertragung vorbereiten
• Mit commit -m "das habe ich geaendert" einen Kommentar zufügen
• Mit git push -u origin meinNeuerBranch die Änderungen zum Online-Fork übertragen

Nun weiter im Abschnitt [Änderungen in das Original-Repo überführen]…

Änderungen in das Original-Repo überführen

Im Webinterface muss nun ein Pull-Request eröffnet werden.

Das geht so:

• Das Original-Repo aufrufen
• Im Menü [Pull-Requests] klicken
• Oben rechts die Schaltfläche [Neuer Pull-Request] klicken
• Den Ziel- (links) und Quell-Branch (rechst) einstellen
• Die Schaltfläche [Neuer Pull-Request] klicken
• Einen Kommentar eingeben

Wurde der Pull-Request akzeptiert, muss noch ein wenig aufgeräumt werden.

Das geht so:

• Auf dem Computer den Branch wieder löschen git branch -D meinNeuerBranch
• Das lokale Repo wieder mit dem originalen synchronisieren
  • git remote update
  • git checkout pages
  • git merge upstream/pages
• Im Webinterface meinNeuerBranch wieder löschen
  • In der Hauptübersicht den Menüpunkt [Branches] aufrufen
  • In der Zeile von meinNeuerBranch das [Löschen-Symbol] recht klicken

Begriffserklärung

• Repo/ Repository: Repository – eine Art Softwarespeicher
• Forken: Eine Art Kopie des Repos im eigenen Account erstellen
• Pull-Request: Änderungen von einem Fork in das Original-Repo übertragen

Vernetzt Euch

Vielleicht hilft diese Anleitung einerseits den Einstieg in moderne Projektverwaltung zu erleichtern, und andererseits neue interessante Menschen im FediVerse zu finden.

lexplorer

More Posts - Website