Wie funktionierts
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:
- 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/
- 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!