- Questa estensione è attivata di default su Fandom.
Una funzione parser è uno speciale frammento di codice MediaWiki che estende la funzionalità di un template all'esecuzione di operazioni logiche. Una volta interpretate, le funzioni parser utilizzano i parametri inclusi nella loro definizione per produrre uno specifico risultato.
Le funzioni parser si richiamano allo stesso modo dei template, vale a dire circoscrivendole con le parentesi graffe. Si possono identificare facilmente per il fatto che i loro nomi contengono o il cancelletto (#) o i due punti (o entrambi, come nel caso della funzione {{#if:}}).
Una lista di tutte le funzioni parser è disponibile alla pagina Speciale:Versione.
Passo dopo passo
- Identifica la funzione parser appropriata per ciò che stai cercando di fare. C'è una grande varietà di queste funzioni, quindi assicurati di aver trovato quella giusta.
Qui sotto troverai delle informazioni extra e dei link utili per aiutarti a raggiungere la documentazione completa di ogni funzione. - Identifica la sintassi corretta per la funzione parser che vorresti usare.
In questa guida utilizzeremo la funzione{{#ifexpr:}}(if expression), attivata di default su tutte le wiki. La sua sintassi è:
{{#ifexpr: espressione | valore se vero | valore se falso }} - Compila la funzione.
{{#ifexpr: 1 > 0 | sì | no }}
In questo esempio, abbiamo utilizzato l'espressione matematica "1 > 0" e abbiamo impostato la funzione perché risulti "sì" se "1 > 0" è un'espressione corretta (matematicamente parlando) oppure "no" se "1 > 0" non è un'espressione corretta. - Salva la pagina e verifica che la funzione restituisca il valore che ti aspetti. Nel nostro caso dovrebbe risultare "sì" perché 1 è naturalmente maggiore di 0.
{{#ifexpr: 1 > 0 | sì | no }} → sì.
Da notare cosa succederebbe se "ribaltassimo" l'espressione ma mantenessimo gli stessi valori. L'equazione risulterebbe falsa poiché 0 non è più grande di 1 e la funzione restituirebbe il valore "no".
{{#ifexpr: 1 < 0 | sì | no }} → no.
Mentre l'esempio qui sopra sembra sciocco, dato che uno dovrebbe già sapere che 1 > 0, l'utilità di questa funzione si rivela più che altro quando è un parametro ad essere processato. Mettiamo conto che tu stia progettando un'infobox per una wiki su una serie TV. Vorresti includere l'età di un personaggio e determinare se è adulto oppure no.
Se all'interno dell'infobox avessi {{#ifexpr: {{{età}}} >= 18 | Questo personaggio è un adulto. | Questo personaggio non è un adulto. }}, il codice risulterebbe in "Questo personaggio è un adulto" se l'età specificata per il personaggio fosse 18 o più. Se invece fosse minore di 18, il codice risulterebbe in "Questo personaggio non è un adulto."
Funzioni parser integrate in MediaWiki
Lo stesso software MediaWiki include alcune funzioni parser al suo interno. Una lista completa si può trovare qui su MediaWiki.org. In questa pagina sono illustrate le più utili.
{{fullurl:}}- Restituisce l'intero URL della pagina.
{{fullurl:Aiuto:Contenuti}}→ https://community.fandom.com/it/wiki/Aiuto:Contenuti{{#language:}}- Converte il codice di una lingua nel nome della lingua.
{{#language:es}}→ español{{lc:}}- Trasforma in minuscolo i caratteri di una stringa (opposto di
{{uc:}}). {{lc:MINUSCOLO}}→ minuscolo{{ns:}}- Converte il numero identificativo di un namespace nel nome del namespace.
{{ns:4}}→ Wiki della Community{{plural:}}- Se il valore assoluto dell'espressione data è uguale a 1, restituisce il valore singolare (secondo parametro). In tutti gli altri casi restituisce quello plurale (terzo parametro).
{{plural:1|è|sono}}→ è{{plural:2|è|sono}}→ sono
L'estensione ParserFunctions
L'estensione ParserFunctions conta sulla semplice logica.
L'estensione ParserFunctions è una diffusa estensione MediaWiki che aggiunge numerose e utili funzioni parser, includendo anche molte delle funzioni dell'ormai obsoleta estensione StringFunctions, fra cui {{#explode}}. Questa estensione è attivata di default su tutta FANDOM e comprende funzioni per operazioni matematiche, per dichiarazioni if/else (se/altrimenti) e funzioni legate al tempo. Per una lista completa di queste funzioni e una documentazione davvero utile su di esse si visiti la pagina di aiuto ufficiale dell'estensione.
Altre estensioni
Vi sono alcune altre estensioni popolari su FANDOM che aggiungono delle funzioni parser. Ecco le più comuni.
- Arrays - aggiunge {{#arraydefine}}, {{#arrayprint}}, {{#arraysearcharray}}.
- Semantic MediaWiki - aggiunge {{#ask}}, {{#set}}, {{#show}}.
- Semantic Forms - aggiunge {{#formlink}}, {{#forminput}}, {{#arraymap}}
- Simple Calendar - aggiunge {{#calendar}}
- Variables - aggiunge {{#var}}, {{#vardefine}}, {{#vardefineecho}}.
Dunque se sei interessato ad un'estensione che include delle funzioni parser, consulta direttamente la pagina di quell'estensione su MediaWiki.org.
Vedi anche
- Informazioni sulle "parole magiche", una funzione di MediaWiki correlata.
- Informazioni su tutte le estensioni di FANDOM.
- Informazioni generali sulle funzioni parser su Meta-Wiki.