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; 

Page titles containing certain characters, such as apostrophes  or asterisks , may produce unexpected results when handled with these magic words, e.g.  . See bugs , , , and. One simple way to fix this is wrapping the pagename in  from the ParserFunctions extension.

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

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.

Transclusion modifiers
usually transcludes another page, by default from the Template:namespace. These magic words modify that behavior.