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  .
 * 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  necessiteu escriure ). En alguns casos, l'addició de paràmetres obliga a l'analitzador sintàctic a invocar una plantilla; per exemple, $tpl-currentdayname-code transclou $tpl-currentdayname-result, 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.

The use of those variables cause pages to be cached for a more limited number of seconds. This is configured in MagicWordFactory.

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 manera més exacta, o per produir la setmana i any actuals de manera més conforme a la ISO-8601, podeu instal·lar per utilitzar la .



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, $nop-code &rarr; $nop-result i $nop-r-code &rarr; $nop-r-result).

Utilitzeu "|R" per les paraules màgiques que requereixen un paràmetre com PAGESINCATEGORY (per exemple, $pic i $pic-r, o $pic-subcat i $pic-subcats-r). També aplicable a $pagesizenom de la pàgina$pagesize-end hereinbefore. Also applicable to 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:





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 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)

Altres


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.



Metadades tècniques d'altres pàgines


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 6,  -file, i  -img (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, -file-de també és vàlid, però  -file-incorrect (la localització de "Fitxer" en alemany) no ho és. 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.

The main namespace has no name, i.e.  returns an empty string. For explicitly referring to the main namespace,  can be used, resulting in "".

é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.

Miscel·lània
For parser function #invoke, see w:Wikipedia:Lua.