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.