Aiuto:Variabili

Da Wikipedia, l'enciclopedia libera.
Vai alla navigazione Vai alla ricerca

Sportello informazioni

Il software MediaWiki su cui si basa Wikipedia mette a disposizione un gruppo di variabili di sistema, che possono essere usate come parametri in qualsiasi pagina. Il valore di ciascuna variabile può dipendere dalla configurazione del sito, dalla data e ora di sistema, dalla pagina in cui ci si trova, o da una combinazione di queste informazioni.

L'uso delle variabili è analogo a quello dei template, anche dal punto di vista della sintassi: {{VARIABILE}}.

Nelle tabelle che seguono, la prima colonna contiene il nome della variabile, la seconda il risultato del suo utilizzo, sulla Wikipedia in italiano, su questa pagina e in questo momento. La terza colonna è una breve spiegazione del significato della variabile e di come può variare in altri contesti.

Variabili di progetto

[modifica | modifica wikitesto]

Le variabili descritte in questa sezione sono legate al singolo progetto Wikimedia e alla sua configurazione. Sono perciò da considerarsi delle costanti per la Wikipedia in italiano, a meno che non vengano apportate modifiche sostanziali nelle impostazioni del sito (correzione del nome di un namespace, spostamento dei server, ecc.).

Variabile di sistema Risultato Spiegazione
{{ns:-2}} o {{ns:Media}} Media Nome del namespace speciale -2
{{ns:-1}} o {{ns:Special}} Speciale Nome del namespace speciale -1
{{ns:1}} o {{ns:Talk}} Discussione Nome del namespace predefinito 1
{{ns:2}} o {{ns:User}} Utente Nome del namespace predefinito 2
{{ns:3}} o {{ns:User_talk}} Discussioni utente Nome del namespace predefinito 3
{{ns:4}} o {{ns:Project}} Wikipedia Nome del namespace predefinito 4
{{ns:5}} o {{ns:Project_talk}} Discussioni Wikipedia Nome del namespace predefinito 5
{{ns:6}} o {{ns:Image}} File Nome del namespace predefinito 6
{{ns:7}} o {{ns:Image_talk}} Discussioni file Nome del namespace predefinito 7
{{ns:8}} o {{ns:MediaWiki}} MediaWiki Nome del namespace predefinito 8
{{ns:9}} o {{ns:MediaWiki_talk}} Discussioni MediaWiki Nome del namespace predefinito 9
{{ns:10}} o {{ns:Template}} Template Nome del namespace predefinito 10
{{ns:11}} o {{ns:Template_talk}} Discussioni template Nome del namespace predefinito 11
{{ns:12}} o {{ns:Help}} Aiuto Nome del namespace predefinito 12
{{ns:13}} o {{ns:Help_talk}} Discussioni aiuto Nome del namespace predefinito 13
{{ns:14}} o {{ns:Category}} Categoria Nome del namespace predefinito 14
{{ns:15}} o {{ns:Category_talk}} Discussioni categoria Nome del namespace predefinito 15
{{ns:100}} Portale Nome del namespace personalizzato 100
{{ns:101}} Discussioni portale Nome del namespace personalizzato 101
{{ns:118}} Bozza Nome del namespace personalizzato 118
{{ns:119}} Discussioni bozza Nome del namespace personalizzato 119
{{ns:710}} TimedText Nome del namespace personalizzato 710
{{ns:711}} TimedText talk Nome del namespace personalizzato 711
{{SITENAME}} Wikipedia Nome del sito
{{SERVER}} //it.wikipedia.org URL del server che ospita le pagine
{{SERVERNAME}} it.wikipedia.org Nome del server che ospita le pagine
{{localurl:nome pagina}} /wiki/Nome_pagina URL locale della pagina specificata
{{localurl:nome pagina|query}} /w/index.php?title=Nome_pagina&query Come sopra, con parametro query
{{fullurl:nome pagina}} //it.wikipedia.org/wiki/Nome_pagina URL completa della pagina specificata
{{fullurl:nome pagina|query}} //it.wikipedia.org/w/index.php?title=Nome_pagina&query Come sopra, con parametro query
{{int:aboutsite}} Informazioni su Wikipedia Pagina interna specificata

Uso delle variabili localurl e fullurl

[modifica | modifica wikitesto]

Nel determinare il valore delle variabili localurl e fullurl, il parametro nome pagina viene interpretato e modificato in questo modo:

  • gli spazi vengono sostituiti da caratteri di sottolineatura (underscore, "_")
  • i caratteri speciali vengono sostituiti dai rispettivi codici di escape

Esempio: {{localurl:Famiglia (società)}} diventa: /wiki/Famiglia_(societ%C3%A0)

In tal modo è possibile usare la variabile localurl per creare direttamente un link esterno a una pagina dello stesso progetto, oppure a pagine di progetti analoghi che utilizzino URL della stessa forma per la parte compresa tra il nome del server e quello della pagina (nel caso dei progetti Wikimedia si ha "/wiki/" oppure "w/index.php?title=").

Note
  • il parametro nome pagina deve essere scritto senza codici di escape, in quanto questi ultimi vengono sempre aggiunti dal sistema. Ad esempio, per ottenere la URL corretta //it.wikipedia.org/wiki/Citt%C3%A0 è necessario scrivere nella pagina {{SERVER}}{{localurl:Città}}; se invece si scrive {{SERVER}}{{localurl:Citt%C3%A0}} si ottiene come risultato //it.wikipedia.org/wiki/Citt%C3%A0.
  • Quando si usano le variabili localurl e fullurl per fare riferimento a pagine che contengono la stringa "target=" seguita da nomi di pagine o di utenti, queste ultime informazioni non vengono convertite. In tal caso è necessario inserire le informazioni nella prima parte della variabile localurl, dopo il carattere "/".
  • Esistono anche le varianti localurle e fullurle, in cui la gestione dei caratteri di escape è leggermente diversa; tali varianti sono destinate ad uso interno del sistema e non devono essere usate nel testo delle pagine.

Uso della variabile int

[modifica | modifica wikitesto]

La variabile int (internal) viene usata per richiamare le pagine del namespace MediaWiki. Se l'utente ha selezionato nelle proprie Preferenze la lingua predefinita del progetto, usando la sintassi {{int:nomepagina}} verrà visualizzato il contenuto della pagina [[MediaWiki:Nomepagina]]. Se l'utente ha selezionato una lingua diversa, verrà visualizzato il contenuto della pagina [[MediaWiki:Nomepagina/codicelingua]] (ad es. [[MediaWiki:Nomepagina/fr]] per il francese), se esiste, altrimenti quello della pagina [[MediaWiki:Nomepagina]].

Variabili temporali

[modifica | modifica wikitesto]

Le variabili descritte in questa sezione sono legate alla data e ora del sistema, e variano di conseguenza.

Variabile di sistema Risultato Spiegazione
Anno
{{CURRENTYEAR}} 2024 Anno corrente in cifre
Mese
{{CURRENTMONTH}} 10 Mese corrente in cifre (01-12)
{{CURRENTMONTHNAME}} ottobre Mese corrente in lettere, per esteso
{{CURRENTMONTHABBREV}} ott Mese corrente in lettere, abbreviato
Giorno
{{CURRENTDAY}} 30 Giorno corrente in cifre (1-31)
{{CURRENTDAY2}} 30 Giorno corrente sempre a due cifre (01-31)
{{CURRENTDAYNAME}} mercoledì Giorno della settimana corrente
{{CURRENTDOW}} 3 Giorno della settimana corrente
in cifre (0 = domenica, ..., 6 = sabato)
Ora
{{CURRENTTIME}} 21:26 Ora corrente (UTC)
{{LOCALTIME}} 22:26 Ora corrente (vedi note)
{{CURRENTHOUR}} 21 Ora corrente senza i minuti (UTC)
{{LOCALHOUR}} 22 Ora corrente senza i minuti (vedi note)
Altro
{{CURRENTTIMESTAMP}} 20241030212623 Data e orario corrente ISO 8601
{{CURRENTWEEK}} 44 Settimana corrente in cifre (1-54)
Note
  • Quando viene usato un template contenente il comando di sostituzione subst (ad esempio {{subst:CURRENTDAY}}), nel testo della pagina viene inserito il valore corrente della variabile nel momento in cui il template viene utilizzato per la prima volta.
  • La variabile {{CURRENTTIME}} riporta il valore dell'ora UTC.
    • Per avere l'ora relativa ad it.wiki (CET = UTC+1, più una eventuale altra ora dovuta all'ora legale, come settato nelle proprie preferenze) è sufficiente utilizzare la variabile {{LOCALTIME}}.
    • Per l'ora relativa ad it.wiki (o ore di relative a fusi orari diversi, agendo sul valore del parametro hours) si può utilizzare anche la seguente Parser function: {{#time:H:i|+2 hours}}.
  • Oltre a {{LOCALTIME}} e {{LOCALHOUR}} esistono anche le altre variabili con LOCAL al posto di CURRENT ({{LOCALYEAR}} eccetera). Tali variabili, tuttavia, non vanno utilizzate praticamente mai perché corrispondono esattamente ai loro correlativi con CURRENT.

Numero di voci e statistiche

[modifica | modifica wikitesto]

La variabile NUMBEROFARTICLES indica in tempo reale il numero di pagine del namespace principale che contengono almeno un collegamento e non siano dei redirect. Coincide con il numero corrente di voci dell'enciclopedia, stub che contengono almeno un collegamento e pagine di chiarimento delle ambiguità. Esistono anche altre variabili per indicare il numero complessivo di pagine, il numero di amministratori, ecc.

È necessario aggiungere :R per avere il numero senza separatori delle migliaia (utile ad es. per calcoli).

Variabile di sistema Risultato Spiegazione
{{NUMBEROFARTICLES}} 1 888 892 Numero di voci contenute nel progetto
{{NUMBEROFPAGES}} 8 125 513 Numero di pagine complessivamente contenute nel progetto
{{NUMBEROFFILES}} 122 494 Numero di files caricati nel progetto
{{NUMBEROFEDITS}} 141 569 319 Numero di edits nel progetto
{{NUMBEROFUSERS}} 2 567 597 Numero di utenti registrati
{{NUMBEROFACTIVEUSERS}} 7 178 Numero di utenti attivi, basato sui criteri scritti in Speciale:Statistiche
{{NUMBEROFADMINS}} 120 Numero di amministratori del progetto

Variabili di pagina

[modifica | modifica wikitesto]
{{PAGENAME}}
({{PAGENAMEE}})
Restituisce il nome della pagina corrente (nel titolo la parte dopo i due punti (:))
{{NAMESPACE}}
({{NAMESPACEE}})
Restituisce il nome del namespace corrente (nel titolo la parte prima dei due punti (:))
{{NAMESPACENUMBER}} Restituisce il numero del namespace corrente (elenco)
{{FULLPAGENAME}}
({{FULLPAGENAMEE}})
Restituisce il nome completo della pagine corrente (come appare nel titolo)
{{BASEPAGENAME}}
({{BASEPAGENAMEE}})
Restituisce la prima parte del nome della pagina corrente (nel titolo la parte dopo i due punti (:) e prima dell'ultimo slash (/); funziona solo nei namespace in cui è attivata la sottopaginazione)
{{ROOTPAGENAME}}
({{ROOTPAGENAMEE}})
Restituisce il nome della "pagina radice" corrente (nel titolo la parte dopo i due punti (:) e prima del primo slash (/); funziona solo nei namespace in cui è attivata la sottopaginazione)
{{SUBPAGENAME}}
({{SUBPAGENAMEE}})
Restituisce il nome della sottopagina corrente (nel titolo la parte dopo l'ultimo slash (/); funziona solo nei namespace in cui è attivata la sottopaginazione)
  • {{FULLPAGENAME}}
    Es. Utente:Tuo Nome/A/B
  • {{NAMESPACE}}:{{PAGENAME}}
    Es. Utente : Tuo Nome/A/B
  • {{NAMESPACE}}:{{BASEPAGENAME}}/{{SUBPAGENAME}}
    Es. Utente : Tuo Nome/A / B

Le variabili NAMESPACEE, PAGENAMEE e FULLPAGENAMEE restituiscono i nomi delle pagine nel formato utilizzato nelle URL: gli spazi vengono sostituiti dai caratteri di sottolineatura (underscore, "_") e i caratteri speciali dai rispettivi codici di escape. Le corrispondenti pagine NAMESPACE, PAGENAME e FULLPAGENAME riportano invece i nomi delle pagine così come sono visualizzati. In combinazione con la variabile localurl è necessario utilizzare quest'ultima variante. (Si veda più oltre la sezione con gli esempi d'uso.)

Note
  • Nel caso di uso all'interno di un template, le variabili assumono il valore della pagina in cui il template viene utilizzato, non quello relativo al template.
  • Quando viene usato un template contenente il comando di sostituzione
{{subst:PAGENAME}} 
nel testo della pagina viene inserito il valore corrente della variabile nel momento in cui il template viene utilizzato per la prima volta.

Alternativi del NAMESPACE

[modifica | modifica wikitesto]
{{SUBJECTSPACE}}
({{SUBJECTSPACEE}})
Restituisce sempre il namespace principale della pagina corrente
{{TALKSPACE}}
({{TALKSPACEE}})
Restituisce sempre il namespace della pagina di discussione della pagina corrente
{{ARTICLESPACE}}
({{ARTICLESPACEE}})
Vedi {{SUBJECTSPACE}}

Se inserisci TALKSPACE in una pagina qualsiasi restituirà sempre il relativo namespace di discussione; se inserisci SUBJECTSPACE in una qualsiasi pagina di discussione restituirà il relativo namespace della pagina principale associata.

Alternativi del FULLNAMEPAGE

[modifica | modifica wikitesto]
{{SUBJECTPAGENAME}}
({{SUBJECTPAGENAMEE}})
Restituisce sempre {{SUBJECTSPACE}}:{{PAGENAME}}
{{TALKPAGENAME}}
({{TALKPAGENAMEE}})
Restituisce sempre {{TALKSPACE}}:{{PAGENAME}}
{{ARTICLEPAGENAME}}
({{ARTICLEPAGENAMEE}})
Restituisce sempre {{ARTICLESPACE}}:{{PAGENAME}}

Uso della variabile RevisionID

[modifica | modifica wikitesto]

La variabile REVISIONID fornisce un riferimento univoco alla specifica edizione della pagina che si sta consultando, tra tutte le revisioni che ha subito a partire dalla sua creazione. Può essere usata per costruire una URL che faccia sempre riferimento a quella specifica versione (anche se è l'ultima per la pagina) inserendo alla fine la stringa "old_id={{REVISIONID}}". Per ottenere direttamente la URL completa della pagina che si sta visualizzando è sufficiente selezionare il collegamento "Link permanente" nella casella degli strumenti a sinistra della pagina.

Questa funzione è utile quando è necessario fare riferimento a una versione specifica della pagina senza tenere conto dei cambiamenti successivi, ad esempio per citarla su una pagina di discussione oppure nella bibliografia di un lavoro. Quando viene visualizzata una versione specifica di una pagina, in alto a sinistra appaiono la data e l'ora di modifica (nell'ora locale del server o in orario UTC se non si è effettuato il login) e i collegamenti alla versione corrente, precedente e successiva, se esistono.

Esistono altre variabili relative alle revisioni.

{{REVISIONDAY}} Il giorno in cui è stata fatta la revisione
{{REVISIONDAY2}} Il giorno (a due cifre) in cui è stata fatta la revisione
{{REVISIONMONTH}} Il mese in cui è stata fatta la revisione
{{REVISIONYEAR}} L'anno in cui è stata fatta la revisione
{{REVISIONTIMESTAMP}} Data e orario ISO 8601 della revisione
Note
  • I valori della variabile REVISIONID sono gli stessi usati nella pagina della cronologia
  • Nel caso di un'anteprima, il valore della variabile REVISIONID è 0.

Esistono alcuni template che mescolano le funzioni delle variabili di pagina:

  • {{FULLROOTPAGENAME}} mescola le due variabili FULLPAGENAME e ROOTPAGENAME, restituendo il nome della pagina con namespace e senza sottopagine.
  • {{FULLBASEPAGENAME}} mescola le due variabili FULLPAGENAME e BASEPAGENAME, restituendo il nome della pagina con namespace escludendo l'ultima sottopagina.

Altre variabili

[modifica | modifica wikitesto]
Variabile di sistema Esempio Risultato Spiegazione
{{PAGESINCATEGORY:NomeCategoria}}
{{PAGESINCATEGORY:NomeCategoria|R}}

(oppure l'equivalente PAGESINCAT)
{{PAGESINCATEGORY:Utenti it-M}}
{{PAGESINCATEGORY:Utenti it-M|R}}
{{PAGESINCATEGORY:Utenti it-M|pages|R}}
{{PAGESINCATEGORY:Arte}}
{{PAGESINCATEGORY:Arte|pages}}
{{PAGESINCATEGORY:Arte|subcats}}
{{PAGESINCATEGORY:Arte|files}}
10 405
10405
10405
40
13
27
0
Restituisce il numero di pagine in una data categoria. Di default conteggia tutti i tipi di pagine, ma con il secondo parametro si può specificare:
  • pages = escluse sottocategorie e file
  • subcats = solo sottocategorie
  • files = solo file

N.B. questa è una funzione onerosa

{{PAGESIZE:NomePagina}}
{{PAGESIZE:NomePagina|R}}
{{PAGESIZE:Roma}}
{{PAGESIZE:Roma|R}}
238 156
238156
Restituisce la dimensione del wikicodice di una data pagina (come appare nella sua cronologia). N.B. questa è una funzione onerosa
{{NUMBERINGROUP:NomeGruppo}}
{{NUMBERINGROUP:bureaucrat}}
7
Restituisce il numero di utenti in un dato gruppo
{{!}} {{!}} | È in realtà una costante: restituisce una barra verticale "|". È utile quando si vuol evitare che la | sia interpretata come un separatore di parametri. Fino all'ottobre 2014 la funzione veniva realizzata tramite un template, ora eliminato.
{{=}} {{cita web|http://www.grandidizionari.it/Dizionario_Italiano/parola/T/tennista.aspx?query{{=}}tennista|lemma "Tennista" su Dizionario Italiano|autore=Aldo Gabrielli|editore=HOEPLI|30 ottobre 2024}} Aldo Gabrielli, lemma "Tennista" su Dizionario Italiano, su grandidizionari.it, HOEPLI. URL consultato il 30 ottobre 2024. Permette di inserire un singolo carattere "uguale" (=). È utile per inserire il carattere nel valore assegnato al parametro di un template senza che la parte precedente all'uguale sia interpretata come nome del parametro stesso (vedi Aiuto:Template#Limitazioni). Per usarlo è sufficiente inserire {{=}} al posto dell'uguale. Fino al giugno 2022 la funzione veniva realizzata tramite un template, ora eliminato.

Per la variabile NUMBERINGROUP i nomi dei gruppi sono:

  • * per tutti gli utenti
  • user per gli utenti registrati
  • autoconfirmed per gli utenti autoconfermati
  • emailconfirmed per gli utenti con indirizzi email confermati
  • bot per i bot
  • sysop per gli amministratori
  • bureaucrat per i burocrati

Quando si utilizza una variabile di pagina (ad es. {{PAGENAME}}) in combinazione con una variabile di categoria (ad es. {{PAGESINCATEGORY}}), bisogna inserire tale variabile dentro la funzione {{#titleparts}}. Questo a causa di un bug per cui non si ottiene l'effetto desiderato quando si ha a che fare con delle voci contenenti alcuni caratteri (come ' e *).[1] Ad esempio, anziché scrivere {{PAGESINCATEGORY:{{PAGENAME}}}} bisognerà scrivere {{PAGESINCATEGORY:{{#titleparts:{{PAGENAME}}}}}}, altrimenti in Categoria:Teatri dell'Aquila il PAGESINCATEGORY non funziona.

Combinazione di variabili Risultato
{{SERVER}}{{localurl:{{FULLPAGENAME}}|action=edit}} //it.wikipedia.org/w/index.php?title=Aiuto:Variabili&action=edit
{{fullurl:{{FULLPAGENAME}}|action=edit}} //it.wikipedia.org/w/index.php?title=Aiuto:Variabili&action=edit
{{fullurl:{{NAMESPACE}}:{{PAGENAME}}|action=edit}} //it.wikipedia.org/w/index.php?title=Aiuto:Variabili&action=edit
{{fullurl:Special:Whatlinkshere|target={{NAMESPACE}}:{{PAGENAME}}}} //it.wikipedia.org/w/index.php?title=Speciale:Whatlinkshere&target=Aiuto:Variabili
[[{{NAMESPACE}}:{{PAGENAME}}_1]] Aiuto:Variabili_1
{{SERVER}}{{localurl:{{NAMESPACE}}:{{PAGENAME}}}} //it.wikipedia.org/wiki/Aiuto:Variabili
{{SERVER}}{{localurl:{{NAMESPACE}}:{{PAGENAME}}|oldid={{REVISIONID}}}} //it.wikipedia.org/w/index.php?title=Aiuto:Variabili&oldid=-

L'ultimo esempio non è utile come collegamento se usato sulla pagina in sé, ma fornisce informazioni utili sulla pagina di provenienza, ad esempio, quando si fa una copia della pagina stampandola o salvandola in HTML. In quest'ultimo caso, il collegamento nell'HTML punta direttamente alla pagina originale. Il testo può essere usato anche come riferimento a una versione specifica della pagina, e può essere ricavato dal collegamento "Link permanente" a sinistra o dalla cronologia.

Come detto sopra, con la variabile localurl è necessario usare sempre la variabile PAGENAME con una E sola, altrimenti non funzionano i collegamenti che contengono caratteri speciali. Ad esempio, data la pagina Þ, scrivendo {{localurl:Þ}} si ottiene correttamente/wiki/%C3%9E (e aggiungendo {{SERVER}} si ha il collegamento //it.wikipedia.org/wiki/%C3%9E che punta alla pagina corretta). Al contrario, scrivendo {{PAGENAMEE}} si ottiene %C3%9E, che se inserita nella variabile {{localurl:%C3%9E}} dà come risultato /wiki/%C3%9E. Non essendo modificata, la funzione localurl non viene applicata e l'aggiunta di {{SERVER}} dà come unico risultato il collegamento errato //it.wikipedia.org/wiki/%C3%9E che non punta da nessuna parte.

Nei template, per i link alle pagine che dipendono da un parametro si utilizza lo stile dei collegamenti "esterni" anche per indicare i link interni; in tal modo si evita che il sistema faccia un collegamento alla pagina di modifica anche se la pagina è già esistente. È possibile avvalersi delle variabili per costruire il collegamento esterno.

Variabili come funzioni

[modifica | modifica wikitesto]

Le variabili possono essere utilizzate anche in maniera funzionale. Ovvero inserendo un certo input dopo i due punti (:) verrà restituito un output calcolato associato alla variabile.

Ad esempio:

  • la sintassi {{PAGENAME:Discussioni utente:Utente esempio}} dà come risultato "Utente esempio".
  • la sintassi {{NAMESPACE:Discussioni utente:Utente esempio}} dà come risultato "Discussioni utente".

Uso delle variabili nei collegamenti

[modifica | modifica wikitesto]

Le variabili possono essere usate anche all'interno dei collegamenti:

Ad esempio, la sintassi [[a {{NAMESPACE}} b|c {{PAGENAME}} d]] dà come risultato il collegamento c Variabili d alla pagina "A Aiuto b".

Template omonimi

[modifica | modifica wikitesto]

Se il nome di un template è lo stesso di una variabile verrà richiamata la variabile. Ad ogni modo, per evitare confusione, si invita a non creare template con questi nomi.

Se proprio si volesse includere il Template:PAGENAME, è necessario scrivere {{Template:PAGENAME}}. In alcuni casi, aggiungere parametri forzerà il parser ad invocare il template; per esempio, {{CURRENTDAYNAME|x}} includerà Template:CURRENTDAYNAME, non la variabile.

Pagine correlate

[modifica | modifica wikitesto]

Altri progetti

[modifica | modifica wikitesto]

Per informazioni tecniche complete e aggiornate: