Generalities

The general format of JSON configuration files is the following:

[
    {
        "key_1": value_1,
        "key_2": value_2,
        ...
        "key_N": value_N
    },
    ...
    {
        "key_1": value_1,
        "key_2": value_2,
        ...
        "key_N": value_N
    }
]

NB:

  • the file must be encoded in utf-8

  • the whole file is included between square brackets [ ... ]

  • each entry of the list is included between braces { ... } and separated from the next by a coma

  • each entry contains a list of key–value pairs separated by comas, in an arbitrary order

  • key and value are separated by a colon :

  • the key is always a string between double quotation marks "..."

  • the value may be a string between double quotation marks, or one of the Boolean keywords true and false

  • inside each string, the backslash \ and the double quotation marks " must be preceded (“escaped”) by a backslash; line break and tabulation are obtained with \n and \t respectively; the notation \uDDDD (where each D represents a digit) is accepted for Unicode characters.

  • Certain keys have a default value and are thus optional; the others are compulsory.