Una funzione parser è un tipo di codice di base interno al linguaggio di MediaWiki, il wikitext. Ti permette di rendere un template più robusto e adattabile. Scritta bene, la definizione di una funzione parser produce risultati diversi in situazioni diversi.
Per esempio, invece di produrre semplicemente lo stesso risultato in ogni pagina dove è usato il template {{Il mio bel template}}, puoi usare una funzione parser per produrre un risultato se la pagina è contenuta nella Categoria:File e uno completamente diverso se si trova nella Categoria:Aiuto.
I modi con cui si possono sfruttare le funzioni parser sono tanti e troppo vasti per descriverli tutti qui. Ma sperabilmente possiamo aiutarti ad iniziare ad esplorarli.
Uso di base
Fare il parsing di qualcosa significa semplicemente esaminare l'asserzione per le sue componenti logiche e poi agire di conseguenza. Per esempio:
- Se il titolo dell'articolo è "Supergirl 23", allora trasforma il campo "Prossimo volume" dell'infobox in "Supergirl 24".
Questa è una funzione parser.
Come puoi scriverne una? Le funzioni parsor appaiono come dei template, racchiuse tra 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:}}).
Supponiamo che vuoi indirizzare le persone ad una pagina chiamata Supergirl, a meno di non essere già su quella pagina. Ecco un modo semplice per farlo:
{{#ifeq:{{PAGENAME}}|Supergirl| |Vai a vedere [[Supergirl]]!}}
Questo significa, "Se la pagina in cui mi trovo è chiamata 'Supergirl' (corrispondenza esatta), non stampare nulla. Altrimenti, stampa, 'Vai a vedere [[Supergirl]]!'."
Magari, invece, stai progettando un infobox per una wiki su una serie TV, e voi fare qualche semplice calcolo a partire dal valore della varibile {{{Età}}}.
Utilizzando {{#ifexpr: {{{Età}}} >= 18 | Questo personaggio è adulto. | Questo personaggio non è adulto. }}, l'infobox stampa "Questo personaggio è adulto." se l'età fornita del personagio è uguale o superiore a 18. Se l'età fornita è inferiore a 18, il codice produce invece " Questo personaggio non è adulto.".
Funzioni parser integrate in MediaWiki
Lo stesso software MediaWiki include alcune funzioni parser al suo interno. Una lista completa è disponibile qui su MediaWiki.org. In questa pagina sono riportate 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 l'espressione data è uguale a 1, restituisce il valore singolare (secondo parametro). Se l'espressione data è pari a 2, restituisce quello plurale (terzo parametro).
{{plural:1|è|sono}}→ è{{plural:2|è|sono}}→ sono
L'estensione ParserFunctions
L'estensione ParserFunctions è una popolare estesione di MediaWiki che aggiunge numerose e utili funzioni parser in aggiunta a quelle native elencate qui sopra. Questa estensione è attivata di default su tutto Fandom, quindi non devi richiedere per averla.
Le funzioni parser possono eseguire operazioni matematiche, dichiarazioni if/else e manipolare il tempo stesso! (Beh, le espressioni temporali, ovviamente!).
Per una lista completa di queste funzioni e una documentazione davvero utile su come usarla, visita la pagina di aiuto ufficiale dell'estensione.
L'estensione ParserFunctions conta sulla semplice logica per restituire codice utile.
StringFunctions
Le funzioni per stringhe sono ora parte dell'estensione ParserFunctions. Ma facevano un tempo parte di una propria estensione separata. Quindi non confonderti nel caso leggessi qualcosa su questo it. Solo l'estensione StringFunctions è deprecata. Le funzioni per stringhe sono invece vive e vegete!
Le funzioni per stringhe sono una serie di funzioni parser specializzate che lavorano sulle stringhe di testo. Ti permettono di fare cose come:
- determinare la lunghezza di una stringa
- determinare quale posizione nella stringa è occupato da un certo carattere
- trovare una parola in una stringa
Da sole, le funzioni per stringhe potrebbero sembrare arcane, ma sono vitali quando cerchi di fare qualcosa come trasformare Ant-Man (Earth-616) in soltanto Ant-Man. Ti permettono di trovare l'elemento racchiuso da parentesi (Earth-616) ed eliminarlo!
Altre estensioni
Alcune altri estensioni popolari su Fandom aggiungono le proprie funzioni parser. Due delle più comuni sono Arrays e Variables.
Per scoprire di più su queste, consulta la pagina di ciascuna estesione su MediaWiki.org.
Quali funzioni parser sono disponibili qui?
Poiché wiki diverse possono avere funzioni parser diverse, potrebbe essere utile determinare precisamente cosa è attivo su una wiki particolare. Controlla la pagina Speciale:Versione delle tua wiki per la lista completa.
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.
Aiuto aggiuntivo e feedback
- Naviga e cerca altre pagine di aiuto su Contenuti.
- Esplora la Wiki della Community per ulteriori fonti di aiuto o supporto.
- Leggi come contattare Fandom per problemi o segnalare errori.