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 caracter 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 (ej: __FOO__)
 * Variables: son strings con su caracteres en mayúsculas, y encerrados entre doble corchete, (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.

Behaviour switches
Un behaviour 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.

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:
 *  2024 
 *  August 
 *  
 *  
 *  </tt>
 *  27 </tt>
 *  </tt>
 *  </tt>
 *  Tuesday </tt>
 *  </tt>
 *  </tt>
 *  </tt>
 *  </tt>

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;</tt>


 *  &rarr; </tt>
 *  &rarr; )</tt>

Rutas de páginas
Estas variables informan sobre la ruta de la página.

La ruta de una página está formada con la siguiente sintaxis: Nota: Para todos los ejemplos, se tomará como si se estuviera en la página: Help:Title/Subtitle/Foo1/Foo2</tt>.
 * &lt;Namespace>:&lt;Título_principal>/&lt;Sub_página1>/&lt;Sub_pagina2>...</tt>
 * Pudiendo faltar el &lt;Namespace></tt> (en caso de usar el principal), o las &lt;Sub_paginas></tt>

Las siguientes parser functions, son similares a las anteriores, pero devuelven el valor preparado con el formato de las URL (cambiando los caracteres especiales, por sus homólogos, pudiendo usarse el título como enlace externo): En estos ejemplos, se pueden ver las diferencias entre las dos formas propuestas:
 * <tt> </tt>
 * <tt> </tt>
 * <tt> </tt>
 * <tt> </tt>
 * <tt> </tt>
 * <tt> </tt>
 * <tt> </tt>
 * <tt> </tt>
 * <tt> </tt>

Después de la versión de MediaWiki, estas variables permiten que se le pase la ruta sobre la que han de operar –en lugar de la actual– mediante un parámetro:
 * <tt> &rarr; </tt>
 * <tt> &rarr; </tt>
 * <tt> &rarr; </tt>

Parser functions

 * Para las diez funciones de la Extensión:ParserFunctions: expr, if, ifeq, ifexpr, iferror, ifexist, rel2abs, switch, time y titleparts, consultar: Help:Extension:ParserFunctions

Las parser functions son muy similares a las variables, pero tienen uno, o más parámetros. Conceptual, y técnicamente hablando, cualquier magic word que lleve algún parámetro, es una parser function.

Esta página sólo describe las parser functions que se integran por defecto con el software MediaWiki.

URL
Estas parser functions toman como parámetro el título completo de una página –<tt>&lt;Namespace>:&lt;Título_principal>/&lt;Sub_página1>/&lt;Sub_pagina2>...</tt>–, y devuelven la URL asociada a la misma.

Nota: Para todos los ejemplos que sigan, se usará de parámetro el título: <tt>Help:Title/Foo</tt>.

Namespaces
devuelve el nombre del namespace –en la wikipedia local– que se requiere mediante un parámetro que puede ser numérico, o un string.

Formato de cadenas de texto
Las funciones que se listan a continuación, realizan conversiones en el formato de la cadena de texto que se le pasa como parámetro.

Modificadores de plantilla
Las siguientes parser functions toman como parámetro el nombre de una plantilla, y realizan alguna operación o modificación sobre la misma a la hora de mostrarla o pegarla en la página anfitrión.

Enlaces externos

 * Código fuente de Language.php, para configurar los valores de las variables, en el idioma de la wiki local.
 * Código fuente de MagicWord.php