4.4 Kurs online ablegen

Damit aus Ihrem Dokument ein LiaScript Kurs generiert, veröffentlicht und geteilt werden kann, muss das Kursdokument (Markdown-datei) irgendwo öffentlich im Internet abgelegt sein. Dies kann auf vielen verschiedenen Plattformen passieren. Der LiaScript LiveEditor benutzt zum Veröffentlichen der Liascript Kurse die Plattform GitHub. Das heißt, um alle Funktionen von LiaEdit vollständig nutzen zu können, benötigt man einen kostenfreien GitHub Account. Falls Sie den Editor nur zum Erstellen der Markdown-Datei nutzen möchten und Ihren Kurs woanders veröffentlichen wollen, dann brauchen Sie sich keinen GitHub Account zu erstellen. Mehr dazu weiter unten in der Infobox.

GitHub Anmeldung

1. Besuchen Sie für die Anmeldung die Seite www.github.com und klicken Sie oben rechts auf Sign Up
2. In dem folgenden Fenster tragen Sie einen Username, Ihre E-Mail und ein Passwort ein. Mit einem Klick auf den Button Create Account erstellen Sie sich Ihren eigenen Account.
3. Zum Abschluss müssen Sie nun lediglich noch Ihre E-Mail-Adresse verifizieren. Dafür erhalten Sie eine E-Mail von GitHub mit dem Betreff [GitHub] Please verify your email address. Dort klicken Sie auf den Button Verify email address. Nun werden Sie auf eine Seite geführt, die die Verifizierung Ihres Accounts bestätigt.

Haben Sie sich einen GitHub Account erstellt, so können wir mit dem öffentlichen Ablegen des Kurses weitermachen. Der LiaScript LiveEditor verwendet zum Ablegen und Veröffentlichen die GitHub Funktion GitHub Gist.

GitHub Gist ist eine Subdomäne von GitHub auf der Gists erstellt werden können. Mit Gists können schnell und einfach kleine Codeschnipsel oder Texte online gespeichert werden, welche alleine kein umfassendes Repository rechtfertigen. Sie bieten sich an, wenn Sie nur schnell etwas Code oder Text mit Anderen austauschen wollen. Die Besonderheit an GitHub Gist ist die zusätzliche Verfügbarkeit der für GitHub typischen Git Versionsverwaltung. Dies ermöglicht eine Nachverfolgung von Veränderungen an den von Ihnen erstellten Inhalten.

Achtung! Nur beim erstmaligen Exportieren des Kursdokuments zu GitHub Gist wird automatisch ein LiaScript Kurs aus der RAW-File generiert. Späteres erneutes Exportieren, was hier mit Speichern zu vergleichen ist, aktualisiert lediglich den Gist, aber leider nicht den daraus generierten Kurs.  Das hat zur Folge, dass man bei späteren Änderungen am Kursdokument den Kurs mithilfe der neuen GitHub RAW-Files selbstständig neu generieren muss. Das ist zwar kein großer Aufwand, jedoch sollte einem bewusst sein, dass sich dadurch zwangsläufig auch die Internetadresse des LiaScript Kurses verändert. Zur Vermeidung dieses Schrittes ist es sinnvoll, den Kurs erst nach Fertigstellung aller Inhalte zu veröffentlichen. Mehr dazu später im Abschnitt  "Kursinhalte ändern oder weiterbearbeiten".

Um den eigenen Kurs nun bei GitHub Gist öffentlich abzulegen, wählen Sie zunächst oben rechts das Menü aus und anschließend in dem sich öffnenden Reiter die Option Export to... GitHub Gists.



Daraufhin öffnet sich automatisch ein neuer Tab im Browser, der Sie zu Ihrem gerade neu erstellten Gist führt, in dem sich Ihr Kursdokument befindet. Falls Sie diesen Schritt zum ersten Mal mit LiaEdit ausführen, erwartet Sie noch ein kleiner Zwischenschritt. Sie werden zunächst von GitHub aufgefordert, den Zugriff vom LiaScript LiveEditor zu autorisieren.

Hinweis: Falls Sie GitHub nicht als Ablageort verwenden, jedoch ungern auf den LiaScript LiveEditor verzichten möchten, dann bietet LiaEdit neben GitHub Gists auch die Option an, das Kursdokument herunterzuladen. So können Sie dann selbst entscheiden, was Sie mit Ihrem Dokument machen. Wählen Sie hierfür im Menü die Option Download... README.md aus.