Diese kleine Beispielwebsite wird im gitlab des nerdbridge e.V. Einbeck gehostet und wurde aus einem One-Click-and-three-edits Template erstellt.

Der nerdbridge e.V. stellt mit nerdbridge.xyz eine Domain bereit, unter der beliebige Websites gehostet werden können. Dabei ist alles zwischen einfachen HTML Dateien und komplexen Jekyll Websites möglich.

GitLab Account

Es wird ein Account auf git.nerdbridge.de benötigt.

Projekt anlegen

Template wählen

  • Am oberen Bildschirmrand die Schaltfläche “Create from Template” wählen
  • Eines der “Pages/” Templates wählen

Wir empfehlen “Pages/Plain HTML” oder “Pages/Jekyll”.

Wähle für dieses Beispiel bitte Pages/Jekyll.

Der Projektname

Jeder Benutzer kann Projekte im GitLab anlegen. Der Name des Projektes entscheidet, unter welcher Adresse die Website erreichbar sein wird.

Benutzername Projektname URL
christian hello-world http://christian.nerdbridge.xyz/hello-world/
christian christian.nerdbridge.xyz http://christian.nerdbridge.xyz/

Es muss dabei zwischen zwei verschiedenen Veröffentlichungen unterschieden werden:

  1. Unterverzeichnis: Jedes beliebiges Projekt kann eine Unterverzeichnis-Website sein. Die Adresse besteht aus einer Kombination von Benutzernamen und Projektnamen. Beispiel: http://christian.nerdbridge.xyz/hello-world/
  2. Benutzwerwebsite: Jeder Benutzer kann exakt eine Benutzerwebsite veröffentlichen. Dabei muss der Projektname meinbenutzername.nerdbridge.xyz entsprechen. Beispiel: http://christian.nerdbridge.xyz/

Einstellungen anpassen

Dieser Punkt kann übersprungen werden, wenn die Website als Benutzerwebsite veröffentlicht werden soll!

  • Projekt mit der Web IDE öffnen
  • _config.yml öffnen
  • Die Einstellung baseurl auf /dein-projektname anpassen
  • Commit…
  • Commit to master branch
  • Commit

Runner zuweisen

GitLab benötigt einen so genannten Runner um die Website zu erstellen und zu veröffentlichen. Auf dem Runner wird das Programm jekyll-build gestartet, um aus dem Website Projekt statische HTML Dateien zu erzeugen.

Bitte kontaktiere für die Zuweisung eines Runners den Administrator.

Eigener Runner

Technisch versierte Menschen können dem Projekt auch einen eigenen Runner zuweisen.

Erste Veröffentlichung

  • CI/CD -> Pipelines öffnen
  • Run Pipeline
  • Run Pipeline
  • Warten bis der Job fertig ist
  • Deine Website aufrufen

Sollte der Job fehlschlagen, kann die Ausgabe des Jobs auf Fehler überprüft werden. Solltest Du Hilfe brauchen, auch hier gerne den Administrator kontaktieren. :-)

Profit!

Profit!