Help:Magic words/ca

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

Hi ha tres categories generals de paraules màgiques:


 * Controladors de comportament: són paraules en majúscules entre dues 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é  . Vegeu també.

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 controlador de comportament determina el disseny o el comportament de la pàgina i, sovint es pot utilitzar per especificar, volgudament, algunes omissions i inclusions en el contingut.

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 $wgLocaltimezone.

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
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, 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; 

Per exemple, si el nom de la pàgina és "L'Aquila", el següent codi produirà la cadena "Numeric char encoding":

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, 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; 
 * &rarr; 
 * &rarr;   (Empty)

Funcions d'analitzador
Funcions d'analitzador són molt similars a les variables, però tenen 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 és a vegades precedits d'un hash 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
returns the current localized name for the namespace with that index, canonical name, or local alias. Thus,  , and   (an old name for the File namespace) all return "    ". On a wiki where the content language is French,  is also valid, but   (the localisation of "File" in German) is not.

is the equivalent encoded for MediaWiki URLs. It does the same, but it replaces spaces with underscores, making it usable in external links.

Don't confuse localised namespaces with custom namespaces.

Formatació
See also:.

Localització
Here are the magic words which are used as main localisation tools. Other magic words will often depend on the wiki's locale and configuration or on the chosen language: see in particular #Date and time, #Formatting, #Miscellaneous. More magic words are added by the.

The usage of these magic words can be very complex, and the documentation is currently incomplete; there's some more info on PLURAL, GRAMMAR, GENDER.