Aiuto:Variabili
 | Questa pagina di aiuto di Wikibooks non è aggiornata e quindi può contenere informazioni non più valide. In attesa che venga aggiornata si consiglia di leggere quella su Wikipedia. |
 | Formattare il wikitesto
Immagini · Wikilink e Interlink · Tabelle · Note · Formule matematiche · File multimediali e suoni · Quiz HTML · CSS · Caratteri speciali e Unicode · Variabili · Funzioni di parsing · Inputbox | |
Il software MediaWiki su cui si basa Wikibooks 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, sul Wikibooks italiano, su questa pagina e in questo momento. La terza colonna è una breve spiegazione del significato della variabile e come può variare in altri contesti.
Variabili di progetto
[modifica | modifica sorgente]Le variabili descritte in questa sezione sono legate al singolo progetto Wikimedia e alla sua configurazione. Sono perciò da considerarsi delle costanti per Wikibooks 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}} | Wikibooks | Nome del namespace predefinito 4 |
| {{ns:5}} o {{ns:Project_talk}} | Discussioni Wikibooks | 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}} | Progetto | Nome del namespace personalizzato 100 |
| {{ns:101}} | Discussioni progetto | Nome del namespace personalizzato 101 |
| {{SITENAME}} | Wikibooks | Nome del sito |
| {{SERVER}} | //it.wikibooks.org | URL del server che ospita le pagine |
| {{SERVERNAME}} | it.wikibooks.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.wikibooks.org/wiki/Nome_pagina | URL completa della pagina specificata |
| {{fullurl:nome pagina|query}} | //it.wikibooks.org/w/index.php?title=Nome_pagina&query | Come sopra, con parametro query |
| {{int:aboutsite}} | Informazioni su Wikibooks | Pagina interna specificata |
Uso delle variabili Localurl e Fullurl
[modifica | modifica sorgente]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.wikibooks.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.wikibooks.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 sorgente]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 sorgente]Le variabili descritte in questa sezione sono legate alla data e ora del sistema, e variano di conseguenza.
| Variabile di sistema | Risultato | Spiegazione |
|---|---|---|
| {{CURRENTMONTH}} | 12 | Mese corrente in cifre (01-12) |
| {{CURRENTMONTHNAME}} | dicembre | Mese corrente in lettere, per esteso |
| {{CURRENTMONTHABBREV}} | dic | Mese corrente in lettere, abbreviato |
| {{CURRENTWEEK}} | 51 | Settimana corrente in cifre (01-54) |
| {{CURRENTDAY}} | 22 | Giorno corrente in cifre (1-31) |
| {{CURRENTDAYNAME}} | domenica | Giorno della settimana corrente |
| {{CURRENTDOW}} | 0 | Giorno della settimana corrente in cifre (0 = domenica, ..., 6 = sabato) |
| {{CURRENTYEAR}} | 2024 | Anno corrente in cifre |
| {{CURRENTTIME}} | 17:31 | Ora corrente (UTC) |
| {{LOCALTIME}} | 18:31 | Ora corrente (vedi note) |
| {{CURRENTTIMESTAMP}} | 20241222173103 | Data e orario corrente ISO 8601 |
Nota: Quando viene usato un template contenente il comando di sostituzione {{<includeonly>subst:</includeonly>CURRENTDAY}} nel testo della pagina viene inserito il valore corrente della variabile nel momento in cui il template viene utilizzato per la prima volta.
Numero di voci
[modifica | modifica sorgente]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 della raccolta di testi liberi, stub che contengono almeno un collegamento e pagine di chiarimento delle ambiguità.
| Variabile di sistema | Risultato | Spiegazione |
|---|---|---|
| {{NUMBEROFARTICLES}} | 18 182 | Numero di voci contenute nel progetto |
Variabili di pagina
[modifica | modifica sorgente]| Variabile di sistema | Risultato | Spiegazione |
|---|---|---|
| {{NAMESPACE}} | Aiuto | Namespace della pagina corrente (in chiaro) |
| {{NAMESPACEE}} | Aiuto | Namespace della pagina corrente (con caratteri di escape) |
| {{PAGENAME}} | Variabili | Nome della pagina corrente (in chiaro) |
| {{PAGENAMEE}} | Variabili | Nome della pagina corrente (con caratteri di escape) |
| {{SUBPAGENAMEE}} | Variabili | Nome della sottopagina corrente |
| {{SUBPAGENAMEE}} | Variabili | Nome della sottopagina corrente (con caratteri di escape) |
| {{FULLPAGENAME}} | Aiuto:Variabili | Nome completo della pagina corrente (in chiaro) |
| {{FULLPAGENAMEE}} | Aiuto:Variabili | Nome completo della pagina corrente (con caratteri di escape) |
| {{REVISIONID}} | ||
| Numero di revisione della pagina corrente |
Uso delle variabili Namespace, Pagename e Fullpagename
[modifica | modifica sorgente]Le variabili NAMESPACEE, PAGENAMEE e FULLPAGENAMEE forniscono i nomi delle pagine nel formato utilizzato nelle URL: gli spazi vengono sostituiti da caratteri di sottolineatura (underscore, "_") e i caratteri speciali vengono sostituiti 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
- {{<includeonly>subst:</includeonly>PAGENAME}}
- nel testo della pagina viene inserito il valore corrente della variabile nel momento in cui il template viene utilizzato per la prima volta.
Uso della variabile RevisionID
[modifica | modifica sorgente]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.
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.
Esempi d'uso
[modifica | modifica sorgente]| Combinazione di variabili | Risultato |
|---|---|
| {{SERVER}}{{localurl:{{FULLPAGENAME}}|action=edit}} | //it.wikibooks.org/w/index.php?title=Aiuto:Variabili&action=edit |
| {{fullurl:{{FULLPAGENAME}}|action=edit}} | //it.wikibooks.org/w/index.php?title=Aiuto:Variabili&action=edit |
| {{fullurl:{{NAMESPACE}}:{{PAGENAME}}|action=edit}} | //it.wikibooks.org/w/index.php?title=Aiuto:Variabili&action=edit |
| {{fullurl:Special:Whatlinkshere|target={{NAMESPACE}}:{{PAGENAME}}}} | //it.wikibooks.org/w/index.php?title=Speciale:Whatlinkshere&target=Aiuto:Variabili |
| [[{{NAMESPACE}}:{{PAGENAME}}_1]] | Aiuto:Variabili_1 |
| {{SERVER}}{{localurl:{{NAMESPACE}}:{{PAGENAME}}_1}} | //it.wikibooks.org/wiki/Aiuto:Variabili_1 |
| {{SERVER}}{{localurl:{{NAMESPACE}}:{{PAGENAME}}|oldid={{REVISIONID}}}} | //it.wikibooks.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 usatoanche 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.wikibooks.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.wikibooks.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.
Uso delle variabili nei collegamenti
[modifica | modifica sorgente]Le variabili possono essere usate anche all'interno dei collegamenti:
- La sintassi [[a{{NAMESPACE}}b|c{{PAGENAME}}d]] dà come risultato il collegamento cVariabilid.