Ein Projekt aus einem Template erstellen
Diese Anleitung hilft dir, wenn du dein erstes Projekt mit easyPDF erstellen möchtest. Nach der Einrichtung mithilfe dieser Anleitung wirst du die notwendigen Dateistrukturen aufgesetzt haben, die wichtigsten Konfigurationen vorgenommen und im Ergebnis deine Inhalte als PDF/UA 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:
- easyPDF - Beispielprojekt:
https://gitlab.opencode.de/open-code/werkzeugkasten/easypdf/markdown-zu-pdf-ua.git
- easyPDF - Beispielprojekt:
1. Projekt aus Template erstellen
- 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 Document Writing Tools 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. Die Pipeline erzeugt das jeweilige Ausgabeformat und stellt dieses automatisiert 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 bei der Stage
artifact-generation
der Job `document-writing-ci-component:full-pdf“ in den Status success (grüner Haken) wechselt, kannst du die PDF/UA herunterladen- Klicke dafür auf den Job
document-writing-ci-component:full-pdf
- Klicke rechts in der Seitenleiste unter Job artifacts auf Download oder Browse
- Klicke dafür auf den Job
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.