Ayuda:Palabras mágicas

De Wikipedia, la enciclopedia libre
Saltar a navegación Saltar a buscar

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 contenido, deshabilitar 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 las palabras mágicas. Para obtener más información, consulte la documentación principal de MediaWiki:

Información general

En general, hay 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 de analizador : todo en minúsculas. Una función de analizador estará seguida por 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 : estas son todas mayúsculas, por ejemplo,{{PAGENAME}}. Una variable se envolverá 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 .
  • El espacio en blanco se permite generosamente para facilitar la lectura. Se eliminará desde el principio y el final de sus palabras clave y parámetros (como también se hace dentro de las plantillas).
  • 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 se pueda mostrar (documentar), 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 a propósito para que sean diferentes a los nombres de las plantillas, y viceversa. Muchos nombres de funciones de analizador comenzarán con #( almohadilla o hash ), pero los nombres de las plantillas no comenzarán con a# , y probablemente no terminarán en :(dos puntos), o estarán en mayúsculas.
  • La sintaxis del primer parámetro es diferente. En {{#magic: p1 | p2 | p3}}, el nombre es #magicseguido 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 un :, por ejemplo {{template|p1}}.

Cambios de comportamiento

Cambiar Descripción
__TOC__ Coloca la tabla de contenido (TOC) de la página en la posición de la palabra.
__FORCETOC__ Obliga a la TOC a aparecer en su posición predeterminada, incluso cuando hay menos de cuatro encabezados. Se puede utilizar en cualquier parte de una página.
__NOTOC__ Suprime la aparición de la TOC de la página. Se puede utilizar en cualquier parte de una página.
__NOEDITSECTION__ Oculta los enlaces "editar" normalmente junto a todos los encabezados 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 de igualdad de wiki (por ejemplo, ). <h2>heading</h2>== heading == 
__NEWSECTIONLINK__ En las páginas que no son de conversación, agrega un enlace de "Nueva sección" como un medio para agregar una nueva sección a la página.
__NONEWSECTIONLINK__ Elimina el enlace "Nueva sección" (el enlace para agregar una 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. Consulte Wikipedia: Control de la indexación del motor 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 redirige (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 . (Consulte mw:Extension: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.
{{NOEXTERNALLANGLINKS}} (equivalente a {{NOEXTERNALLANGLINKS|*}}  ) Suprime la inclusión automática de enlaces entre idiomas de Wikidata en el lado izquierdo de la página. Los enlaces a determinados idiomas en lugar de a todos pueden suprimirse utilizando {{NOEXTERNALLANGLINKS| list }}, donde list a pipe - lista delimitada de códigos de idioma (por ejemplo, {{NOEXTERNALLANGLINKS|fr|es|ja}} para suprimir el francés ("fr"), el español ("es") y el japonés ("ja") enlaces interlingüísticos).

Variables

Atajo
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 altere mayúsculas y minúsculas con {{DISPLAYTITLE}}.
{{PAGENAME}} palabras mágicas Línea de título que excluye el espacio de nombres .
{{BASEPAGENAME}} palabras mágicas Título de la página principal, sin incluir 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, la parte más a la derecha del título actual ; los nombres de las 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. Estos son útiles en las páginas de discusión (pero vea la nota sobre las páginas de discusión de Categoría).
{{SUBJECTPAGENAME}} Ayuda:Palabras mágicas
{{TALKPAGENAME}} Ayuda a hablar: palabras mágicas Título de la página de discusión asociada con la página actual. Útil en las páginas de asunto.
{{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, la parte del espacio de nombres del título de la página de asunto asociada.
{{SUBJECTSPACE}} Ayuda
{{TALKSPACE}} ayudar a hablar Espacio de nombres de la página de discusión asociada con la página actual.
{{FULLPAGENAMEE}},
{{PAGENAMEE}},
 (etc)
Ayuda:Palabras_mágicas,
Palabras_mágicas,
(etc.)
 Al agregar una E al final de las variables anteriores, se codifica lo anterior para su uso en las URL de MediaWiki (es decir, con guiones bajos en lugar de espacios).
{{SHORTDESC}} Solo funciona en la 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 usan dos puntos ( :) para pasar el parámetro, en lugar de una tubería ( |) que se usa en plantillas, como {{MAGICWORD:value}}. Por ejemplo, {{TALKPAGENAME:Wikipedia:MOS}}devolucionesDiscusión de Wikipedia: MOSen cualquier página.

Nota: En los espacios de nombres "Categoría" y "Categoría de conversación", para wikilinkar (algunas) variables de nombre de página puede requerir el prefijo de dos puntos para evitar una categorización no deseada.

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

variable del sitio Producción Descripción
{{SITENAME}} Wikipedia
{{SERVER}} //en.wikipedia.org
{{SERVERNAME}} es.wikipedia.org
{{SCRIPTPATH}} /w
{{CURRENTVERSION}} 1.39.0-wmf.16 (7b42570) Devuelve la versión actual de MediaWiki.

Otras variables por tipo

Fecha y hora actual
Tiempo Universal Hora del sitio web local
Variable Producción Variable Producción
{{CURRENTYEAR}} 2022 {{LOCALYEAR}} 2022
{{CURRENTMONTH}} 06 {{LOCALMONTH}} 06
{{CURRENTMONTHNAME}} Junio {{LOCALMONTHNAME}} Junio
{{CURRENTMONTHABBREV}} Jun {{LOCALMONTHABBREV}} Jun
{{CURRENTDAY}}[a] 18 {{LOCALDAY}}[a] 18
{{CURRENTDAY2}}[a] 18 {{LOCALDAY2}}[a] 18
{{CURRENTDOW}} 6 {{LOCALDOW}} 6
{{CURRENTDAYNAME}} sábado {{LOCALDAYNAME}} sábado
{{CURRENTTIME}} 23:24 {{LOCALTIME}} 23:24
{{CURRENTHOUR}} 23 {{LOCALHOUR}} 23
{{CURRENTWEEK}} 24 {{LOCALWEEK}} 24
{{CURRENTTIMESTAMP}} 20220618232456 {{LOCALTIMESTAMP}} 20220618232456
Datos de revisión de página
Variable Producción
{{REVISIONDAY}}[a] 15
{{REVISIONDAY2}}[a] 15
{{REVISIONMONTH}} 06
{{REVISIONYEAR}} 2022
{{REVISIONTIMESTAMP}} 20220615193111
{{REVISIONUSER}}[b] rosa roja64
  1. ^ a b c d e f {{CURRENTDAY}} , {{LOCALDAY}}y {{REVISIONDAY}}devuelve el día (es decir, "6"), while {{CURRENTDAY2}}, {{LOCALDAY2}}y {{REVISIONDAY2}}devuelve el día con cero relleno (es decir, "06"). Para todos los días de dos dígitos (es decir, del 10 al 31), estos son iguales.
  2. ^ 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.
Estadísticas de wikis
{{NUMBEROFPAGES}} 56,077,404
{{NUMBEROFARTICLES}} 6,520,955
{{NUMBEROFFILES}} 893,616
{{NUMBEROFEDITS}} 1.091.225.447
{{NUMBEROFUSERS}} 43.826.966
{{NUMBEROFADMINS}} 1,034
{{NUMBEROFACTIVEUSERS}} 119,107

Funciones del analizador

Atajos

metadatos

Función Descripción
{{PAGEID}} Número de identificador de página único (por ejemplo, el ID de esta página es 3235121).
{{PAGESIZE:fullpagename}} Tamaño de la página nombrada en bytes (por ejemplo, esta página es 31,613bytes).
{{PROTECTIONLEVEL:action|fullpagename}} Nivel de protección asignado a la acción ("editar", "mover", etc.) en la página nombrada (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 nombrada (la caducidad de la protección de esta página es infinity).
{{PENDINGCHANGELEVEL}} Nivel de protección para cambios pendientes en la página actual (esta página, que no tiene, es ).
{{PAGESINCATEGORY:categoryname}} Número de páginas en la categoría denominada nombrecategoría . Cada subcategoría se cuenta como un elemento.
{{NUMBERINGROUP:groupname}} Número de usuarios en el grupo de usuarios denominado groupname .

Los ID de página se pueden asociar con artículos a través de wikilinks (es decir, Special:Redirect/page/3235121va 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.

Formateo

Función Descripción
{{lc:string}} Convierte todos los caracteres de la cadena a minúsculas.
{{lcfirst:string}} Convierte el primer carácter de la cadena a minúsculas.
{{uc:string}} Convierte todos los caracteres de la cadena a mayúsculas.
{{ucfirst:string}} Convierte el primer carácter de la 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, use (es decir , por ejemplo, produce 7654321). {{formatnum:formatted_number|R}}{{formatnum:7,654,321|R}}
{{#dateformat:date|format}}
{{#formatdate:date|format}} 		Da formato a una fecha según las preferencias del usuario; se puede dar 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, con la preferencia del usuario anulando el formato especificado.
{{padleft:xyz|stringlength}}
{{padright:xyz|stringlength}}

{{padleft:xyz|length|padstr}}
{{padright:xyz|length|padstr}} 		Relleno con ceros '0' a la derecha o izquierda, para llenar la longitud dada; se puede dar 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}} Da salida singular si N es igual a 1, de lo contrario da salida 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 de 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 a 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}} Muestra 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:Help:Magic words#gender y translatewiki:Gender .
{{#tag:tag|content with magic}} Única manera de evaluar palabras mágicas dentro de una etiqueta , para poder generar . También maneja los atributos de las etiquetas. <tag>magic</tag>

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 de archivo del archivo multimedia .
{{urlencode:string}} Codifica la cadena para su uso en cadenas de consulta de URL; {{urlencode:test string}}, por ejemplo, produce: prueba+cadena. Para codificar una cadena para su uso en rutas de 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 anclajes de sección de URL de MediaWiki .
{{ns:n}} Devuelve el nombre del espacio de nombres cuyo índice es el número n . Para las URL de MediaWiki, use {{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 ese número de segmentos.

Condicional

Función Descripción
{{#expr:expression}} Evalúa la expresión (ver m:Help:Calculation ).
{{#if:string |result1 |result2}} Muestra resultado2 si la cadena está vacía ; de lo contrario, muestra resultado1 .
{{#ifeq:string1|string2 |result1 |result2}} Muestra result1 si string1 y string2 son iguales (alfabética o numéricamente), de lo contrario, genera result2 .
{{#iferror:test_string |result1 |result2}} Muestra result1 si test_string genera un error de análisis; de lo contrario, genera result2 .
{{#ifexpr:expression |result1 |result2}} Muestra result1 si la expresión  es verdadera, de lo contrario, genera result2 .
{{#ifexist:pagetitle |result1 |result2}} Muestra result1 si la página [[ pagetitle ]] existe; de ​​lo contrario, genera result2 . Tenga en cuenta que se necesitan guiones bajos para los espacios en los espacios de nombres.
{{#switch:string |c1=r1 |c2=r2 ... |default}} Muestra 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 deben analizarse como vacíos en lugar de texto (es decir, como vacíos en lugar de texto "{{{1}}}", "{{{2}}}", etc. .), requerirán conductos finales (es decir {{{1|}}}, {{{2|}}}, , etc., en lugar de {{{1}}}, {{{2}}}, etc.).

Otro

Función Descripción
{{#babel:code1|code2|...}} Representar cajas de usuario que indiquen sus habilidades lingüísticas. Mejora sobre {{ Babel }} (una alternativa).
{{#categorytree:category|...}} Listar páginas en una categoría, recursivamente.
{{#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|...}} Use Scribunto para transcluir una plantilla lua , por ejemplo, reemplazar la función en el módulo String .
{{#language:code1|code2}} Escriba el nombre representado por el código de idioma, por ejemplo, en → English . 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 asignado actualmente para el nombre de usuario de destino, 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. (Característica 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ía un mensaje a una lista de páginas de discusión en el nombre completo de la página, usando 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 del contenido de una celda de tabla. Antes de que esto se agregara como una palabra mágica, muchos wikis implementaron esto creando Plantilla:! con |como contenido.
{{=}} Se utiliza para incluir un signo igual como parte de un argumento de plantilla o del contenido de una celda de tabla. Antes de que esto se agregara como una palabra mágica, muchos wikis implementaron esto creando Plantilla:= con =como contenido.

Ver también

Retrieved from "https://en.wikipedia.org/w/index.php?title=Help:Magic_words&oldid=1093307791#Parser_functions"
0.057507038116455