Ayuda:Palabras mágicas

Las palabras mágicas (incluidas las funciones del analizador , las variables y los cambios de comportamiento ) son características del marcado wiki que dan instrucciones al software MediaWiki subyacente de Wikipedia . Por ejemplo, las palabras mágicas pueden suprimir o posicionar la tabla de contenidos, desactivar la indexación por parte de motores de búsqueda externos y producir resultados dinámicamente basados ​​en la página actual o en la lógica condicional definida por el usuario. Algunas de estas características son especialmente útiles para las plantillas .

Esta página es una referencia rápida para palabras mágicas. Para obtener más información, consulte la documentación principal de MediaWiki:

  • mw:Ayuda:Palabras mágicas: todas las palabras mágicas estándar, incluidas las funciones del analizador "estándar".
  • mw:Ayuda:Extensión:ParserFunctions: funciones adicionales del analizador, incluidas expresiones condicionales.

información general

En general, existen tres tipos de palabras mágicas.

  1. Cambios de comportamiento : a menudo aparecen en guiones bajos dobles, todos en mayúsculas, por ejemplo, __NOTOC__. Cambiarán el comportamiento de una página, en lugar de devolver un valor.
  2. Funciones del analizador : todas en minúsculas. Una función de analizador irá seguida de dos puntos y parámetros separados por barras verticales, por ejemplo {{#ifexpr:Y|Yes|No}}, entre llaves dobles. Tomarán un valor y devolverán un valor.
  3. Variables : todas están en mayúsculas, por ejemplo, {{PAGENAME}}. Una variable estará entre llaves dobles y devolverá un valor en su lugar.

El software generalmente interpreta las palabras mágicas de la siguiente manera:

  • Las palabras mágicas distinguen entre mayúsculas y minúsculas .
  • Se permiten generosamente espacios en blanco para facilitar la lectura. Se eliminará del principio y del final de sus palabras clave y parámetros (como también se hace en las llamadas de plantilla que utilizan parámetros con nombre).
  • Se pueden transcluir , incluso variables "sobre la página actual". Esto está garantizado por el orden de análisis.
  • En lugar de transformarse mágicamente en instrucciones HTML, las etiquetas eliminan esta magia para que una palabra mágica pueda mostrarse (documentarse), por ejemplo, o .<nowiki><nowiki>{{#magic:}}</nowiki>{{#magic:<nowiki/>}}

Palabras mágicas comparadas con plantillas:

  • Al igual que con las plantillas, las palabras mágicas se pueden transcluir y sustituir .
  • Los nombres de las palabras mágicas se eligen intencionalmente para que no se parezcan a los nombres de las plantillas, y viceversa. Muchos nombres de funciones del analizador comenzarán con #( libra o hash ), pero los nombres de las plantillas no comenzarán con a# y probablemente no terminarán en :(dos puntos) o estarán completamente en mayúsculas.
  • La sintaxis del primer parámetro es diferente. En {{#magic: p1 | p2 | p3}}, el nombre es #magicy va seguido de un :parámetro de entrada obligatorio y sin espacios, p1. Con una plantilla, p1es opcional y está precedido por una |(tubería) en lugar de a :, por ejemplo {{template|p1}}.

La mayoría de las palabras mágicas se pueden utilizar en cualquier lugar necesario de una página; consulte MOS:ORDER para obtener orientación sobre dónde colocar las palabras mágicas que cambian el comportamiento.

Cambios de comportamiento

Cambiar Descripción
__TOC__ Coloca la tabla de contenido (TOC) de la página en la posición de la palabra. Esta palabra mágica no funciona en máscaras que presentan la tabla de contenido fuera del contenido del artículo, por ejemplo, la máscara predeterminada Vector 2022.
__FORCETOC__ Obliga a que la tabla de contenidos aparezca en su posición predeterminada, incluso cuando hay menos de cuatro títulos. Se puede utilizar en cualquier parte de una página. Esta palabra mágica no funciona en máscaras que presentan la tabla de contenido fuera del contenido del artículo, por ejemplo, la máscara predeterminada Vector 2022.
__NOTOC__ Suprime la apariencia del TOC de la página. Se puede utilizar en cualquier parte de una página.
__NOEDITSECTION__ Oculta los enlaces de "editar" normalmente junto a todos los títulos de la página. Para ocultar el enlace de edición al lado de un encabezado en particular , especifique el encabezado usando, por ejemplo, una etiqueta HTML como en lugar de la sintaxis habitual de signos iguales de wiki (por ejemplo , ). <h2>heading</h2>== heading ==
__ARCHIVEDTALK__ Oculta el botón "Responder"
__NEWSECTIONLINK__ En páginas que no son de discusión, agrega un enlace "Nueva sección" como medio para agregar una nueva sección a la página.
__NONEWSECTIONLINK__ Elimina el enlace "Nueva sección" (el enlace para agregar nueva sección) en las páginas de discusión.
__NOGALLERY__ Reemplaza las miniaturas en una página de categoría con enlaces normales.
__HIDDENCAT__ Oculta una categoría cuando se incluye en la página de esa categoría.
__INDEX__ Indica a los motores de búsqueda que indexen la página.
__NOINDEX__ Indica a los motores de búsqueda que no indexen la página. Ver Wikipedia: Control de la indexación de los motores de búsqueda .
__STATICREDIRECT__ Evita que el enlace en una página de redireccionamiento se actualice automáticamente cuando se mueve la página a la que redirecciona (y se selecciona "Actualizar cualquier redireccionamiento que apunte al título original").
__DISAMBIG__ Marca una página como página de desambiguación , la agrega a Special:DisambiguationPages y coloca enlaces internos en Special:DisambiguationPageLinks . (Ver mw:Extensión:Desambiguador.)
{{DISPLAYTITLE:title}} Se utiliza para modificar la forma mostrada del título de la página.
{{DEFAULTSORT:sortkey}} Establece la clave predeterminada (el índice) bajo la cual se clasifica la página. La funcionalidad está documentada en Ayuda: Categoría § Clave de clasificación predeterminada y las pautas se encuentran en Wikipedia: Categorización § Claves de clasificación .
{{NOEXTERNALLANGLINKS}} (equivalente a {{NOEXTERNALLANGLINKS:*}} ) Suprime la inclusión automática de enlaces interlenguaje de Wikidata en el lado izquierdo de la página. Los enlaces a idiomas concretos, en lugar de a todos, se pueden suprimir utilizando {{NOEXTERNALLANGLINKS: list }}, donde se muestra una barra vertical : lista delimitada de códigos de idiomas (por ejemplo, {{NOEXTERNALLANGLINKS:fr|es|ja}} para suprimir el francés ("fr "), enlaces interlingüísticos en español ("es") y japonés ("ja").

variables

  • WP:VAR
variable de nombre de página Producción Descripción
{{FULLPAGENAME}} Ayuda:Palabras mágicas Nombre de la página canónica . Línea de título . Título a menos que se modifique la letra mayúscula con {{DISPLAYTITLE}}.
{{PAGENAME}} palabras mágicas Línea de título excluyendo el espacio de nombres .
{{BASEPAGENAME}} palabras mágicas Título de la página principal, excluyendo el espacio de nombres.
{{ROOTPAGENAME}} palabras mágicas Título del padre superior (antes de todas las subpáginas), excluyendo el espacio de nombres.
{{SUBPAGENAME}} palabras mágicas En una subpágina, parte más a la derecha del título actual ; Los nombres de subpáginas superiores se muestran como vínculos de retroceso .
{{ARTICLEPAGENAME}} Ayuda:Palabras mágicas Título de la página de asunto asociada con la página actual. Son útiles en las páginas de discusión (pero consulte la nota sobre las páginas de discusión de categorías).
{{SUBJECTPAGENAME}} Ayuda:Palabras mágicas
{{TALKPAGENAME}} Charla de ayuda:Palabras mágicas. Título de la página de discusión asociada con la página actual. Útil en páginas temáticas.
{{NAMESPACENUMBER}} 12 Número del espacio de nombres de la página actual.
{{NAMESPACE}} Ayuda Espacio de nombres del título.
{{ARTICLESPACE}} Ayuda En una página de discusión, el espacio de nombres forma parte del título de la página de asunto asociada.
{{SUBJECTSPACE}} Ayuda
{{TALKSPACE}} ayuda a hablar Espacio de nombres de la página de discusión asociada con la página actual.
{{FULLPAGENAMEE}},
{{PAGENAMEE}},
 (etc.)
Ayuda:Magic_words,
Magic_words,
(etc.)
Al agregar una E al final de las variables anteriores, se genera lo anterior codificado para su uso en las URL de MediaWiki (es decir, con guiones bajos que reemplazan los espacios).
{{SHORTDESC}} Solo funciona en Wikipedia en inglés, donde muestra una breve descripción debajo del título del artículo en plataformas móviles. Ver Wikipedia: Breve descripción .

Nota: Las palabras mágicas anteriores también pueden tomar un parámetro para analizar valores en una página que no sea la página actual. Se utilizan dos puntos ( :) para pasar el parámetro, en lugar de una barra vertical ( |) que se utiliza en plantillas, como {{MAGICWORD:value}}. Por ejemplo, {{TALKPAGENAME:Wikipedia:MOS}}devolucionesCharla de Wikipedia: MOSen cualquier página.

Nota: En los espacios de nombres "Categoría" y "Discusión de categoría", para vincular wiki (algunas) variables de nombre de página puede ser necesario anteponer dos puntos para evitar una categorización no deseada.

Para obtener más detalles sobre las funciones del analizador relacionadas con nombres de páginas y espacios de nombres, consulte: meta:Ayuda:Nombre de la página § Variables y funciones del analizador.

variable de sitio Producción Descripción
{{SITENAME}} Wikipedia Nombre del sitio ($wgSitename).
{{SERVER}} //es.wikipedia.org URL del dominio ($wgServer).
{{SERVERNAME}} es.wikipedia.org Subdominio y nombre de dominio.
{{ARTICLEPATH}} /wiki/$1 Ruta relativa del artículo ($wgArticlePath).
{{SCRIPTPATH}} /w Ruta de secuencia de comandos relativa ($wgScriptPath).
{{STYLEPATH}} /w/pieles Ruta de estilo relativa ($wgStylePath).
{{CURRENTVERSION}} 1.42.0-wmf.26 (8f44039) Devuelve la versión actual de MediaWiki.

Otras variables por tipo

Fecha y hora actuales
Tiempo Universal Hora del sitio web local
Variable Producción Variable Producción
{{CURRENTYEAR}} 2024 {{LOCALYEAR}} 2024
{{CURRENTMONTH}} 04 {{LOCALMONTH}} 04
{{CURRENTMONTHNAME}} Abril {{LOCALMONTHNAME}} Abril
{{CURRENTMONTHABBREV}} Abr {{LOCALMONTHABBREV}} Abr
{{CURRENTDAY}}[a] 13 {{LOCALDAY}}[a] 13
{{CURRENTDAY2}}[a] 13 {{LOCALDAY2}}[a] 13
{{CURRENTDOW}} 6 {{LOCALDOW}} 6
{{CURRENTDAYNAME}} Sábado {{LOCALDAYNAME}} Sábado
{{CURRENTTIME}} 15:23 {{LOCALTIME}} 15:23
{{CURRENTHOUR}} 15 {{LOCALHOUR}} 15
{{CURRENTWEEK}} 15 {{LOCALWEEK}} 15
{{CURRENTTIMESTAMP}}[b] 20240413152316 {{LOCALTIMESTAMP}}[b] 20240413152316
Datos de revisión de página
Variable Producción
{{REVISIONDAY}}[a] 1
{{REVISIONDAY2}}[a] 01
{{REVISIONMONTH}} 04
{{REVISIONYEAR}} 2024
{{REVISIONTIMESTAMP}}[b] 20240401235038
{{REVISIONUSER}}[C] Qué estoy haciendo
Estadísticas wiki
{{NUMBEROFPAGES}} 60.417.774
{{NUMBEROFARTICLES}} 6.811.691
{{NUMBEROFFILES}} 915.402
{{NUMBEROFEDITS}} 1.213.994.751
{{NUMBEROFUSERS}} 47.245.182
{{NUMBEROFADMINS}} 861
{{NUMBEROFACTIVEUSERS}} 123,943

Funciones del analizador

  • WP:PF
  • WP: ANALIZADOR

Metadatos

Función Descripción
{{PAGEID}} Número de identificador de página único (por ejemplo, el ID de esta página es3235121).
{{PAGESIZE:fullpagename}}[d] Tamaño de la página nombrada en bytes (por ejemplo, esta página es34.929bytes).
{{PROTECTIONLEVEL:action|fullpagename}} Nivel de protección asignado a la acción ("editar", "mover", etc.) en la página denominada (el nivel de protección de esta página para "editar" es autoconfirmed).
{{PROTECTIONEXPIRY:action|fullpagename}} Caducidad de la protección asignada a la acción ("editar", "mover", etc.) en la página denominada (la caducidad de la protección de esta página es infinity).
{{PENDINGCHANGELEVEL:fullpagename}} Nivel de protección para cambios pendientes en la página nombrada (esta página, que no tiene uno, es ).
{{PAGESINCATEGORY:categoryname}} Número de páginas en la categoría denominada nombrecategoría . Cada subcategoría se cuenta como un artículo.
{{NUMBERINGROUP:groupname}} Número de usuarios en el grupo de usuarios denominado nombre de grupo .

Los ID de página se pueden asociar con artículos a través de enlaces wiki (es decir, Special:Redirect/page/3235121van a esta página). Para generar números sin separadores de coma (por ejemplo, como "123456789" en lugar de "123,456,789"), agregue el parámetro |R.

Formato

Función Descripción
{{lc:string}} Convierte todos los caracteres de una cadena a minúsculas.
{{lcfirst:string}} Convierte el primer carácter de una cadena a minúsculas.
{{uc:string}} Convierte todos los caracteres de una cadena a mayúsculas.
{{ucfirst:string}} Convierte el primer carácter de una cadena a mayúsculas.
{{formatnum:unformatted_number}}
{{formatnum:formatted_num |R}}
Agrega separadores de coma a un número_sin formato (por ejemplo, 123456789 se convierte en 123.456.789). Para eliminar dicho formato, utilice (es decir , por ejemplo, produce 7654321). {{formatnum:formatted_number|R}}{{formatnum:7,654,321|R}}
{{#dateformat:date|format}}
{{#formatdate:date|format}}
Formatea una fecha según las preferencias del usuario; se puede proporcionar un valor predeterminado como un segundo parámetro opcional que distingue entre mayúsculas y minúsculas para usuarios sin preferencia de fecha; puede convertir una fecha de un formato existente a cualquiera de los formatos dmy, mdy, ymdo ISO 8601, y la preferencia del usuario anula el formato especificado.
{{padleft:xyz|stringlength}}
{{padright:xyz|stringlength}}

{{padleft:xyz|length|padstr}}
{{padright:xyz|length|padstr}}
Rellene con ceros '0' a la derecha o a la izquierda, para llenar la longitud dada; se puede proporcionar una cadena de relleno alternativa como tercer parámetro; la cadena de relleno repetida ( padstr ) se truncará si su longitud no divide uniformemente el número requerido de caracteres.
{{plural:N|singular|plural}} Genera singular si N es igual a 1; de lo contrario, genera plural . Consulte la documentación en mediawiki.org para obtener más detalles.
{{#time:format|object}}
{{#timel:format|object}}

{{#time:d F Y|date|langcode}}
Se utiliza para formatear fechas y horas, para formato ISO, puntos o nombres de meses en inglés. #timelse basa en la hora local definida para cada wiki; para Wikipedia en inglés, esto es idéntico a #time.
El tercer parámetro opcional es el código del idioma de salida (francés, alemán, sueco: fr, de, sv, etc.). Ejemplo finlandés: {{#time:d F Y|June 30, 2016|fi}}espectáculos: 30 kesäkuu 2016 (junio). ISO al alemán: {{#time:d. M Y|1987-10-31|de}}muestra: 31. Okt. 1987.
Para códigos de formato, consulte: mw:Help:Extension:ParserFunctions##time. Utilice el formato {{#time: H:i, j F Y (e)|...}}para que coincida con el formato utilizado por las marcas de tiempo en las firmas.
{{gender:user|m_out|f_out|u_out}} Genera m_out , f_out o u_out según si el género especificado en las preferencias del usuario es, respectivamente, masculino, femenino o no especificado. Hay otras permutaciones de parámetros disponibles, consulte mw:Ayuda:Palabras mágicas#género y Translatewiki:Género.
{{#tag:tagname|content with magic}} Única forma de evaluar palabras mágicas dentro de una etiqueta , para poder generarlas . También maneja atributos de etiquetas. Detalles en mw:Ayuda:Palabras mágicas#etiqueta. <tagname>magic</tagname>

Caminos

Función Descripción
{{localurl:fullpagename |query}} Ruta relativa al nombre de la página. El parámetro de consulta es opcional.
{{fullurl:fullpagename |query}} Ruta absoluta, sin prefijo de protocolo (es decir, sin " http: ", etc.), al nombre de la página. El parámetro de consulta es opcional.
{{canonicalurl:fullpagename |query}} Ruta absoluta, incluido el prefijo de protocolo, al nombre de la página. El parámetro de consulta es opcional.
{{filepath:filename}} Ruta absoluta al nombre del archivo multimedia .
{{urlencode:string}} Codifica cadenas para usar en cadenas de consulta de URL; {{urlencode:test string}}, por ejemplo, produce: prueba+cadena. Para codificar una cadena para su uso en rutas URL o nombres de páginas de MediaWiki, agregue, respectivamente, |PATHo |WIKI(para producir "test%20string" o "test_string").
{{anchorencode:string}} Entrada codificada para su uso en los anclajes de la sección URL de MediaWiki .
{{ns:n}} Devuelve el nombre del espacio de nombres cuyo índice es el número n . Para las URL de MediaWiki, utilice {{nse:}}.
{{#rel2abs:path}} Convierte una ruta de archivo relativa en una ruta absoluta.
{{#titleparts:fullpagename|number|first segment}} Divide el nombre completo de la página (título) en esa cantidad de segmentos.

Condicional

Función Descripción
{{#expr:expression}} Evalúa la expresión (ver m:Ayuda:Cálculo).
{{#if:string |result1 |result2}} Genera resultado2 si la cadena está vacía ; de lo contrario, genera resultado1 .
{{#ifeq:string1|string2 |result1 |result2}} Genera resultado1 si cadena1 y cadena2 son iguales (alfabéticamente o numéricamente); de lo contrario, genera resultado2 .
{{#iferror:test_string |result1 |result2}} Genera resultado1 si test_string genera un error de análisis; de lo contrario, genera resultado2 .
{{#ifexpr:expression |result1 |result2}} Genera resultado1 si la expresión es verdadera; de lo contrario, genera resultado2 .
{{#ifexist:pagetitle |result1 |result2}}[d] Genera resultado1 si la página [[ título de página ]] existe; de ​​lo contrario, genera resultado2 . Tenga en cuenta que se necesitan guiones bajos para los espacios en los espacios de nombres.
{{#switch:string |c1=r1 |c2=r2 ... |default}} Genera r1 si la cadena es c1 , r2 si la cadena es c2 , etc.; de lo contrario, genera el valor predeterminado (si se proporciona).

Si, en estas funciones condicionales, los parámetros vacíos sin nombre se van a analizar como vacíos en lugar de como texto (es decir, como vacíos en lugar de como texto "{{{1}}}", "{{{2}}}", etc. .), requerirán tuberías de arrastre (es decir {{{1|}}}, {{{2|}}}, , etc., en lugar de {{{1}}}, {{{2}}}, etc.).

Otro

Función Descripción
{{#babel:code1|code2|...}} Renderice cajas de usuario que indiquen sus habilidades lingüísticas. Mejora {{ Babel }} (una alternativa).
{{#categorytree:category|...}} Enumere páginas en una categoría, de forma recursiva.
{{#coordinates:arg1|arg2|...}} Guarde las coordenadas GeoData del sujeto en la base de datos de la página. Usado en {{ coord }}.
{{#invoke:module|function|arg1|...}} Utilice Scribunto para transcluir una plantilla lua , por ejemplo, función de reemplazo en el módulo String .
{{#language:code1|code2}} Imprima el nombre representado por el código de idioma, por ejemplo, enInglés . Imprima en el idioma 2 si se proporciona, por ejemplo, {{#language:en|zh}}imprime 英语
{{#lst:}}, {{#lsth:}}, {{#lstx:}} Tres formas de transcluir una sección de una página .
{{#mentor:Username}} Muestra el mentor actualmente asignado para el nombre de usuario objetivo, si está configurado.
{{#property:arg1|arg2|...}} Incluya una propiedad ( Wikidata ) de una entidad con nombre, en lugar de la predeterminada en la página.
{{#related:...}} Enlaces a temas similares para atraer a los lectores. (Función beta).
{{#section:}}, {{#section-h:}}, {{#section-x:}} Alias ​​para {{#lst:}}, {{#lsth}}, {{#lstx}}(arriba).
{{#statements:arg1|...}} Muestra el valor de cualquier declaración (Wikidata) incluida en un elemento.
{{#target:fullpagename}} Envíe un mensaje a una lista de páginas de discusión con el nombre completo de la página, utilizando la función MassMessage.
{{int:pagename}} Transcluir un mensaje de interfaz , es decir, un nombre de página en el espacio de nombres de MediaWiki
{{!}} Se utiliza para incluir un carácter de barra vertical como parte de un argumento de plantilla o contenido de celda de tabla. Antes de que esto se agregara como palabra mágica, muchos wikis lo implementaban creando Plantilla:! con |como contenido.
{{=}} Se utiliza para incluir un signo igual como parte de un argumento de plantilla o contenido de celda de tabla. Antes de que esto se agregara como palabra mágica, muchos wikis lo implementaban creando Plantilla:= como =contenido.

Sustituyendo y anidando

Las palabras mágicas a veces pueden comportarse de forma extraña cuando se sustituyen o anidan. Es posible sustituir algunas palabras mágicas (para que la página deje de actualizarse si cambia el valor de la palabra). A continuación se muestran algunos ejemplos de cómo funciona esto:

signo de interrogación azul? Código Producción
Símbolo X rojonorte {{PAGESIZE}} 0
Marca de verificación verdeY {{PAGESIZE:Help:Magic words}} 34.929
Marca de verificación verdeY {{subst:PAGESIZE:Help:Magic words}} 34.929
Marca de verificación verdeY {{PAGESIZE:{{FULLPAGENAME}}}} 34.929
Símbolo X rojonorte {{subst:PAGESIZE:{{FULLPAGENAME}}}} 0
Marca de verificación verdeY {{PAGESIZE:{{subst:FULLPAGENAME}}}} 34.929
Marca de verificación verdeY {{subst:PAGESIZE:{{subst:FULLPAGENAME}}}} 34.929

Ver también

  • mw: localización
  • mw:Manual:Extensión del marcado wiki
  • CoreParserFunctions.php
  • Preferencias  → Gadgets  → Edición → Resaltador de sintaxiscontrolar
  • Preferencias  → Funciones Beta  → Resaltado de sintaxis Wikicontrolar
  • Especial: Versión , consulte la última sección "Enganches de funciones del analizador": una lista que debe incluir todas las palabras mágicas de esta página
  • {{ Ifexist not refund }}, funciona con la {{#ifexist:}}expresión y permite identificar y analizar los redireccionamientos de forma diferente

Notas

  1. ^ abcdef {{CURRENTDAY}}y devolver el día (por ejemplo, {{LOCALDAY}}"{{REVISIONDAY}}6"), mientras que {{CURRENTDAY2}}y {{LOCALDAY2}}devuelve {{REVISIONDAY2}}el día con relleno de ceros (por ejemplo, "06"). Para todos los días de dos dígitos (es decir, del 10 al 31), son los mismos.
  2. ^ abc Estas salidas de marca de tiempo se pueden formatear con {{ Format revisiontimestamp }} (también conocido como {{ FRTS }}). Por ejemplo, {{ FRTS |{{REVISIONTIMESTAMP}}}} convierte "20240401235038" en "2024-04-01 23:50:38".
  3. ^ Esto muestra el último usuario que editó la página. No hay forma de mostrar al usuario que está viendo la página con palabras mágicas debido a restricciones técnicas.
  4. ^ ab Esta función es una función de analizador costosa .
Obtenido de "https://en.wikipedia.org/w/index.php?title=Help:Magic_words&oldid=1216784923#Parser_functions"