Utente:Salvatore Ingala/scripts/Commandline/Manuale completo

Versione del 19 mar 2007 alle 00:11 di Salvatore Ingala (discussione | contributi) (inizio manuale completo)
(diff) ← Versione meno recente | Versione attuale (diff) | Versione più recente → (diff)

Questa pagina contiene la documentazione completa della Commandline, per gli usi avanzati.

Sintassi generale

I comandi della commandline hanno il seguente formato:

comando#parametro1#parametro2#...#parametro_n

Il numero di parametri è fisso per ogni comando. Alcuni comandi (pochi, per ora) supportano anche dei modificatori che si possono aggiungere al comando:

comando/modificatore1/modificatore2/...#parametro1#...

È possibile concatenare più comandi, usando, come al solito, # come separatore.

Chiamerò tutto il contenuto compreso tra due caratteri # con il termine blocco. Un blocco può quindi essere indifferentemente un comando o un parametro.

Le variabili ed il processore

La commandline può salvare delle variabili e utilizzarne il valore in qualsiasi momento.

Alcune variabili sono già predefinite, mentre si può impostarne di nuove con il comando setvar

Per richiamare il valore di una variabile di nome foo, si usa $$foo. Il processing avviene implicitamente solo una volta (contemporaneamente su tutta la riga) al momento dell'inizio dell'esecuzione, in genere quando si batte invio dopo aver digitato un comando (o una serie di comandi) nella commandline (più avanti sarà descritta un'altra possibile modalità). Tuttavia è possibile forzare in qualunque momento una ulteriore fase di processing, con diversi modi:

Se ci sono più di 2 caratteri $, allora il processing si limita a toglierne uno. Ciò consente di ritardare l'effettiva sostituzione del valore della variabile.

Le variabili predefinite

Sono state inserite alcune variabili predefinite di comune utilizzo:

  • title = titolo della pagina (con "_" al posto di " "... buono per i link)
  • plaintitle = titolo pulito della pagina (con gli spazi al posto giusto... utile per visualizzare il nome di una pagina in un "formato pulito")
  • currentyear = anno corrente
  • currentmonthname = nome del mese corrente
  • currentmonth = numero del mese corrente (iniziando da 1 per gennaio)
  • currentday = numero del giorno corrente