In Bearbeitung
Arbeiten mit Atom
- Repository
- Vor der Arbeit
- Dateien bearbeiten
- Auto-Korrektur
- autocomplete-project-paths
- markdown-image-assistant
- Eingabehilfen
- Vorschau
- Nach dem Speichern
- Probleme
Repository
File > Open Folder und dann den Ordner auswählen, der in SourceTree angegeben wurde.
C:\Users\username\dev\sp-handbuch oder C:\Users\username\Documents\sp-handbuch
Vor der Arbeit
WICHTIG: Erster Schritt ist immer zu schauen, was sich auf dem Server geändert hat.
Im Atom unten rechts auf Fetch klicken.
Beim ersten Mal öffnet sich der Dialog zur Eingabe des Benutzernamens und des Passwortes.
Hier die Zugangsdaten für Git eingeben.
Dateien bearbeiten
Aus dem linken Menü eine Datei auswählen und dann im mittleren Bereich von Atom die Datei wie in einem Texteditor bearbeiten. Die Datei speichert sich nicht automatisch. Nach der Bearbeitung muss gespeichert werden.
Auto-Korrektur
Atom hat eine Auto-Korrektur, die alles mit roten Punkten unterlegt, was falsch geschrieben oder unbekannt ist. Sie kann im Menü unter Packages, am Unterpunkt Spell Check, mit Klick auf Toggle ausgeschaltet werden.
Standardmäßig ist die englische Auto-Korrektur angeschaltet. Die deutsche Sprache kann im Menü eingestellt werden unter File, Settings, Packages und dort das Package spell-check suchen (z.B. Suche nach spell). Im Package auf Settings klicken und bei Locales de-DE eintragen.
Unter Umständen ist ein Neustart nötig.
autocomplete-project-paths
Autovervollständigung in Links und Bildern
Beginnt die Link-Eingabe mit einem Punkt und Slash ./, werden alle Dateien und Ordner der gleichen Ebene vorgeschlagen. Beginnt sie mit Punkt, Punkt Slash ../, werden die Dateien der nächsthöheren Ebene vorgeschlagen. Die Navigation zum richtigen Eintrag erfolgt über die Pfeiltasten, mit der Eingabetaste wird die Auswahl übernommen. Dann werden die untergeordneten Objekte angezeigt, unter denen wiederum ausgewählt werden kann.
Bilder können genauso wie interne Links vorgeschlagen und ausgewählt werden.
markdown-image-assistant
Bilder ins Projekt ziehen
Liegt z.B. ein erstellter Screenshot, der richtig benannt ist (z.B. atom-create-repository.png), im Download-Ordner, muss der Cursor in Atom an der richtigen Stelle positioniert werden. Danach wird das Bild dann mit der Maus vom Download-Ordner in Atom in die Textdatei gezogen (Drag-and-drop).
Das Bild wird automatisch in den Ordner images gelegt (kopiert), wenn nötig wird dieser erzeugt, und der Markdown-Code wird geschrieben. Es muss nur noch die Beschreibung in eckigen Klammern [ ] eingegeben werden.
Eingabehilfen
Der Atom-Editor hilft bei der Eingabe. Hier sind die wichtigsten Kürzel beschrieben.
Bild einbinden
Zum Einbinden eines Bildes reicht es i (wie image) zu tippen. Es öffnet sich ein Kontextmenü aus dem embedded image ausgewählt werden kann. Atom positioniert den Cursor an der richtigen Stelle, sodass direkt die Beschreibung des Bildes eingegeben werden kann.
Mehr Informationen hier.
Link eingeben
Zum Einbinden eines Links reicht es l (wie link) zu tippen. Es öffnet sich ein Kontextmenü, aus dem link ausgewählt werden kann. Atom positioniert den Cursor an der richtigen Stelle, sodass direkt die Beschreibung des Links eingegeben werden kann.
Mehr Informationen hier.
Kursiver Text
Kursiver Text wird wie folgt eingegeben.
i -> mit Pfeiltasten auf italic text -> Eingabetaste -> hallo welt schreiben -> mit Pfeiltaste hinter das Sternchen navigieren -> weiter schreiben.
Fetter Text
Fetter Text wird wie folgt eingegeben.
b -> mit Pfeiltasten auf bold text -> Eingabetaste -> hallo welt schreiben -> mit Pfeiltaste hinter die Sternchen navigieren -> weiter schreiben
Kursiv-Fetter Text
Kursiv-Fetter Text wird wie folgt eingegeben.
i -> mit Pfeiltasten auf italic text -> Eingabetaste -> b -> mit Pfeiltasten auf bold text -> Eingabetaste -> hallo welt schreiben -> mit Pfeiltaste hinter die Sternchen navigieren -> weiter schreiben
Vorschau
Mit Hilfe der Erweiterung jekyll-atom, lässt sich sehr einfach eine Vorschau anzeigen.
Mehr unter: Seitenvorschau anzeigen
Nach dem Speichern
WICHTIG:
- Alle Dateien speichern
- Schauen, ob es auf dem Server Änderungen gibt
- Commit erstellen
- Pushen
Probleme
Das Pullen oder Pushen kann zu Fehlern (Merge-Konflikte) führen, die behoben werden müssen.
Mehr unter: Probleme mit Git
TODO: Anleitung Merge-Konflikte.