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 |
What is static web content? Why should I use GitHub or GitLab Pages to create my website? |
Duration: 00h 00m | 2. Verfassen mit Markdown |
How can I write content for my webpages? How do I link to other pages? |
Duration: 00h 00m | 3. Hosting von Seiten auf GitLab | How do I publish my pages via GitLab? |
Duration: 00h 00m | 4. GitLab-Seiten mit Jekyll | How do I publish web pages through GitLab and Jekyll? |
Duration: 00h 00m | 5. GitLab-Seiten mit Sphinx | How do I publish web pages through GitLab and Sphinx? |
Duration: 00h 00m | 6. GitLab-Seiten mit Jupyter-Büchern | How do I publish web pages through GitLab and Jupyter books? |
Duration: 00h 00m | 7. GitLab-Vorlagen | Where can I find pre-built projects/themes for my site? |
Duration: 00h 00m | 8. Wenn etwas schief geht | How do I troubleshoot errors in the 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.