Help:Magic words/ca

Les paraules màgiques són cadenes de text que el MediaWiki associa amb una funció o un valor, com ara l'hora, dades del lloc o noms de pàgina. Aquesta pàgina explica només les paraules màgiques tipificades. Per a informació tècnica vegeu.

Hi ha tres categories generals de paraules màgiques:


 * Controladors de comportament: normalment s'escriuen com a paraules en majúscules entre dos parells de ratlles baixes, per exemple __FOO__.


 * Variables: són paraules en majúscules entre claus dobles, per exemple  . S'assemblen molt a les plantilles.


 * Funcions d'analitzador o funcions parser: prenen paràmetres i són bé de la forma   o bé   e.g. . Vegeu també  and.

Les variables i les funcions d'analitzador poden utilitzar subst:, igual que les plantilles. Les paraules màgiques pàgina-depenents afectaran o retornaran dades sobre la pàgina actual (per defecte), encara que la paraula s'afegeixi a través d'una plantilla transclosa o d'un missatge del sistema inclòs.

Controladors de comportament
Un commutador de comportament determina el disseny o el comportament de la pàgina (si l'aparença hi és compatible) i, sovint es pot utilitzar per especificar, volgudament, algunes omissions i inclusions en el contingut. És important tenir en compte que l'aparença Minerva no és compatible amb algunes d'elles.

Variables
Les variables retornen informació sobre la pàgina, el wiki, o la data actuals. La seva sintaxi és similar a les plantilles. Les variables marcades com " [expensive] " són rastrejades pel programari, i el número que es pot incloure en una pàgina és limitada.

Si el nom d'una plantilla entra en conflicte amb una variable, s'utilitzarà la variable (així per transcloure la plantilla     :PAGENAME  necessiteu escriure  ). En alguns casos, l'addició de paràmetres obliga a l'analitzador sintàctic a invocar una plantilla; per exemple,  transclou     :CURRENTDAYNAME, i no la variable.

Data i hora
Les següents variables retornen la data i hora en UTC.

A causa de la memòria cau de MediaWiki i del navegador, aquestes variables freqüentment mostren un valor que depèn d'aquesta mateixa memòria cau, en lloc de la data/hora actuals.

Les paraules màgiques de data i hora es formaten en l'idioma del contingut wiki. Des de, que depenen de l'idioma del contingut de la pàgina.

Les següents variables retornen el mateix valor que les indicades més amunt, però usant la configuració del servidor del lloc o.



Per formatar l'hora d'una forma més personal, és possible que vulgueu instal·lar per utilitzar la #time parser function.

Metadades tècniques
Nota: Les variables de revisió retornen dades sobre el l'última edició de la pàgina actual, encara que estigui veient una versió anterior de la pàgina.

Estadístiques
Els nombres retornats per aquestes variables normalment contenen separadors (comes, punts o espais, en funció de l'idioma local), però poden tornar nombres en brut amb l'etiqueta ":R" (per exemple,  &rarr;  i   &rarr; ).

Utilitzeu "|R" per les paraules màgiques que requereixen un paràmetre com PAGESINCATEGORY (per exemple,  i , o  -subcat i  ). També aplicable a  hereinbefore.

Les paraules màgiques dels números es formaten en l'idioma del contingut wiki. Des de, depenen de l'idioma del contingut de la pàgina.

Noms de pàgina
None of these are affected by changes to the display title using ; the values returned are the original page title.

Les paraules màgiques  i   només funcionen en espais de nom que tinguin subpàgines habilitades. Consulteu per a informació sobre com activar les subpàgines.

A partir de 1.15+, aquestes poden prendre un paràmetre, el que permet l'especificació de la pàgina on actuar, en lloc de la pàgina actual:
 * &rarr; 

{{Warning|1=Els títols de pàgina que contenen determinats caràcters, com apòstrofs  o asteriscs , poden produir resultats inesperats quan es manegen amb aquestes paraules màgiques, per exemple,. Consulteu els errors T16779, T18474, T37628, T37746. Una manera senzilla de fer això és embolicar el nom de la pàgina en  de l'extensió ParserFunctions (funcions de l'analitzador).

Per exemple, si el nom de la pàgina és "$pagename", el següent codi produirà la cadena "$result":

Noms de pàgina codificats com a URL
Les següents són equivalents codificats per al seu ús en les adreces URL de MediaWiki (és a dir, els espais reemplaçats per guions baixos i alguns caràcters d'escapament de HTML utilitzant la codificació de caràcters numèrics):



Tingueu en compte que,   i   tenen implementacions diferents. Consulteu Manual:Codificació PAGENAMEE per a més detalls.

Espais de noms
Els següents són equivalents codificats per al seu ús en les adreces URL de MediaWiki (els espais són reemplaçats per guions baixos i alguns caràcters de codificats amb el caràcter de percentatge):



A partir de 1.15+, aquests poden prendre un paràmetre de nom-pàgina-complet i retornaran l'espai de noms demanat associat a aquesta pàgina, en lloc de amb la pàgina actual:

El paràmetre no ha de ser un nom d'espai de noms:
 * &rarr; 
 * &rarr;  (Pages in main space will return empty)
 * &rarr; 
 * &rarr; 
 * &rarr; 
 * &rarr; 
 * &rarr;   (Empty)

Funcions d'analitzador
Les funcions d'analitzador són molt similars a les variables, però prenen un o més paràmetres (tècnicament, qualsevol paraula màgica que pren un paràmetre és una funció d'anàlisi sintàctica), i el nom a vegades va precedit d'un coixinet per distingir-les de les plantilles.

Aquesta pàgina només descriu les funcions de l'analitzador que són integrals per al programari MediaWiki. Altres funcions de l'analitzador poden ser afegides per les extensions de MediaWiki, com la. Per a aquelles consulteu.

Espais de noms
retorna el nom localitzat actual per a l'espai de noms amb aquest índex, nom canònic, o àlies local. Per tant,  , i   (un nom antic per a l'espai de noms de "File" = fitxer) tots tornen "    ". En un wiki on l'idioma de contingut és el francès,  també és vàlid, però   (la localització de "Fitxer" en alemany) no ho és.

és l'equivalent codificat per les URL de MediaWiki. Es fa el mateix, però reemplaça els espais per subratllats, pel que és utilitzable en els enllaços externs.

Cal no confondre els espais de noms localitzats amb espais de noms personalitzats.

Formatació
Consulteu també:.

Localització
Aquestes són les paraules màgiques que s'utilitzen com a principals eines de localització. Altres paraules màgiques sovint depenen de la configuració regional i la configuració del wiki o de l'idioma triat: consulteu en particular #Date and time, #Formatting, #Miscellaneous. A hi han més paraules màgiques.

L'ús d'aquestes paraules màgiques pot ser molt complex, i la documentació en l'actualitat incompleta; hi ha una mica més d'informació sobre: plural, gramàtica, gènere.

Modificadors de transclusió
Normalment,  transclou una altra pàgina, per defecte de l'espai de noms "Template:" ("Plantilla:"). Les paraules màgiques següents modifiquen aquest comportament.