<?xml version="1.0" encoding="utf-8"?><!DOCTYPE article  PUBLIC '-//OASIS//DTD DocBook XML V4.4//EN'  'http://www.docbook.org/xml/4.4/docbookx.dtd'><article><articleinfo><title>AiutoSuVariabili</title></articleinfo><para>Questa pagina indica come usare le variabili all'interno delle pagine del wiki. L'uso di quest'ultime si rivela molto utile per i modelli di pagina, ma anche per le pagina &quot;normali&quot; (per esempio, quando si desidera firmare il proprio contributo). </para><section><title>Variabili predefinite</title><para>Le seguenti variabili vengono sostituite quando si salva la pagina. <emphasis role="strong">Durante l'anteprima non vengono sostituite.</emphasis> </para><informaltable><tgroup cols="3"><colspec colname="col_0"/><colspec colname="col_1"/><colspec colname="col_2"/><tbody><row rowsep="1"><entry colsep="1" rowsep="1"><para>Variabile </para></entry><entry colsep="1" rowsep="1"><para>Descrizione </para></entry><entry colsep="1" rowsep="1"><para>Esempio </para></entry></row><row rowsep="1"><entry colsep="1" rowsep="1"><para>@PAGE@ </para></entry><entry colsep="1" rowsep="1"><para>Nome della pagina (utile per i modelli) </para></entry><entry colsep="1" rowsep="1"><para>AiutoSuVariabili </para></entry></row><row rowsep="1"><entry colsep="1" rowsep="1"><para>@DATE@ </para></entry><entry colsep="1" rowsep="1"><para>Data corrente nel formato del sistema </para></entry><entry colsep="1" rowsep="1"/></row><row rowsep="1"><entry colsep="1" rowsep="1"><para>@TIME@ </para></entry><entry colsep="1" rowsep="1"><para>Data e ora corrente nel formato del sistema </para></entry><entry colsep="1" rowsep="1"/></row><row rowsep="1"><entry colsep="1" rowsep="1"><para>@ME@ </para></entry><entry colsep="1" rowsep="1"><para>Solo il nome dell'utente </para></entry><entry colsep="1" rowsep="1"><para><ulink url="http://research.math.uvt.ro/wiki/AiutoSuVariabili/wiki/MiloCasagrande#">MiloCasagrande</ulink> </para></entry></row><row rowsep="1"><entry colsep="1" rowsep="1"><para>@USERNAME@ </para></entry><entry colsep="1" rowsep="1"><para>Solo il nome dell'utente (o il suo indirizzo IP) </para></entry><entry colsep="1" rowsep="1"><para><ulink url="http://research.math.uvt.ro/wiki/AiutoSuVariabili/wiki/MoinMoin%3AMiloCasagrande#">MoinMoin:MiloCasagrande</ulink> </para></entry></row><row rowsep="1"><entry colsep="1" rowsep="1"><para>@USER@ </para></entry><entry colsep="1" rowsep="1"><para>Firma &quot;-- nome utente&quot; </para></entry><entry colsep="1" rowsep="1"><para>-- <ulink url="http://research.math.uvt.ro/wiki/AiutoSuVariabili/wiki/MoinMoin%3AMiloCasagrande#">MoinMoin:MiloCasagrande</ulink> </para></entry></row><row rowsep="1"><entry colsep="1" rowsep="1"><para>@SIG@  </para></entry><entry colsep="1" rowsep="1"><para>Firma con la data &quot;-- nome utente data ora&quot; </para></entry><entry colsep="1" rowsep="1"><para>-- <ulink url="http://research.math.uvt.ro/wiki/AiutoSuVariabili/wiki/MoinMoin%3AMiloCasagrande#">MoinMoin:MiloCasagrande</ulink> <!--The macro DateTime caused an error and should be blacklisted. It returned the data '2007-12-07 10:00:44' which caused the docbook-formatter to choke. Please file a bug.--> </para></entry></row><row rowsep="1"><entry colsep="1" rowsep="1"><para>@EMAIL@ </para></entry><entry colsep="1" rowsep="1"><para> Solo l'indirizzo email dell'utente, l'offuscamento può essere esteso </para></entry><entry colsep="1" rowsep="1"><para> test DOT user AT example dot com </para></entry></row><row rowsep="1"><entry colsep="1" rowsep="1"><para> @MAILTO@ </para></entry><entry colsep="1" rowsep="1"><para>Un simpatico collegamento mailto: con i dati utenti </para></entry><entry colsep="1" rowsep="1"><para>Nessuno, nei siti pubblici meglio usare la macro MailTo </para></entry></row></tbody></tgroup></informaltable></section><section><title>Espandere le variabili</title><para>Se le variabili interne non sono sufficenti, è possibile definirne delle nuove creando una sottopagina della propria pagina personale contenente un dizionario (consultare <ulink url="http://research.math.uvt.ro/wiki/AiutoSuVariabili/wiki/AiutoSuDizionari#">AiutoSuDizionari</ulink>) delle suddette nuove variabili. Per esempio, l'utente MarioRossi vorrà creare una pagina MarioRossi/MioDizionario con del contenuto simile a questo: </para><screen><![CDATA[ VAR1:: testo casuale 1
 VAR2:: testo casuale 2]]></screen><para>Successivamente, ogniqualvolta MarioRossi modifica una pagina, può usare <code>@VAR1@</code> o <code>@VAR2@</code> per espandere al testo i valori presenti in quel dizionario (notare che le linee in un dizionario devono iniziare <emphasis>esattamente</emphasis> con uno spazio). </para></section><section><title>Recuperare le variabili</title><section><title>Ognivolta che si aggiorna la pagina</title><para>È possibile usare questi valori attraverso la macro <code>GetVal</code>: </para><screen><![CDATA[<<GetVal(WikiDict,var1)>> <<GetVal(WikiDict,var2)>> <<GetVal(WikiDict,var3)>>]]></screen><para>Viene visualizzato come: </para><para>valore1 valore2 valore3 </para></section><section><title>Quando viene salvata la pagina</title><para>Se le variabili sono impostate in NomeUtente/MioDizionario (NomeUtente va sostituito col proprio nome utente) è possibile recuperare le variabili quando si salva la pagina con @var1@, @var2@, @var3@, ecc... al posto della macro <code>GetVal</code>. </para><!--rule (<hr>) is not applicable to DocBook--><para><inlinemediaobject><imageobject><imagedata depth="16" fileref="http://research.math.uvt.ro/wiki//static/moniker/img/alert.png" width="16"/></imageobject><textobject><phrase>/!\</phrase></textobject></inlinemediaobject> Notare che i dati nelle pagine dizionario sono memorizzati nella cache e quindi non è necessario aprire e analizzare la pagina per ciascun accesso al valore. Con CGI, il valore è recuperato da un <emphasis>pickle</emphasis> il quale, nei processi lunghi, viene caricato una sola volta e per di più, il valore è accessibile dalla memoria. </para><para><inlinemediaobject><imageobject><imagedata depth="16" fileref="http://research.math.uvt.ro/wiki//static/moniker/img/alert.png" width="16"/></imageobject><textobject><phrase>/!\</phrase></textobject></inlinemediaobject> Notare che salvare le pagine modello e usare l'anteprima non espande le variabili. Oltre a questo, l'espansione della variabili è globale e si verifica in qualsiasi punto della pagina, incluse tutte quelle aree speciali che potrebbero essere considerate escluse (per esempio, quelle destinate alla visualizzazione di codice, ai commenti, etc).  </para></section></section></article>