Help:Parole magiche

Nota: Se modifichi questa pagina, certifichi che stai rilasciando il tuo contributo sotto licenza CC0. Vedi le pagine di aiuto sul dominio pubblico per maggiori informazioni. Edit · Translate

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 Manual:Magic words.

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. {{FOO}}. In quanto tali, assomigliano molto ai template.

• Funzioni parser: prendono dei parametri e sono nella forma {{foo:...}} o {{#foo:...}}. Vedi anche Aiuto:Estensione:ParserFunctionsHelp:Extension:ParserFunctions.

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[edit]

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[edit]

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 Template:PAGENAME dovresti scrivere {{Template:PAGENAME}}). In alcuni casi, l'aggiunta di parametri forzerà il parser a invocare un template; per esempio, {{CURRENTDAYNAME|x}} transclude Template:CURRENTDAYNAME, non la variabile.

Data e ora[edit]

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

• {{LOCALYEAR}}
• {{LOCALMONTH}}
• {{LOCALMONTH1}}
• {{LOCALMONTHNAME}}
• {{LOCALMONTHNAMEGEN}}
• {{LOCALMONTHABBREV}}
• {{LOCALDAY}}
• {{LOCALDAY2}}
• {{LOCALDOW}}
• {{LOCALDAYNAME}}
• {{LOCALTIME}}
• {{LOCALHOUR}}
• {{LOCALWEEK}}
• {{LOCALTIMESTAMP}}

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

Metadati tecnici[edit]

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[edit]

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, {{NUMBEROFPAGES}} → 544 381 e {{NUMBEROFPAGES:R}} → 544381).

Utilizza "|R" per le parole magiche che richiedono un parametro come PAGESINCATEGORY (per esempio {{PAGESINCATEGORY:Help}} e {{PAGESINCATEGORY:Help|R}}, oppure {{PAGESINCATEGORY:Help|subcats}} e {{PAGESINCATEGORY:Help|subcats|R}}). Applicabile anche a {{PAGESIZE:nomepagina}} in precedenza.

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

Nomi di pagina[edit]

Le parole magiche {{BASEPAGENAME}} e {{SUBPAGENAME}} funzionano solo nei namespace che hanno le sottopagine attive. Vedi $wgNamespacesWithSubpages 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:

• {{PAGENAME:Template:Main Page}} → Main Page

Attenzione: I titoli di pagina contenenti certi caratteri, come apostrofi ' o asterischi *, possono produrre dei risultati imprevisti quando controllati con queste parole magiche, ad es. {{PAGESINCATEGORY:{{PAGENAME}}}}. Vedi i bug T16779, T18474, T37628 e T37746. Un modo semplice per correggere ciò è avvolgere il nome di pagina in {{#titleparts:}} dall'estensione ParserFunctions.

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

{{#switch:{{PAGENAME}}
| L'Aquila = No translation
| L = Not OK
| L'Aquila = Entity escaping
| L'Aquila = Numeric char encoding
}}

Nomi di pagina in codifica URL[edit]

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):

• {{FULLPAGENAMEE}}
• {{PAGENAMEE}}
• {{BASEPAGENAMEE}}
• {{SUBPAGENAMEE}}
• {{SUBJECTPAGENAMEE}}
• {{ARTICLEPAGENAMEE}}
• {{TALKPAGENAMEE}}
• {{ROOTPAGENAMEE}}

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

Namespace[edit]

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):

• {{NAMESPACEE}}
• {{SUBJECTSPACEE}}
• {{ARTICLESPACEE}}
• {{TALKSPACEE}}

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:

• {{NAMESPACE:MediaWiki}} → (Pages in main space will return empty)
• {{NAMESPACE:Template:Main Page}} → Template
• {{SUBJECTSPACE:Template:Main Page}} → Template
• {{TALKSPACE:Template:Main Page}} → Template talk

Il parametro non deve essere il nome di un namespace:

• {{SUBJECTSPACE:Help talk}} →   (Empty)

Altro[edit]

Funzioni parser[edit]

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 Estensione:ParserFunctionsExtension:ParserFunctions. Per quelle vedi Aiuto:Estensione:ParserFunctionsHelp:Extension:ParserFunctions.

Metadati tecnici di un'altra pagina[edit]

Dati degli URL[edit]

Namespace[edit]

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

{{nse:}} è 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[edit]

Vedi anche: Extension:StringFunctionsExtension:StringFunctions.

Localizzazione[edit]

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 Estensione:TranslateExtension:Translate.

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[edit]

{{Nome pagina|parametri facoltativi}} di solito transclude un'altra pagina, dal namespace Template per impostazione predefinita. Queste parole magiche modificano quel comportamento.

Varie[edit]