Help:Magic words/it

Le parole magiche sono stringhe di testo che MediaWiki associa con un valore restituito o una funzione, come l'orario, i dettagli sul sito o i nomi di pagina. Questa pagina spiega solamente le parole magiche standard; per un riferimento tecnico, vedi.

Ci sono tre tipi generali di parole magiche:


 * Parametri di comportamento: sono parole in maiuscolo circondate da doppi caratteri di sottolineatura, ad es. __FOO__.


 * Variabili: sono parole in maiuscolo circondate da doppie parentesi graffe, ad es.  . In quanto tali, assomigliano molto ai template.


 * Funzioni parser: prendono dei parametri e sono nella forma   o  . Vedi anche.

Le variabili e le funzioni parser possono utilizzare subst:, proprio come i template. Le parole magiche dipendenti dalla pagina influenzeranno o restituiranno i dati sulla pagina corrente (per impostazione predefinita), anche se la parola viene aggiunta tramite un template transcluso o un messaggio di sistema incluso.

Parametri di comportamento
Un parametro di comportamento controlla l'impaginazione o il comportamento della pagina e può spesso essere utilizzato per specificare le omissioni e le inclusioni desiderate nel contenuto.

Variabili
Le variabili restituiscono informazioni sulla pagina, sul wiki o sulla data correnti. La loro sintassi è simile ai template. Le variabili contrassegnate come " [costoso] " sono tracciate dal software, e il numero che può essere incluso in una pagina è limitato.

Se il nome di un template è in conflitto con una variabile, verrà utilizzata la variabile (quindi per transcludere il template    :PAGENAME dovresti scrivere  ). In alcuni casi, l'aggiunta di parametri forzerà il parser a invocare un template; per esempio,  transclude     :CURRENTDAYNAME, non la variabile.

Data e ora
Le seguenti variabili restituiscono la data e l'ora correnti in UTC.

A causa della memorizzazione nella cache di MediaWiki e del browser, queste variabili frequentemente mostrano quando la pagina è stata "memorizzata nella cache" piuttosto che l'ora corrente.

Le parole magiche per la data e l'ora sono formattate nella lingua del contenuto del wiki. A partire da, dipendono dalla lingua del contenuto della pagina.

Le seguenti variabili fanno la stessa cosa delle precedenti, ma utilizzando la configurazione del server del sito o $wgLocaltimezone.

Per una formattazione dell'orario più completa, puoi installare per utilizzare la funzione parser #time.

Metadati tecnici
Nota: Le variabili di revisione restituiscono i dati sulla modifica più recente alla pagina corrente, anche se si sta visualizzando una versione più vecchia della pagina.

Statistiche
I numeri restituiti da queste variabili normalmente contengono dei separatori (virgole, punti o spazi, a seconda della lingua locale), ma possono restituire numeri grezzi con il flag ":R" (per esempio,  &rarr;  e   &rarr; ).

Utilizza "|R" per le parole magiche che richiedono un parametro come PAGESINCATEGORY (per esempio  e , oppure   e  ). Applicabile anche a  in precedenza.

Le parole magiche numeriche sono formattate nella lingua del contenuto del wiki. A partire da, dipende dalla lingua del contenuto della pagina.

Nomi di pagina
Le parole magiche  e   funzionano solo nei namespace che hanno le sottopagine attive. Vedi per informazioni sull'attivazione delle sottopagine.

A partire da, tutti questi possono prendere un parametro, consentendo la specificazione della pagina su cui operare, invece della sola pagina corrente:
 * &rarr; 

I titoli di pagina contenenti certi caratteri, come apostrofi  o asterischi , possono produrre dei risultati imprevisti quando controllati con queste parole magiche, ad es. . Vedi i bug, , e. Un modo semplice per correggere ciò è avvolgere il nome di pagina in  dall'estensione ParserFunctions.

Per esempio, se il nome di pagina è "L'Aquila", il seguente codice produrrà la stringa "Numeric char encoding":

Nomi di pagina in codifica URL
Le seguenti variabili sono gli equivalenti codificati per l'utilizzo negli URL di MediaWiki (ad es. spazi sostituiti con caratteri di sottolineatura e alcuni caratteri preceduti da caratteri di escape HTML utilizzando la codifica a caratteri numerici):



Nota che,   e   hanno implementazioni distinte. Vedi Manual:PAGENAMEE encoding per i dettagli.

Namespace
Le seguenti variabili sono gli equivalenti codificati per l'utilizzo negli URL di MediaWiki (spazi sostituiti con caratteri di sottolineatura e alcuni caratteri in codifica percentuale):



A partire da, possono prendere un parametro a nome di pagina completo e restituiranno il namespace richiesto associato con quella pagina, anziché con la pagina corrente:

Il parametro non deve essere il nome di un namespace:
 * &rarr;  (Pages in main space will return empty)
 * &rarr; 
 * &rarr; 
 * &rarr; 
 * &rarr;   (Empty)

Funzioni parser
Le funzioni parser sono molto simili alle variabili, ma prendono uno o più parametri (tecnicamente, qualsiasi parola magica che prende un parametro è una funzione parser), e il nome è qualche volta preceduto da un cancelletto per distinguerle dai template.

Questa pagina descrive solo le funzioni parser che sono parti integranti del software MediaWiki. Altre funzioni parser possono essere aggiunte da estensioni di MediaWiki come. Per quelle vedi.

Namespace
restituisce il nome localizzato corrente per il namespace con quell'indice, nome canonico o alias locale. Perciò,   e   (un vecchio nome per il namespace File) restituiscono tutti "    ". Su un wiki dove la lingua del contenuto è il francese, è anche valido, ma   (la localizzazione di "File" in tedesco) non lo è.

è l'equivalente codificato per gli URL di MediaWiki. Fa la stessa cosa, ma sostituisce gli spazi con i caratteri di sottolineatura, rendendolo utilizzabile nei collegamenti esterni.

Non confondere i namespace localizzati con i namespace personalizzati.

Formattazione
Vedi anche:.

Localizzazione
Ecco le parole magiche che sono usate come principali strumenti di localizzazione. Altre parole magiche spesso dipendono dalle impostazioni locali e dalla configurazione del wiki o dalla lingua scelta: vedi in particolare #Data e ora, #Formattazione, #Varie. Altre parole magiche sono aggiunte da.

L'utilizzo di queste parole magiche può essere molto complesso, e la documentazione è attualmente incompleta; c'è qualche altra informazione su PLURAL, GRAMMAR, GENDER.

Modificatori di transclusione
di solito transclude un'altra pagina, dal namespace Template per impostazione predefinita. Queste parole magiche modificano quel comportamento.