Argomento precedente: Requisiti generali

Argomento successivo: Citazione con metacaratteri nei file di configurazione


Stili di markup

Markup incorporato

$$prop: val1 : name1 , val2 : name2 , ...

La presenza di una stringa $$prop: su una riga di testo nel file di configurazione vuol dire che questa linea contiene uno o più valori della proprietà. Di solito, la stringa $$prop: e il resto della riga di testo vengono resi invisibili all'applicazione che utilizza questo file di configurazione facendolo sembrare un commento. Ad esempio, se il file di configurazione è uno script di Perl, questo può essere visualizzato come:

$port = 3306 # $$prop: 3306:ip_port

Le coppie val:name dopo la stringa dell'identificatore di markup vengono interpretate come segue:

val1:name1 indica che la prima occorrenza della stringa val1 su questa riga deve essere considerata come il valore della proprietà name1 e deve essere sostituita quando è necessario modificare tale proprietà.

val2:name2 indica che la prima occorrenza della stringa val2 successiva alla prima occorrenza di val1 rappresenta il valore della proprietà name2.

etc.
Se il nome in una coppia val:name è rappresentato dalla stringa "-", la stringa val viene semplicemente ignorata. Si utilizza per ignorare parti dei dati di configurazione che altrimenti potrebbero corrispondere a un valore della proprietà, ad esempio un markup di questo tipo:

x1 = 1 # $$prop: 1:val 

Fa sì che l'1 in x1 venga considerato il valore della proprietà val. Per rendere la stringa 1 che segue il segno di = il valore della proprietà, il markup deve essere:

x1 = 1 # $$prop: 1:-, 1:val 

Il nome della proprietà speciale "-" è utilizzato anche se il valore della proprietà corrisponde alla stringa vuota; ad esempio, nel markup seguente, la proprietà è la stringa vuota che segue la stringa "x1 = ":

x1 = #$$prop: "x1 = ":- , "":val 

Se un valore contiene caratteri di punteggiatura che sono parte della sintassi di markup (due punti, virgola, spazio), è necessario racchiudere il valore tra virgolette mediante la sintassi delle virgolette doppie definita per i file del descrittore ADL.

Markup della riga successiva
$$propN: val1 : name1 , val2 : name2 , ... [$$] 

Questo markup viene utilizzato per i file di configurazione che non consentono la visualizzazione del testo dei commenti nella stessa riga del valore che deve essere esposto come proprietà modificabile. È simile alla sintassi incorporata, ma indica che è necessario cercare stringhe corrispondenti nel testo della riga successiva a quella in cui viene visualizzato il markup, non della riga corrente.

Markup per file che non sono orientati in base alla riga
$$propF: val1 : name1 , val2 : name2 , ... $$ 

Questo markup viene utilizzato per file di configurazione in cui il carattere di nuova riga non viene considerato differente da altri spazi vuoti e gli aggiornamenti del file possono provocare l'aggiunta o la rimozione nei punti in cui è presente uno spazio vuoto non racchiuso tra virgolette. Per questo tipo di markup, è necessaria una sequenza di chiusura $$ per indicare la fine dell'elenco di coppie val:name. Le nuove righe sono consentite tra le coppie val:name. Tutto il testo dopo il contrassegno di chiusura $$, a prescindere dalle nuove righe, viene sottoposto a ricerca per identificare stringhe corrispondenti ai valori fino a trovare tutti i valori, oppure fino alla lettura di 1 KB di testo per ciascuna coppia val:name (se quest'ultima avviene senza trovare tutti i valori, viene segnalato un errore). Ciascun valore della proprietà deve comunque trovarsi su una riga singola.