Help:Magic words/es

Las palabras mágicas son 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 de la página, etcétera. Esta página solo explica el uso de palabras mágicas estándares; para una documentación técnica véase.

Hay tres clases generales de palabras mágicas:


 * Behavior switches, –modificadores de comportamiento, en español–: son palabras en mayúsculas encerradas entre guiones bajos dobles (por ejemplo:  ).
 * Variables: palabras en mayúsculas encerradas entre llaves dobles, p.ej.  . Por eso, se parecen mucho a las plantillas.
 * Parser functions, –funciones del analizador sintáctico, en español–: pueden llevar parámetros, y son del tipo   o   e.g. . Véase también and.

El contenido de las páginas que incluyan palabras mágicas 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.



Opciones de comportamiento
Un behavior switch, –modificador de comportamiento–, controla el comportamiento habitual de la plantilla –layout– de la página (si el skin es soportado), y suelen usarse para omitir o añadir contenidos, en función de lo deseado. Notablemente algunos de ellos no son soportados por el skin Minerva.

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 " [pesado] " son seguidas por el software MediaWiki, y el número de ellas que pueden aparecer en la mísma página, está limitado.

Si el nombre de una plantilla entra en conflicto con una variable, se usará la variable (así para transcluir la plantilla, deberá escribir ). 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.

El uso de estas variable hace que las páginas se almacenen en la caché por un cantidad más limitada de segundos. Esto se configura en MagicWordFactory.

Las palabras mágicas de la fecha y hora se formatean de acuerdo con el idioma de contenido de la wiki. Desde, estas dependen del idioma de contenido de la página.

Las siguientes variables hacen lo mismo que las anteriores pero usando la configuración del servidor del sitio o.



Para un formato de hora más completo, o para generar el año y la semana actuales con un mejor cumplimiento de ISO-8601, es posible que desee instalar para usar la función de analizador de .



Estadísticas
Los números devueltos por estas variables normalmente contienen separadores (comas, puntos o espacios, dependiendo del idioma local) pero pueden devolver números raíz con ":R" (por ejemplo, $nop-code &rarr; $nop-result y $nop-r-code &rarr; $nop-r-result)

Usa "|R" en aquellas palábras mágicas que requieran párametros, como PAGESINCATEGORY (por ejemplo $pic y $pic-r, o $pic-subcats y $pic-subcats-r). También aplica a $pagesizenombre de página$pagesize-end anteriormente. También aplicable a en adelante.

El número de palabras mágicas es formateado en el idioma de contenido del wiki. Desde, depende de la idioma de la página de contenido.



Rutas de páginas
Ninguno de estos son afectados por cambios al título mostrado usando ; los valores devueltos son el título original de la página.

Las palabras mágicas  y   solo funcionan en espacios de nombre que tienen habilitado el uso de subpáginas. Véase en información sobre la habilitación de subpáginas.

Después de la versión de MediaWiki 1.15+, estas variables permiten que se le pase la ruta sobre la que han de operar –en lugar de la actual– mediante un parámetro:





Nombres de página con URL codificado
Los siguientes son equivalentes codificados para su uso en las URL de MediaWiki (por ejemplo, espacios sustituidos por guiones bajos y algunos caracteres HTML escapado utilizando la codificación de caracteres numéricos):



Note que,   y   tienen distintas implementaciones. Véase para más detalles.

Espacios de nombres
Los siguientes son equivalentes codificados para su uso en las URL de MediaWiki (espacios reemplazados con subrayados y algunos caracteres con porcentaje de codificación):



Desde 1.15+, este puede tomar un parámetro de página completa y devolverá el espacio de nombres solicitado asociado con esa página, en lugar de con la página actual:

El parámetro no debe ser un nombre de espacio de nombres:
 * &rarr; 
 * &rarr;  (Pages in main space will return empty)
 * &rarr; 
 * &rarr; 
 * &rarr; 
 * &rarr; 
 * &rarr;   (Empty)

Otros


Funciones del analizador sintáctico
Las funciones parser son muy similares a las variables, pero tienen uno, o más parámetros (técnicamente, cualquier magic word que lleve algún parámetro es una función parser), y el nombre va precedido a veces por una almohadilla para distinguirlas de las plantillas.

Esta página solo describe parser functions que son integrales para el software MediaWiki. Otras parser functions pueden ser añadidas mediante extensiones MediaWiki como la. Para aquellas, véase.



Metadatos técnicos en otras páginas


Espacios de nombres
devuelve el nombre internacionalizado actual para el espacio de nombre con el índice, nombre canónico o alias local. Por lo tanto, 6,  -file y  -img (nombre antiguo para el espacio de nombre Archivo) devolverán "     En un wiki donde el idioma de contenido es el francés,  -file-de es válido también, pero  -file-incorrect (el nombre de "Archivo" en alemán) no lo es.  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 "".

el equivalente a la codificación de direcciones de MediaWiki, pero remplaza los espacios con guiones bajos ('_') lo que lo hace utilizable en enlaces externos.

No confundas los nombres de espacio internacionalizados con nombres de espacio personalizados.

Formato
Véase también:.

Localización
Estas son las palabras mágicas que se utilizan como principales herramientas de localización. Otras palabras mágicas a menudo dependerán de la ubicación y configuración de la wiki o del idioma elegido: véase en particular #Fecha y hora, #Formato, #Varios. El agrega más palabras mágicas.

El uso de estas palabras mágicas puede ser muy complicado, y actualmente la documentación es incompleta; hay más información sobre PLURAL, GRAMMAR, GENDER.



Modificadores de transclusión
normalmente transcluye otra página, por defecto del espacio de nombres Plantilla:. Estas palabras mágicas modifican ese comportamiento.

Varios
Para la función de análisis #invoke, véase w:Wikipedia:Lua.