Einstieg, um Inhalte redaktionell zu erstellen

Du findest auf dieser Seite eine Anleitung die dich von der Auswahl des passenden Beispielprojekts als Vorlage bis zu den ersten Anpassungen deiner Seite und der Veröffentlichung erster Inhalte begleitet.

Ein Projekt aus einer Vorlage erstellen

Voraussetzungen

Du hast einen Account auf openCode
Du hast die notwendigen Berechtigungen, um ein neues Projekt zu erstellen

Um eigene Inhalte erstellen zu können, solltest du mit dem Erstellen und der Syntax von MDX-Dateien und YAML-Dateien vertraut sein.

1. Auswahl eines Beispielprojekts

Auf openCode stellen wir dir Beispielprojekte zur Verfügung, die du direkt kopieren und für deine eigenen Inhalte nutzen kannst. Diese Projekte ermöglichen es dir, mit minimalem Aufwand professionelle Ergebnisse zu erzielen.

Du musst dich nun zunächst zwischen zwei Beispielprojekten entscheiden. Auf Basis dieses Projekts wird dann später deine Webseite entstehen. Nimm dir daher Zeit und schaue dir die beiden Varianten zunächst einmal genauer an.

Im nächsten Schritt wirst du dann auf der Grundlage diese Vorlage ein neues Projekt erstellen.

Generieren Sie aus Markdown-Dateien eine barrierefreie Webseite im offiziellen KERN-UX Design. Inklusive Feedback-Optionen für Konsultationen und Self-Assessment-Tools.

Generieren Sie aus Markdown-Dateien eine barrierefreie Webseite im Bundes-Design. Ideal für Bundesbehörden und -institutionen.

2. Projekt auf GitLab erstellen und importieren

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

3. 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.

Navigiere in der linken Seitenleiste unter Build zu Pipelines
Klicke auf New pipeline
Lasse den Branch auf main eingestellt, füge keine Variablen hinzu
Klicke auf New pipeline, um die Pipeline zu starten
Die Pipeline ist nun im Status pending oder running
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

4. 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.

Menü