Ein Projekt aus einem Template erstellen

Diese Anleitung hilft dir, wenn du ein erstes easyWebsite Projekt erstellen möchten. Nach der Einrichtung wirst du mithilfe dieser Anleitung die notwendigen Dateistrukturen aufgesetzt haben, die wichtigsten Konfigurationen vorgenommen und im Ergebnis deine Inhalte als Web-Ansicht bereitgestellt haben.

Voraussetzungen

• Du hast einen Account auf openCode
• Du hast die notwendigen Berechtigungen, um ein neues Projekt zu erstellen
• Du hast dir eines der Beispielprojekte ausgesucht:
  • Markdown zu KERN-UX-Webseite: https://gitlab.opencode.de/open-code/werkzeugkasten/easywebsite/markdown-zu-kern-ux-webseite.git
  • Markdown zu Bundes-Webseite: https://gitlab.opencode.de/open-code/werkzeugkasten/easywebsite/markdown-zu-bundes-webseite.git

1. Projekt aus Template erstellen

1. Melde dich bei openCode an
2. Klicke auf New Project
3. Wähle die Kachel Import project aus
4. Klicke auf 🔗 Repository by URL
5. Füge unter Git repository URL den Git-Link des Beispielprojekts von oben ein
6. Benenne optional das Projekt um oder passe den Projekt-Pfad an
7. Passe optional die Sichtbarkeit an (beachte die openCode Richtlinien zu nicht öffentlichen Projekten)
8. Klicke auf Create project

Du hast nach diesem Schritt ein einsatzbereites Projekt mit den für dich vorkonfigurierten easyWebsite angelegt. In dem Projekt findest du verschiedene Beispieldateien die dir zeigen, wie du die Tools nutzen kannst.

2. Erste Pipeline ausführen

Nachdem du auf Basis des Muster-Projekts ein neues Projekt erstellt hast, kannst du die erste Pipeline ausführen (das passiert nach dem Erstellen leider nicht automatisch). Die Pipeline erzeugt deine Webseite und stellt dieses automatisch bereit.

1. Navigiere in der linken Seitenleiste unter Build zu Pipelines
2. Klicke auf New pipeline
3. Lasse den Branch auf main eingestellt, füge keine Variablen hinzu
4. Klicke auf New pipeline, um die Pipeline zu starten
5. Die Pipeline ist nun im Status pending oder running
6. Sobald die Stages build und deploy in den Status success (grüner Haken) wechseln, steht die Web-Ansicht zur Verfügung
   1. Navigiere zur Startseite deines Projekts
   2. Klicke rechts in der Seitenleiste auf den Link GitLab Pages

3. Anpassungen vornehmen

Du hast jetzt die erste Pipeline erfolgreich ausgeführt und dein Ausgabeformat erhalten. Du kannst nun die Inhalte anpassen. Jede Änderung (Commit) löst automatisch eine neue Pipeline aus.

openCode bietet dir zum Bearbeiten der Inhalte eine Web-IDE an. Diese kannst du über den Button Edit aufrufen.