Zusammenfassung und Einrichtung

Voraussetzungen

Vor der Teilnahme an dieser Lektion sollten die Lernenden idealerweise in der Lage sein:

  1. ein Projekt auf GitLab / EMBL GitLab erstellen.
  2. 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.
  3. 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

  1. eine Schritt-für-Schritt-Anleitung zur Erstellung einer Sammlung von Seiten,
  2. zeigt mehrere Beispiele, wie man sie zu einer kohärenten Site strukturieren kann,
  3. 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.

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.