Vai al contenuto

Aiuto:Funzioni aggiuntive del Parser

Da Wikisource.
Aiuto: Funzioni aggiuntive del Parser

Categoria: Guida del wikisourciano espertoManuale   Guida del wikisourciano esperto   Parole magiche   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}}
{{padleft:0|3|0}}
{{padleft:bcd|6|a}}

007
000
aaabcd

Aggiunge a sinistra una serie di caratteri
{{padright:}}

{{padright:7|3|0}}
{{padright:0|3|0}}
{{padright:bcd|6|a}}

700
000
bcdaaa

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:

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.