Help:Magic words/es

Las magic words, –palabras mágicas, en castellano–, son strings –cadenas de texto– que MediaWiki asocia con un valor determinado, o el resultado devuelto por una función, como pueda ser la fecha, hora, detalles de la página, nombre del artículo, etcétera. En esta página de ayuda, se listan las magic words de carácter standard en los proyectos Wikimedia; para una documentación técnica y más extensiva, consultar.

Hay tres clases generales de magic words:


 * Behavior switches, –modificadores de comportamiento, en castellano–: son strings con sus caracteres en mayúsculas, y encerrados entre guiones bajos dobles (ej: __FOO__)


 * Variables: son strings con su caracteres en mayúsculas, y encerrados entre llaves dobles (ej:  ).


 * Parser functions, –funciones del analizador sintáctico, en castellano–: pueden llevar parámetros, y son del tipo   or   . (ver documentación).

El contenido de las páginas que incluyan magic words variará y dependerá de la página en cuestión, y del momento en que se visualice, incluso si la palabra mágica se incluye a través de plantillas o mensajes del sistema.

Behavior switches
Un behavior switch, –modificador de comportamiento–, controla el comportamiento habitual de la plantilla –layout– de la página, y suelen usarse para omitir o añadir contenidos, en función de lo deseado.

Variables
Las variables devuelven información sobre la página actual, wiki local, fecha u hora. La sintaxis es similar a las plantillas. Las variables marcadas como " [expensive] " son seguidas por el software MediaWiki, y el número de ellas que pueden aparecer en la mísma página, está limitado.

Se usará siempre la variable, si su nombre entra en conflicto con una plantilla con el mismo nombre, que pueda existir en la wiki local. Si se quiere usar la plantilla, se deberá usar. En algunos casos, añadir algún parámetro a la variable que entra en conflicto, hará que se interprete como una plantilla; por ejemplo:, hace que se use la plantilla     :CURRENTDAYNAME.

Fecha y hora
Las siguientes variables, devuelven la fecha y hora de acuerdo a las preferencias horarias del usuario, siendo tomadas por defecto, la zona UTC.

Debido al caché de MediaWiki y del navegador del usuario, estas variables frecuentemente muestran un valor que depende de esta misma cache, en lugar de la fecha/hora actual.

The date and time magic words are formatted in the wiki content language. Since, they depend on the page content language.

Las siguientes variables devuelven el mismo valor que las indicadas arriba, pero usando la zona horaria de la wiki local, en lugar de las preferencias horarias del usuario:

For more thorough time formatting, you may want to install Extension:ParserFunctions to use the #time parser function.

Metadatos técnicos
Estas variables devuelven datos sobre la última edición de la página en cuestión, incluso si la visualización se hace de una versión más antigua de la página.

Estadísticas
Los números devueltos por estas variables, habitualmente contienen separadores como comas, espacios o puntos, dependiendo del idioma configurado en la wiki local, pero se pueden formatear los números, con el modificador &laquo;:R&raquo;

Use "|R" for magic words that require a parameter like PAGESINCATEGORY (for example  and , or   and  ). Also applicable to  hereinbefore.

The number magic words are formatted in the wiki content language. Since, it depends on the page content language.

Page names
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":

URL encoded page names
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.

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

Parser functions
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 Help:Extension:ParserFunctions.

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

Formatting
See also: Extension:StringFunctions.

Localisation
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, ,. More magic words are added by the Translate extension.

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.