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:


 * Direttive: sono parole spesso scritte in maiuscolo circondate da doppi caratteri di sottolineatura, ad es.  .
 * 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  , es. . Vedi anche e.

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.

Direttive
Una direttiva controlla l'impaginazione o il comportamento della pagina (se supportato dalla skin) e può spesso essere utilizzato per specificare le omissioni e le inclusioni desiderate nel contenuto. In particolare alcuni di questi non sono supportati dalla skin Minerva.

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 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.

L'uso di queste variabili causa la memorizzazione nella cache delle pagine per un numero limitato di secondi. Questo è configurato in MagicWordFactory

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.



Per una formattazione dell'orario più completa, o per produrre l'anno e la settimana in corso con una migliore conformità con ISO-8601 puoi installare per utilizzare la funzione parser .

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  ). Si applica anche al di cui sopra.

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
Nessuno di questi è influenzato dalle modifiche apportate al titolo di visualizzazione con ; i valori restituiti sono il titolo originale della pagina.

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

A partire da 1.15+, tutti questi possono prendere un parametro, consentendo la specificazione della pagina su cui operare, invece della sola pagina corrente:



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 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 1.15+, 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; 
 * &rarr;  (Pages in main space will return empty)
 * &rarr; 
 * &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.

Varie
Per le funzioni function #invoke, vedere w:Wikipedia:Lua.