Fertig
Neues Handbuch erstellen
- Fork Project
- Remove fork relationship
- Projekt verschieben
- Branches löschen
- Repository klonen
- Inhalte löschen
- Dateien bearbeiten
- IT fragen
Fork Project
Der einfachste Weg ein neues Handbuch zu erstellen ist, einen Fork eines bestehenden Handbuches zu machen. In diesem Beispiel wurde ein Fork des Handbuch-Handbuches gemacht, um ein Handbuch für “DP” zu erstellen.
Fork bedeutet, dass eine Abzweigung erstellt wird. Das Original bleibt bestehen und es gibt daneben einen Zweig, der die selbe Basis hat, sich aber ab dem Moment der Abzweigung unterschiedlich entwickelt.
Auf der Übersichtsseite des Handbuches in Git gibt es ganz rechts neben der Überschrift den Button Fork.
Wird darauf geklickt, öffnet sich ein Fenster, in dem ein Project name festgelegt wird. Die Project URL ist, je nach Rechten, zunächst der eigene Bereich. Das wird in einem weiteren Schritt geändert. Project slug ist der Ordner, in dem das Projekt liegt. Bei Visibility level kann in diesem Beispiel nur Private ausgewählt werden. Auch das wird später angepasst.
Mit Klick auf Fork project wird das Projekt angelegt.
Remove fork relationship
Als nächstes wird durch das Entfernen der Beziehung zum Ausgangsprojekt das neue Projekt eigenständig gemacht.
Ganz unten im Menü befindet sich unter Settings im Menüpunkt General, wenn Advanced erweitert ist, die Karte Remove fork relationship.
Nach einem Klick auf den Button Remove fork relationship öffnet sich ein Dialog, wo zur Bestätigung die Project slug eingegeben wird.
Danach kann mit einem Klick auf Confirm die Beziehung gelöst werden.
Projekt verschieben
Im nächsten Schritt wird das Projekt in den öffentlichen Bereich umgezogen. Der Menüpunkt Transfer project befindet sich auch unter Settings, General, Advanced in der Karte Tranfer project.
Im Dropdown muss der Bereich handbuecher (unter Starke Software GmbH) ausgewählt werden.
Durch einen Klick auf den Button Transfer project wird der Umzug angestoßen. Auch hier ist eine Bestätigung in Form des Projektnamens erforderlich.
Branches löschen
Danach muss noch ein bisschen aufgeräumt werden. Als erstes können alle Branches gelöscht werden.
Unter Repository, Branches können alle aktiven, mit Ausnahme des Branches develop, gelöscht werden.
Der Branch master bleibt bestehen.
Repository klonen
Die weiteren Änderungen werden am besten in Atom auf dem Computer durchgeführt. Dazu wird das Repository geklont, wie auch Hier (für PC) oder Hier (für Mac) beschrieben.
Zur Erinnerung: In Git auf der Startseite des Projektes neben der Überschrift auf Clone und dann bei Clone with HTPPS auf Copy URL klicken.
Dann in Sourcetree auf dem PC Clone bzw. auf dem Mac auf Neu und dann auf Von URL klonen klicken.
Und dann bei Quell-URL die aus Git kopierte Adresse einfügen, ggf. den Zielpfad anpassen und auf Klone klicken.
Inhalte löschen
Jetzt muss das neue Handbuch aufgeräumt werden. Dazu werden in Atom alle Ordner gelöscht, die Inhalte enthalten, die nichts mit dem neuen Handbuch zu tun haben.
Dazu alle Ordner mit gedrückter cmd- bzw. Strg-Taste auswählen. Durch einen Rechtsklick öffnet sich ein Kontextmenü, in dem Delete geklickt werden muss.
Danach muss der Vorgang mit einem Klick auf Move to Trash bestätigt werden.
Dateien bearbeiten
Dann müssen noch einige Dateien angepasst werden; dabei geht es um Überschriften und Pfade, die in folgenden Dateien angepasst werden müssen:
- .gitlab-ci.yml
- _config.yml
- _config_local.yml
- .idea/modules.xml
Außerdem müssen folgende Dateien neu erstellt und richtig eingebunden werden:
- favicon.ico
- files/[Name-des-Handbuches].png
- .idea/[Name-des-Handbuches].iml
Die erforderlichen Änderungen ergeben sich aus dem Kontext, z.B. wird der Title Handbuch Handbuch in diesem Beispiel zu Digitale Praxis Handbuch.
IT fragen
Lokal kann jetzt alles bearbeitet werden. Die Pipeline bei Git läuft aber nicht durch. Kurze Frage an die IT behebt das Problem auf mirakulöse Weise.