Fertig
Installation am PC
- Jekyll-Installation
- Eingabeaufforderungs-Befehle
- Installation und Einrichtung Sourcetree
- Sourcetree Repository klonen
- Installation Atom
- Atom-Erweiterungen
Jekyll-Installation
Folgende Schritte müssen durchgeführt werden:
1. Download RubyInstaller https://rubyinstaller.org/ (Ruby+Devkit 2.6.X (x64) - Stand: 25.08.2020).
2. rubyinstaller-devkit-2.6.6-1-x64.exe installieren (immer durch Eingabe bestätigen).
Nach dem letzten Bestätigen, schließt sich das Installationsfenster.
3. Die Installation von Jekyll erfolgt in der Eingabeaufforderung.
Eingabeaufforderung: gem install jekyll bundler
In den nächsten Minuten werden viele Zeilen Code angezeigt.
4. Atom öffnen -> Rechtsklick oben links auf den Projekt-Ordner (z.B. sp-handbuch) -> Open folder in CMD
5. Eingabeaufforderung: bundle install
6. Eingabeaufforderung schließen
Eingabeaufforderungs-Befehle
Der Vollständigkeitshalber sind diese Befehle hier aufgeführt, sie spielen aber bei der täglichen Arbeit keine Rolle.
In der Eingabeaufforderung 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 mit darauf folgender Eingabe von J (Vorgang 2x wiederholen) 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
Download SourceTree von https://www.sourcetreeapp.com/.
SourceTreeSetup-3.3.9.exe (bzw. neuer) installieren.
Überspringen.
Git reicht.
Git wird herunter geladen.
Weiter.
Irgendwas eintragen - auch gerne den richtigen Namen und die Firmen-Mail.
Nein.
Sourcetree Repository klonen
Im Programm klicken auf Datei > Klonen / Neu oder auf Clone klicken
Die erste Eingabe Quellpfad / URL kann aus Git kopiert werden.
Blauer Button rechts Clone, dann Copy URL
Beim Handbuch von SP ist das die folgende Adresse:
https://git.buchner.de/starkesoftwaregmbh/sp-handbuch.git
Nach der Eingabe des Quellpfades öffnet sich das folgende Fenster.
manager und Always use from now on auswählen und Select klicken.
Dann die Git-Zugangsdaten eingeben.
manager und Always use from now on auswählen und Select klicken (zum zweiten Mal).
In die zweite Zeile Zielpfad den Pfad eintragen, in dem das Handbuch auf dem Rechner liegen soll. SourceTree schlägt einen Ordner in den Dokumenten vor
(C:\Users\username\Documents\sp-handbuch), es ist aber auch ein anderer Pfad denkbar, z.B.
C:\Users\username\dev\sp-handbuch
username ist natürlich durch den eigenen Namen zu ersetzen.
Dann auf Klone klicken.
Installation Atom
https://atom.io/ - > Download
AtomSetup-x64.exe installieren.
Die folgende Meldung mit Yes, Always bestätigen.
Atom-Erweiterungen
Einige Erweiterungen bzw. Packages sollten installiert werden, um das Arbeiten zu erleichtern.