Sie möchten Ihren LiaScript Kurs nicht allein, sondern zusammen mit anderen Personen bearbeiten? Kein Problem. Zwar lässt sich das Einladen weiterer Mitarbeiter:innen nicht in Visual Studio Code erledigen, über GitHub ist dies aber einfach möglich. Der Dienst ist hervorragend für die Zusammenarbeit mehrerer Personen an einem Projekt geeignet.


 Wichtig!

Damit Sie anderen Personen Zugriff auf Ihren Kurs ermöglichen können, müssen diese bei GitHub angemeldet sein. Alle Informationen zum Einrichten eines GitHub Accounts finden Sie unter Punkt 4 "Verbindung zu GitHub herstellen".

Beachten Sie außerdem bei der Arbeit mit mehreren Personen an einem Git-Projekt unbedingt die Hinweise im Infokasten am Ende dieses Schrittes!

1. Wie Sie andere Personen zur Mitarbeit einladen
Geben Sie den mitarbeitenden Personen zunächst Zugriff auf das GitHub Repository, in dem sich Ihre Kursdatei befindet. Loggen Sie sich hierfür über einen Browser bei GitHub (https://github.com/) ein. Wählen Sie das Repository aus, zu dem sie Kolleg:innen einladen möchten und gehen Sie auf den Reiter Settings.

Abbildung: Screenshot Repository Settings in GitHub

Wechseln Sie hier nun in den Abschnitt Manage access.

Abbildung: Screenshot Zugriff verwalten in GitHub

Dort angekommen können Sie mit einem Klick auf den Button Invite a collaborator Personen hinzufügen.

Abbildung: Screenshot Mitarbeiter:innen zu einem auf GitHub Repository einladen

Sie haben hierbei die Möglichkeit, Ihre Mitarbeitenden via GitHub Username, echten Namen oder E-Mail Addresse zu finden.

Abbildung: Screenshot Mitarbeiter:innen finden

Wählen Sie die:den gewünschte:n Mitarbeitende:n aus und klicken Sie anschließend auf Add to this repository. Selbstverständlich können Sie auch mehr als nur eine Person zur Mitarbeit an Ihrem Repository einladen.

Abbildung: Screenshot Mitarbeiter:innen hinzufügen

Hurra! Sie haben Ihre:n Mitarbeiter:in erfolgreich zu Ihrem Repository hinzugefügt.


2. Wie Sie vorgehen, wenn Sie zur Mitarbeit an einem Repository eingeladen wurden
Wurde der Zugang zu einem Repository für Sie als Mitarbeiter:in freigeschaltet, erhalten Sie automatisch eine Einladung per Mail. Warten Sie nicht zu lange damit, die Einladung zu bestätigen. Der Einladungslink in der E-Mail ist nur für einen Zeitraum von 7 Tagen gültig.

Abbildung: Screenshot Einladung zu einem GitHub Repository

Über den Button View invitation werden Sie zu GitHub weitergeleitet. Dort können Sie nach dem Login auf den Button Accept invitation klicken, um die Einladung anzunehmen. Anschließend sind Sie als Collaborator in das Repository eingetragen, d.h. sie können direkt im GitHub Repository Inhalte erstellen und verändern.

Um nun auch über Visual Studio Code an der für Sie freigegebenen Kursdatei arbeiten zu können, müssen Sie den Kurs auf Ihrem Rechner lokal klonen. Dafür gehen Sie in GitHub auf das Repository, an dem Sie mitarbeiten wollen, und kopieren den Link, der Ihnen angezeigt wird, wenn Sie auf den grünen Code-Button klicken. Wichtig hierbei ist, dass oben HTTPS ausgewählt ist. Dies entspricht auch der automatischen Voreinstellung.
Abbildung: Screenshot Kopieren eines Repository Links in GitHub

Öffnen Sie nun in Visual Studio Code die Kommandozeile (STRG + SHIFT + P) und geben sie git clone ein. Der Befehl Git: Clone sollte nun zu sehen sein. Wenn Sie diesen auswählen, öffnet sich ein weiteres Eingabefeld, in dem Sie den HTTPS-Link einfügen und das Klonen mit Enter bestätigen können. Als Nächstes legen Sie noch den lokalen Speicherort des zu klonenden Repository fest, bevor das Herunterladen beginnt.

Abbildung: Screenshot Visual Studio Code Kommandozeile

Sie können nun unter File → Open File... die Kursdatei (Endung .md) auswählen und daran arbeiten. Wie das funktioniert ist in Lektion 3 "Kurs strukturieren, Inhalte einfügen" dieses Moduls beschrieben.

3. Visual Studio Code Erweiterung: Live Share
Visual Studio Code bietet alternativ die Möglichkeit an, mit Arbeitskolleg:innen gleichzeitig im selben Dokument zu arbeiten, sodass alle Änderungen in Echtzeit beim Kollegen aktualisiert und übernommen werden. Möglich ist dies mithilfe der Erweiterung Live Share. Vorstellen kann man sich das wie beim kollaborativen open-source Editor HedgeDoc oder dem neuen LiaScript LiveEditor LiaEdit.
Möchten Sie mehr darüber erfahren, dann empfehlen wir Ihnen im Reiter Extensions nach dem PlugIn Live Share zu suchen und sich die Beschreibung und Anleitung dazu durchzulesen.

Viel Spaß beim Erstellen vielfältiger Lehrmaterialien mit LiaScript!


Wichtige Hinweise zum gemeinsamen Arbeiten in Git:

  • Damit Sie immer an der aktuellsten Fassung Ihres Kurses arbeiten, müssen Sie vor Beginn der Arbeit an dem Kursdokument unbedingt den Button Fetch klicken
  • Pushen/Syncen Sie lieber öfter kleine Änderungen, anstatt einmalig eine große
  • Um Versionskollisionen zu vermeiden, klicken Sie unbedingt den Button Fetch bevor Sie etwas pushen!


Zuletzt geändert: Friday, 7. June 2024, 15:14