Installationsanleitung.markdown

 Dieses Makros soll ein konfliktfreies Arbeiten mit den Metadatentabellen in LibreOffice Calc ermöglichen.
 
 **Voraussetzungen:**
+
 1. LibreOffice Calc ist installiert
-  - Über das Puzzle-Symbol unten rechts in der Taskleiste zu finden unter *"Sonstige/Office/LibreOffice"*
+
+- Über das Puzzle-Symbol unten rechts in der Taskleiste zu finden unter _"Sonstige/Office/LibreOffice"_
+
 2. Das Makro **"DDI-2.0.3.oxt"** ist installiert
-  - Zu finden ist diese Datei im Repository unter *"Enter_DoR_metadata/LibreOffice/DDI-2.0.3.oxt"*.
+
+- Zu finden ist diese Datei im Repository unter _"Enter_DoR_metadata/LibreOffice/DDI-2.0.3.oxt"_.
 - Mit Rechtsklick --> installieren wird das Makro installiert.
 
 ## Einrichten des Makros in LibreOffice Calc:
@@ -12,30 +16,40 @@ Dieses Makros soll ein konfliktfreies Arbeiten mit den Metadatentabellen in Libr
 1. Extras Drop-down Menü ----> Anpassen öffnen (Tools > Customize)
 2. Symbolleisten wechseln
 3. bei "Kategorie" Makros auswählen (Category > Macro)
-4. rechte Spalte:  DDICSVfirstrow, DDICSVopen, DDICSVsave mit Häckchen       
+4. rechte Spalte: DDICSVfirstrow, DDICSVopen, DDICSVsave mit Häckchen\
    auswählen
 5. Einfügen --> Ok
 
 ## Umgang mit dem Makro:
 
-Durch das Öffnen einer csv-Datei mittels des Buttons **"DDICSVopen"** werden automatisch Einstellungen übernommen, die das Makro vorgibt. 
-Dadurch ist gewährleistet, dass Nutzer zum Bearbeiten einer Datei nicht unterschiedliche Codierungen und Trennungssymbole verwenden.
+Durch das Öffnen einer csv-Datei mittels des Buttons **"DDICSVopen"** werden automatisch Einstellungen übernommen, die das Makro vorgibt. Dadurch ist gewährleistet, dass Nutzer zum Bearbeiten einer Datei nicht unterschiedliche Codierungen und Trennungssymbole verwenden.
 
 Beim Abspeichern der csv-Tabelle ist darauf zu achten, dass bei erstmaliger Verwendung eines Speicherpfades das Makro **"DDICSVsave"** verwendet wird. Es stellt sicher, dass die Datei mit richtigen Einstellungen abgespeichert wird, um eventuellen Layoutänderungen vorzubeugen.
 
 ## Aktualisieren des Makros:
-1. Ggf. neue Version des Makros in das Repository *"Enter_DoR_metadata/LibreOffice/..."* herunterladen
+
+1. Ggf. neue Version des Makros in das Repository _"Enter_DoR_metadata/LibreOffice/..."_ herunterladen
 2. Rechtsklick auf die neue Version -> Installieren (das Makro wird installiert)
 3. Den automatisch öffnenden Fenstern folgen, bis Installation abgeschlossen ist
    - es öffnet sich eine Übersicht über aktuell installierte Makros
 4. Das veraltete Makro anklicken und deinstallieren -> danach LibreOffice neu starten
-5. Neue Makros wie zuvor in LibreOffice Calc aktivieren (siehe *Einrichten des Makros in LibreOffice Calc*)
+5. Neue Makros wie zuvor in LibreOffice Calc aktivieren (siehe _Einrichten des Makros in LibreOffice Calc_)
+
+## Was ist die Aufgabe des Makros?
+
+Es gibt keinen Standard für CSV-Dateien. Um sie »richtig« zu öffnen, muss bekannt sein, mit welchem Zeichensatz-Encoding gearbeitet wird, was die Spaltentrenner sind, wie mit Zellen umgeganegn werden soll, die den Spaltentrenner enthalten. Das Makro sichert in Zusammenarbeit mit einigen nicht zugänglichen Standardeinstellungen von Libre Office ab, dass die CSV-Dateien immer gleich geöffnet und gespeichert werden:
+
+* Zeichensatz: UTF-8
+* Spaltentrenner: Komma
+* Falls eine Zelle ein Komma enthält, werden quotes ("... , ...") verwendet. (Sonst nicht.)
+
+Wenn die Tabellen mit Skripten verarbeitet werden, können die Tabellen immer mit den gleichen Befehlen geöffnet werden und die diff-Ansichten in der Versionskontrolle sind aussagekräftig.
 
 ## Anmerkung zur Nutzung unter Linux
 
 Das Makro lässt sich installieren und ausführen. Allerdings stürzt es bei Verwendung von DDICSVsave ab mit folgender Fehlermeldung
 
-```
+```plaintext
 # A fatal error has been detected by the Java Runtime Environment:
 #
 #  SIGSEGV (0xb) at pc=0x00007f48a0e0c91b, pid=3348, tid=139950274517440