Zusammenfassung und Zeitplan
Voraussetzungen
Vor der Teilnahme an dieser Lektion sollten die Lernenden idealerweise in der Lage sein:
- ein Projekt auf GitLab / EMBL GitLab erstellen.
- Klonen einer lokalen Kopie eines Projekts mit Git, Hinzufügen und Übertragen geänderter Dateien und Push/Pull von Änderungen zwischen lokalen und entfernten Repositories.
- Befehle in der Shell ausführen.
Keine der oben genannten Voraussetzungen ist absolut notwendig, um der Lektion zu folgen. Sie werden jedoch benötigt, um die Entwicklung der Website von Ihrem Laptop aus effizient zu verwalten und zu testen, wie sie aussieht, bevor Sie offizielle Versionen erstellen.
Wenn Sie eine der oben aufgeführten Fähigkeiten erlernen möchten, sind die [Software Carpentry][swc]-Lektionen über [die Shell][swc-shell] und [Git][swc-git] ein guter Anfang.
Für diejenigen, die bereits mit den Möglichkeiten von Git und einer Online-Plattform wie GitLab oder GitHub vertraut sind, um Änderungen an flachen Textdateien zu verfolgen und zu vergleichen und mit anderen an Projekten zusammenzuarbeiten, bieten GitLab (und GitHub) Pages eine kostenlose Möglichkeit, Webseiten zu erstellen und zu hosten. Dieser Ansatz wird häufig für die Dokumentation von Softwareprojekten und für die Erstellung von Blogs und Websites für Einzelpersonen und Organisationen verwendet, die bereits mit dem Git-Toolset für ihre anderen Projekte arbeiten. Für diejenigen, die sich zum ersten Mal mit der Erstellung solcher Websites befassen, kann der Prozess jedoch verwirrend und einschüchternd sein. Dieses Tutorial soll dies beheben, indem es
- eine Schritt-für-Schritt-Anleitung zur Erstellung einer Sammlung von Seiten,
- zeigt mehrere Beispiele, wie man sie zu einer kohärenten Site strukturieren kann,
- Demonstration der Verwendung verschiedener Frameworks für die Entwicklung von Webseiten, von einfachem HTML bis Jekyll und Sphinx.
Der Unterschied zwischen der Entwicklung von GitLab- und GitHub-Seiten wird ebenfalls kurz besprochen.
Veraltete Screenshots
In dieser Lektion werden wir Inhalte und Screenshots von [git.embl.de] (https://git.embl.de/) verwenden und zeigen. Als sich ständig weiterentwickelnde Plattform fügt GitLab seiner Website ständig neue Funktionen und neue visuelle Elemente hinzu. Screenshots in der Lektion können dann nicht mehr synchron sein, auf Inhalte verweisen oder diese zeigen, die nicht mehr existieren.
Wenn Sie während der Lektion Screenshots finden, die nicht mehr mit dem übereinstimmen, was Sie in Ihrem Browser sehen, öffnen Sie bitte ein Problem, das beschreibt, was Sie sehen und wie es sich vom Inhalt der Lektion unterscheidet. Fügen Sie bitte so viele Screenshots wie nötig hinzu, um die Diskrepanz zu verdeutlichen.
| Einrichtungshinweise | Lektionsdateien herunterladen | |
| Duration: 00h 00m | 1. Einführung |
Was sind statische Webinhalte? Warum sollte ich GitHub oder GitLab Pages zum Erstellen meiner Website verwenden? |
| Duration: 00h 00m | 2. Verfassen mit Markdown |
Wie kann ich Inhalte für meine Webseiten schreiben? Wie verlinke ich zu anderen Seiten? |
| Duration: 00h 00m | 3. Hosting von Seiten auf GitLab | Wie veröffentliche ich meine Seiten über GitLab? |
| Duration: 00h 00m | 4. GitLab-Seiten mit Jekyll | Wie veröffentliche ich Webseiten über GitLab und Jekyll? |
| Duration: 00h 00m | 5. GitLab-Seiten mit Sphinx | Wie veröffentliche ich Webseiten über GitLab und Sphinx? |
| Duration: 00h 00m | 6. GitLab-Seiten mit Jupyter-Büchern | Wie veröffentliche ich Webseiten über GitLab und Jupyter Books? |
| Duration: 00h 00m | 7. GitLab-Vorlagen | Wo finde ich vorgefertigte Projekte/Themes für meine Website? |
| Duration: 00h 00m | 8. Wenn etwas schief geht | Wie behebe ich Fehler in den GitLab-Pipelines? |
| Duration: 00h 00m | Fertig |
Abhängig von den gewählten Themen und Übungen, kann der tatsächliche Zeitplan etwas abweichen.
Required
Prior to the workshop you will need to setup a free account for GitLab or (preferentially) on the local EMBL instance git.embl.de. If you need assistance with loggin in the EMBL GitLab platform, check these instructions.
Optional
During the course we will teach how to use GitLab in the online platform, but not how to use Git locally on your laptop. Still, knowing Git might be useful to take your web dev skills next level. So, please consider installing the Bash Shell and Git in your laptop, following these instructions from The Carpentries.
Once you have Git and the Bash Shell installed, you are all set to follow these training materials and learn the basis of Git.