Fertig
Installation am Mac
- Installation Atom
- Jekyll-Installation
- Terminal-Befehle
- Installation und Einrichtung Sourcetree
- Sourcetree Repository klonen
- Einrichtung Atom
- Atom-Erweiterungen
Installation Atom
Software-Download von atom.io
Nach dem klick auf Download öffnet sich das Fenster, in dem das Herunterladen von Software von dieser Seite erlaubt werden muss. Danach wird die dmg-Datei in den Ordner Downloads kopiert.
Diese Software kopiert sich nicht automatisch in den Programme-Ordner, sondern muss manuell dahin verschoben werden. Dazu den Ordner Downloads im Finder öffnen und Atom per Drag-and-Drop nach links in den Ordner Programme ziehen.
Nach dem Programmstart muss mit Öffnen bestätigt werden, dass das, aus dem Internet geladene Programm geöffnet werden soll.
Danach möchte der Computer noch Developer Tools installieren.
Mit Installieren bestätigen (Dauert ca. 3 min). Dann die AGB Akzeptieren und nach der Installation mit Fertig bestätigen.
Atom kann jetzt erstmal geschlossen werden.
Jekyll-Installation
Die Installation von Jekyll und allem, was dafür benötigt wird, erfolgt im Terminal.
Als erstes
export SDKROOT=$(xcrun –show-sdk-path)
eingeben.
Notiz: Sollte es hier zu einer Fehlermeldung kommen, könnte es sein, dass diese Zeile nicht benötigt wird. Einfach mit der nächsten Eingabe fortfahren.
Danach
sudo gem install bundler
eingeben.
Da dieses Paket global installiert wird, muss in der Folge das Passwort des Macs eingegeben werden.
Danach mit
cd th-handbuch
in den Ordner th-handbuch wechseln.
Dort dann
bundle install
eingeben.
Während der Installation muss zwei mal das Mac-Passwort eingegeben werden.
Fertig.
Hinweis: Der M1 von Apple braucht noch ein wenig mehr, damit alles läuft. Im Terminal mit cd [Ordnername] in den entsprechenden Ordner wechseln und noch folgende Zeilen eingeben:
arch -x86_64 bundle install
arch -x86_64 sudo gem install ffi
arch -x86_64 sudo gem install sassc
und vielleicht
arch -x86_64 bundle update
Notiz: Beim Update des MacOS (z.B. auf Monterrey) auf dem M1 ist das erneute Ausführen folgender Schritte nötig. Im Terminal zunächst:
xcode-select –install
export SDKROOT=$(xcrun –show-sdk-path)
sudo gem install bundler
Dann mit cd [Ordnername] in den entsprechenden Ordner wechseln und noch folgende Zeilen eingeben:
arch -x86_64 bundle update
arch -x86_64 sudo gem install ffi
arch -x86_64 sudo gem install sassc
Terminal-Befehle
Der Vollständigkeitshalber sind diese Befehle hier aufgeführt, sie spielen aber bei der täglichen Arbeit keine Rolle.
In Terminal mit cd [Ordnername] in den entsprechenden Verzeichnisordner wechseln.
Lokale Vorschau
Die Seite erstellen und lokal zur Verfügung stellen:
bundle exec jekyll serve –config _config_local.yml
Danach in einem Browser in die Adresszeile http://localhost:4000/ eingeben (die Serveradresse wird auch im Eingabeaufforderungsfenster angezeigt).
Immer wenn eine Seite verändert und gespeichert (Strg + S) wird, ist die Änderung im Browser nach einem Reload (F5) sichtbar.
Das Erstellen der lokalen Vorschau wird mit Ctrl + C beendet.
Hinweis: Durch Nutzung des Packages jekyll-atom spielt die lokale Vorschau über die Eingabeaufforderung keine Rolle.
Statische Seite erzeugen
Statische Seite erzeugen: bundle exec jekyll build
Die Seite befindet sich dann im Ordner _site.
Installation und Einrichtung Sourcetree
Erst einmal wird Sourcetree installiert. Dafür das Installationsprogramm auf der Seite von Sourcetree herunter laden (sourcetreeapp.com).
Das Programm landet in Downloads und kann direkt dort geöffnet werden. Nach dem Bestätigen, dass es wirklich geöffnet werden soll, fragt das Programm, ob es in den Programmordner verschoben werden soll. Dort die Schaltfläche Move to Applications Folder klicken.
Beim Installieren muss nichts eingetragen werden. Erst Weiter und dann Fertig klicken.
Sourcetree Repository klonen
Im Sourcetree-Programmfenster auf Neu … klicken und dann auf Von URL klonen.
Die Eingabe Quellpfad / URL kann aus Git kopiert werden.
Blauer Button rechts Clone, dann Copy URL
Beim Handbuch vom TERMINHELD ist das die folgende Adresse:
https://git.buchner.de/starkesoftwaregmbh/handbuecher/th-handbuch
Nach der Eingabe des Quellpfades öffnet sich das Fenster Authentication Required. Hier die Login-Daten von git eintragen und das Häkchen Store Password In Keychain setzen. Mit OK bestätigen.
Die folgenden Eingabefelder werden automatisch ausgefüllt und sehen dann ungefähr wie folgt aus.
Damit ist die Installation und Ersteinrichtung von Sourcetree abgeschlossen.
Einrichtung Atom
Nach dem Öffnen von Atom die beiden Welcome-Screens schließen und bei Telemetry Consent No, do not send my usage data wählen.
Als nächstes auf Add Folder klicken und den Ordner th-handbuch auswählen.
Danach ist der Ordner auf der linken Seite zu sehen. Jetzt unten rechts auf Git (0) klicken und dann den eigenen Namen und die eigene E-Mail eintragen.
Mit Use for all repositories bestätigen. Danach öffnet sich ein Fenster, in dem man besonders das Häkchen nicht vergessen darf.
Hier die Zugangsdaten für git eintragen, das Häkchen Remember setzen und mit Sign in bestätigen.
Atom-Erweiterungen
Einige Erweiterungen bzw. Packages sollten installiert werden, um das Arbeiten zu erleichtern.