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
The  and   magic words only work in namespaces that have subpages enabled. See for information on enabling subpages.

As of, these can all take a parameter, allowing specification of the page to be operated on, instead of just the current page:
 * &rarr; 

For example, if page name is "L'Aquila", the following code will produce the string "Numeric char encoding":

Noms de pàgina codificats com a URL
The following are equivalents encoded for use in MediaWiki URLs (i.e. spaces replaced with underscores and some characters HTML escaped using numeric character encoding):



Note that,   and   have distinct implementations. See Manual:PAGENAMEE encoding for details.

Espais de noms
The following are equivalents encoded for use in MediaWiki URLs (spaces replaced with underscores and some characters percent-encoded):



As of, these can take a full-page-name parameter and will return the requested namespace associated with that page, instead of with the current page:

Parameter must not be a namespace name:
 * &rarr; 
 * &rarr; 
 * &rarr; 
 * &rarr;   (Empty)

Funcions d'analitzador
Parser functions are very similar to variables, but take one or more parameters (technically, any magic word that takes a parameter is a parser function), and the name is sometimes prefixed with a hash to distinguish them from templates.

This page only describes parser functions that are integral to the MediaWiki software. Other parser functions may be added by MediaWiki extensions such as the. For those see.

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.