Aiuto:Funzioni aggiuntive del Parser
- Aiuto
Il software Mediawiki su cui si basa Wikisource mette a disposizione un gruppo di funzioni aggiuntive del Parser.
La struttura è analoga a quella dei template, anche dal punto di vista della sintassi: {{funzione: argomento 1 | argomento 2 | argomento 3...}}. Vengono spesso usate insieme alle variabili da cui si differenziano dal fatto di avere degli argomenti (mentre le variabili non ne hanno).
La versione completa e sempre aggiornata di questa pagina la trovi su Meta.
Funzioni per la formattazione[modifica]
| Funzione | esempio | risultato | descrizione |
| {{lc:}} | {{lc:AbCdEf}} | abcdef | Rende minuscole tutte le lettere |
| {{uc:}} | {{uc:AbCdEf}} | ABCDEF | Rende maiuscole tutte le lettere |
| {{lcfirst:}} | {{lcfirst:Ab Cd}} | ab Cd | Rende minuscola la prima lettera |
| {{ucfirst:}} | {{ucfirst:aB cD}} | AB cD | Rende maiuscola la prima lettera |
| {{formatnum:}} | {{formatnum:-299792458.56789}} | −299 792 458,56789 | Formatta un numero aggiungendo i punti per le migliaia e la virgola per i decimali |
| {{padleft:}} |
{{padleft:7|3|0}} |
007 |
Aggiunge a sinistra una serie di caratteri |
| {{padright:}} |
{{padright:7|3|0}} |
700 |
Aggiunge a destra una serie di caratteri |
Funzioni per i namespace[modifica]
| Funzione | namespace | descrizione |
| {{ns:-2}} o {{ns:Media}} | Media | Pseudo-namespace per immagini e altri tipi di file non appropriati per il namespace Immagine |
| {{ns:-1}} o {{ns:Special}} | Speciale | Pseudo-namespace per le pagine speciali generate automaticamente dal software |
| {{ns:0}} | Namespace principale, ovvero quello in cui sono pubblicati i testi | |
| {{ns:1}} o {{ns:Talk}} | Discussione | Le discussioni del namespace principale, ovvero dove vengono indicate le informazioni sull'edizione di un testo |
| {{ns:2}} o {{ns:User}} | Utente | Namespace delle pagine degli utenti |
| {{ns:3}} o {{ns:User_talk}} | Discussioni utente | Discussioni degli utenti |
| {{ns:4}} o {{ns:Project}} | Wikisource | Namespace delle pagine Wikisource |
| {{ns:5}} o {{ns:Project_talk}} | Discussioni Wikisource | Discussioni delle pagine Wikisource |
| {{ns:6}} o {{ns:Image}} | File | Namespace delle immagini |
| {{ns:7}} o {{ns:Image_talk}} | Discussioni file | Discussioni delle immagini |
| {{ns:8}} o {{ns:MediaWiki}} | MediaWiki | Namespace Mediawiki |
| {{ns:9}} o {{ns:MediaWiki_talk}} | Discussioni MediaWiki | Discussioni di MediaWiki |
| {{ns:10}} o {{ns:Template}} | Template | Namespace dei template |
| {{ns:11}} o {{ns:Template_talk}} | Discussioni template | Discussioni dei template |
| {{ns:12}} o {{ns:Help}} | Aiuto | Namespace delle pagine di aiuto |
| {{ns:13}} o {{ns:Help_talk}} | Discussioni aiuto | Discussioni delle pagine di aiuto |
| {{ns:14}} o {{ns:Category}} | Categoria | Namespace delle categorie |
| {{ns:15}} o {{ns:Category_talk}} | Discussioni categoria | Discussioni delle categorie |
| {{ns:102}} o {{ns:Autore}} | Autore | Namespace degli autori |
| {{ns:103}} o {{ns:Discussioni autore}} | Discussioni autore | Discussioni degli autori |
| {{ns:104}} o {{ns:Progetto}} | Progetto | Namespace dei progetti tematici |
| {{ns:105}} o {{ns:Discussioni progetto}} | Discussioni progetto | Discussioni dei progetti tematici |
| {{ns:106}} o {{ns:Portale}} | Portale | Namespace dei portali tematici |
| {{ns:107}} o {{ns:Discussioni portale}} | Discussioni portale | Discussioni dei portali tematici |
| {{ns:108}} o {{ns:Pagina}} | Pagina | Namespace delle pagine con le immagini dei testi |
| {{ns:109}} o {{ns:Discussioni pagina}} | Discussioni pagina | Discussioni delle pagine con le immagini dei testi |
| {{ns:110}} o {{ns:Indice}} | Indice | Namespace degli indici |
| {{ns:111}} o {{ns:Discussioni indice}} | Discussioni indice | Discussioni degli indici |
Funzioni per gli URL[modifica]
| Funzione | esempio | risultato | descrizione |
| {{localurl:}} | {{localurl:Wikisource:Pagina delle prove}} | /wiki/Wikisource:Pagina_delle_prove | URL locale della pagina specificata |
| {{localurl:|query}} | {{localurl:Wikisource:Pagina delle prove|action=edit}} | /w/index.php?title=Wikisource:Pagina_delle_prove&action=edit | Come sopra, con parametro query |
| {{fullurl:}} | {{fullurl:Wikisource:Pagina delle prove}} | //it.wikisource.org/wiki/Wikisource:Pagina_delle_prove | URL completa della pagina specificata |
| {{fullurl:|query}} | {{fullurl:Wikisource:Pagina delle prove|action=edit}} | //it.wikisource.org/w/index.php?title=Wikisource:Pagina_delle_prove&action=edit | Come sopra, con parametro query |
| {{int:}} | {{int:aboutsite}} | Informazioni su Wikisource | Pagina interna specificata |
Uso delle variabili Localurl e Fullurl[modifica]
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.wikisource.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.wikisource.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]
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]].
Esempi d'uso delle variabili con le funzioni aggiuntive del Parser[modifica]
| Combinazione di variabili | Risultato |
|---|---|
| {{SERVER}}{{localurl:{{FULLPAGENAME}}|action=edit}} | //it.wikisource.org/w/index.php?title=Aiuto:Funzioni_aggiuntive_del_Parser&action=edit |
| {{fullurl:{{FULLPAGENAME}}|action=edit}} | //it.wikisource.org/w/index.php?title=Aiuto:Funzioni_aggiuntive_del_Parser&action=edit |
| {{fullurl:{{NAMESPACE}}:{{PAGENAME}}|action=edit}} | //it.wikisource.org/w/index.php?title=Aiuto:Funzioni_aggiuntive_del_Parser&action=edit |
| {{fullurl:Special:Whatlinkshere|target={{NAMESPACE}}:{{PAGENAME}}}} | //it.wikisource.org/w/index.php?title=Speciale:Whatlinkshere&target=Aiuto:Funzioni aggiuntive del Parser |
| [[{{NAMESPACE}}:{{PAGENAME}}_1]] | Aiuto:Funzioni aggiuntive del Parser_1 |
| {{SERVER}}{{localurl:{{NAMESPACE}}:{{PAGENAME}}_1}} | //it.wikisource.org/wiki/Aiuto:Funzioni_aggiuntive_del_Parser_1 |
| {{SERVER}}{{localurl:{{NAMESPACE}}:{{PAGENAME}}|oldid={{REVISIONID}}}} | //it.wikisource.org/w/index.php?title=Aiuto:Funzioni_aggiuntive_del_Parser&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.wikisource.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.wikisource.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.
Le variabili possono essere usate anche all'interno dei collegamenti:
- La sintassi [[a{{NAMESPACE}}b|c{{PAGENAME}}d]] dà come risultato il collegamento cFunzioni aggiuntive del Parserd.
Domande?[modifica]
Se hai domande, dubbi, proposte o necessiti di chiarimenti sulle funzioni aggiuntive del Parser premi qui e lascia un messaggio nella pagina di discussione.