Schlüssel & Werte

Beispiel:

textcolor = "blue"

Konventionen

Ein Schlüssel-Wert-Paar muss immer in einer eigenen Zeile stehen. Dabei dürfen beliebig viele Leerzeichen vor, zwischen und nach Schlüssel und Wert stehen. Nach dem Schlüssel-Wert-Paar kann auch ein Kommentar (->Link) in derselben Zeile folgen.

font="Times" # Das ist eine klassische Schriftart
   size   =   "12" # Normale Schriftgröße

Mehrere Schlüssel-Wert-Paare in einer Zeile sind hingegen nicht erlaubt. Auch ein Zeilenumbruch ist bei einfachen Werten nicht möglich.

font = "Times" size = "12"   # Das ist eine klassische Schrift
font=
"Times"     # Das ist eine klassische Schriftart

Zeichensatz

Schlüssel können ohne Anführungszeichen geschrieben werden, wenn Sie ausschließlich den MINI-ASCII-Zeichensatz verwenden. Schlüssel in Anführungszeichen können den gesamten UTF-8 verwenden.

Werte (Zahlen) werden ohne Anführungszeichen angegeben und können dezimal, binär (führendes '0b') oder hexadezimal (führendes '0x') angegeben werden.

Werte (Strings) werden immer in Anführungszeichen geschrieben und können den gesamten UTF-8-Zeichensatz verwenden.

Beispiele

key1 = 1337      ;Dezimalwert
key2 = 0b101     ;Binärwert
key3 = 0xC001    ;Hexadezimalwert
key4 = "value1"  ;String-Wert

Arrays

Über einen Schlüssel können auch mehrere Werte in Form eines Arrays referenziert werden. Die Elemente des Arrays werden durch eckigen Klammern ('[' und ']') zusammengefasst und durch einen Komma (',') getrennt (Elementtrenner).

key1 = "value"                              ; Einzelwert
key2 = ["value1", "value2", 0xCAFE, 1337]   ; Array

Eingebettete Arrays

Jeder einzelne Wert in einem Array kann wiederum selbst ein Array sein. Auf diese Weise können auch geschachtelte Arrays verwendet werden.

key = ["value1", "value2", ["nested1", "nested2"]]   ; Array mit eingebettetem Array

Leerzeichen & Zeilenumbruch

Die einzelnen Elemente von Arrays können zur besseren Lesbarkeit sowohl durch Leerzeichen als auch durch Zeilenumbrüche getrennt werden. Dazu können zwischen zwei Elementen beliebig viele Leerzeichen oder auch Zeilenumbrüche eingefügt werden, jeweils vor oder nach dem Elementtrenner (','). Lediglich die erste öffnende Klammer ('[') muss in derselben Zeile stehen wie der Key.

Beispiel

key1 = [
          "value1",
          "value2",
          [
             "nested1",
             "nested2"
          ]
       ] 

Kommentare

Kommentare können wie üblich am Zeilenende oder in einer eigenen Zeile eingefügt werden. Bei Arrays gilt das für alle Zeilen, auch für Zeilenumbrüche innerhalb des Arrays.

Beispiel

key1 = [  #Start äußeres Array
          #Kommentar in der Leerzeile         
          "value1",       #erster Wert
          "value2",       #zweiter Wert
          
          #eingebettetes Array
          [  #Start inneres Array
             "nested1",
             "nested2"
          ]             #Ende inneres Array
#Kommentar am Zeilenanfang          
       ]                #Ende äußeres Array

Best Practices

Zur besseren Lesbarkeit wird empfohlen, innerhalb von Sektionen (->Link) Leerzeilen zur Gruppierung zu verwenden, führende Leerzeichen zur Einrückung sowie das Gleichheitzeichen ('=') zwischen Schlüssel und Wert mit je einem Leerzeichen abzutrennen. Bei Gruppierungen kann es sich zudem anbieten, die Gleichheitszeichen durch weitere Leerzeichen auszurichten.

font = "Times"
   size   = "12"
   color  = "red"
   weight = "light"

Für Schlüssel ist die Verwendung des MINI-ASCII Zeichensatzes empfehlenswert, weil dies die Lesbarkeit durch das Entfallen der Anführungszeichen erhöht. Da die Schlüssel nur zur Zuordnung der Werte verwendet werden, also in der Regel keinen anderen Anforderungen genügen müssen, kann auf Unicode meist ohne Probleme verzichtet werden.