Ayuda: palabras mágicas

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

Las palabras mágicas (incluidas las funciones del analizador , las variables y los interruptores 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 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 funciones 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:

Información general

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

  1. Interruptores de comportamiento : a menudo aparecen en guiones dobles, todo 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 será seguida por dos puntos y parámetros separados por tubería, por ejemplo,{{#ifexpr:Y|Yes|No}}entre llaves dobles. Tomarán un valor y devolverán un valor.
  3. Variables : son todas en mayúsculas, por ejemplo,{{PAGENAME}}. Una variable se incluirá 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 permite generosamente el espacio en blanco 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 se pueda mostrar (documentar) una palabra mágica, por ejemplo, o .<nowiki><nowiki>{{#magic:}}</nowiki>{{#magic:<nowiki />}}

Palabras mágicas en comparación 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 deliberadamente para que sean diferentes a los nombres de las plantillas y viceversa. Muchos nombres de funciones del analizador comienzan con una #( almohadilla o almohadilla ), pero los nombres de las plantillas no comienzan con una# , y probablemente no terminan en una :(dos puntos), ni están en mayúsculas.
  • La sintaxis del primer parámetro es diferente. En {{#magic: p1 | p2 | p3}}, el nombre es #magicy es seguido por un sin espacios :y un parámetro de entrada necesaria, p1. Con una plantilla, p1es opcional y está precedida por una |(barra vertical) en lugar de una :, por ejemplo {{template|p1}}.

Interruptores de comportamiento

Cambiar Descripción
__TOC__ Coloca la tabla de contenido de la página (TOC) en la posición de la palabra.
__FORCETOC__ Obliga a la TOC a aparecer en su posición predeterminada. Puede usarse en cualquier lugar de una página.
__NOTOC__ Suprime la apariencia de la tabla de contenido de la página. Puede usarse en cualquier lugar de una página.
__NOEDITSECTION__ Oculta los enlaces "editar" normalmente junto a todos los títulos de la página. Para ocultar el enlace de edición junto a un encabezado en particular , especifique el encabezado usando, por ejemplo, una etiqueta HTML como en lugar de con la sintaxis habitual de signos iguales de wiki (por ejemplo ). <h2>heading</h2>== heading == 
__NEWSECTIONLINK__ En las páginas que no son de discusión, agrega un enlace "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__ Hace que una categoría esté oculta 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 de una página de redireccionamiento se actualice automáticamente cuando se mueve la página a la que redirecciona (y se selecciona "Actualizar los redireccionamientos que apuntan al título original"). También indica a los bots de interwiki que traten la página como si fuera un artículo.
__DISAMBIG__ Marca una página como una página de desambiguación , la agrega a Special: DisambiguationPages y coloca enlaces internos en Special: DisambiguationPageLinks . (Ver mw: Extensión: Disambiguator .)
{{DISPLAYTITLE:title}} Se utiliza para modificar la forma mostrada del título de la página.
{{DEFAULTSORT:sortkey}} Establece la clave predeterminada (el índice) en la que 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 los idiomas se pueden suprimir utilizando {{NOEXTERNALLANGLINKS | lista }}, donde la lista de una tubería - delimitado lista de códigos de idioma (por ejemplo, {{NOEXTERNALLANGLINKS | FR | ES | ja}} para suprimir los franceses ( "fr"), español ( "es") y japonés ( "ja") enlaces entre idiomas).

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 modifique el tipo de letra {{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, excluido 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 subpágina superiores se muestran como vínculos de retroceso .
{{ARTICLEPAGENAME}} Ayuda: palabras mágicas Título de la página del tema 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 páginas temáticas.
{{NAMESPACENUMBER}} 12 Número del espacio de nombres de la página actual.
{{NAMESPACE}} Ayudar Espacio de nombre del título.
{{ARTICLESPACE}} Ayudar En una página de discusión, el espacio de nombres forma parte del título de la página de tema asociada.
{{SUBJECTSPACE}} Ayudar
{{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, lo anterior se codifica para su uso en las URL de MediaWiki (es decir, con guiones bajos que reemplazan los 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 barra vertical ( |) que se usa en plantillas, como {{MAGICWORD:value}}. Por ejemplo, {{TALKPAGENAME:Wikipedia:MOS}}devuelveCharla de Wikipedia: MOS en cualquier página.

Nota: En los espacios de nombres de "Categoría" y "Discusión de categoría", es posible que para establecer un enlace de wik en (algunas) variables de nombre de página sea necesario colocar un 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 página y los 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
{{SERVER}} //en.wikipedia.org
{{SERVERNAME}} en.wikipedia.org
{{SCRIPTPATH}} / w
{{CURRENTVERSION}} 1.37.0-wmf.23 (83f72c5) 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}} 2021 {{LOCALYEAR}} 2021
{{CURRENTMONTH}} 09 {{LOCALMONTH}} 09
{{CURRENTMONTHNAME}} septiembre {{LOCALMONTHNAME}} septiembre
{{CURRENTMONTHABBREV}} sep {{LOCALMONTHABBREV}} sep
{{CURRENTDAY}} 23 {{LOCALDAY}} 23
{{CURRENTDAY2}} 23 {{LOCALDAY2}} 23
{{CURRENTDOW}} 4 {{LOCALDOW}} 4
{{CURRENTDAYNAME}} jueves {{LOCALDAYNAME}} jueves
{{CURRENTTIME}} 07:19 {{LOCALTIME}} 07:19
{{CURRENTHOUR}} 07 {{LOCALHOUR}} 07
{{CURRENTWEEK}} 38 {{LOCALWEEK}} 38
{{CURRENTTIMESTAMP}} 20210923071959 {{LOCALTIMESTAMP}} 20210923071959

Datos de revisión de la página
Variable Producción
{{REVISIONDAY}} 28
{{REVISIONDAY2}} 28
{{REVISIONMONTH}} 08
{{REVISIONYEAR}} 2021
{{REVISIONTIMESTAMP}} 20210828190022
{{REVISIONUSER}}a Rosa roja64
a Esto muestra el último usuario que editó la página. No hay forma de mostrar al usuario que ve la página debido a restricciones técnicas.

Estadísticas de wiki
{{NUMBEROFPAGES}} 54,235,487
{{NUMBEROFARTICLES}} 6.381.170
{{NUMBEROFFILES}} 894,077
{{NUMBEROFEDITS}} 1.041.229.172
{{NUMBEROFUSERS}} 42,252,653
{{NUMBEROFADMINS}} 1.082
{{NUMBEROFACTIVEUSERS}} 125,691

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 tiene 29.285 bytes).
{{PROTECTIONLEVEL:action|fullpagename}} Nivel de protección asignado a la acción ("editar", "mover", etc.) en la página nombrada.
{{PROTECTIONEXPIRY:action|fullpagename}} Caducidad de la protección asignada a la acción ("editar", "mover", etc.) en la página nombrada.
{{PENDINGCHANGELEVEL}} Nivel de protección para cambios pendientes en la página actual.
{{PAGESINCATEGORY:categoryname}} Número de páginas de la categoría denominada nombre de categoría . Cada subcategoría se cuenta como un artículo.
{{NUMBERINGROUP:groupname}} Número de usuarios del grupo de usuarios denominado groupname .

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 una cadena a minúsculas.
{{lcfirst:string}} Convierte el primer carácter de la cadena a minúsculas.
{{uc:string}} Convierte todos los caracteres en 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_no formateado (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 de acuerdo con 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 los usuarios sin preferencia de fecha; puede convertir una fecha en un formato existente a cualquiera de dmy, mdy, ymd, o ISO 8601formatos, con preferencia del usuario anular 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 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}} Salidas en singular si N es igual a 1, de lo contrario, salidas en 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, 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}}muestra: 30 kesäkuu 2016 (junio). ISO a alemán: {{#time:d. M Y|1987-10-31|de}}muestra: 31. Okt. 1987.
Para los códigos de formato, consulte: mw: Ayuda: Extensión: 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}} Salidas m_out , F_OUT o u_out según si el género especifica en usuario  preferencias de s es, respectivamente, macho, hembra o no especificado. Hay otras permutaciones de parámetros disponibles, consulte mw: Ayuda: Palabras mágicas # género y translatewiki: Género .
{{#tag:tag|content with magic}} Única forma de evaluar palabras mágicas dentro de una etiqueta , con el fin de generar . También maneja atributos de etiquetas. <tag>magic</tag>

Caminos

Función Descripción
{{localurl:fullpagename |query}} Relativa camino a 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 la cadena para su uso en cadenas de consulta de URL; {{urlencode:test string}}, por ejemplo, produce: prueba + cadena. Para codificar cadenas 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 de la página completo (título) en ese número de segmentos.

Condicional

Función Descripción
{{#expr:expression}} Evalúa la expresión (consulte m: Ayuda: Cálculo ).
{{#if:string |result1 |result2}} Emite result2 si la cadena está vacía ; de lo contrario, emite result1 .
{{#ifeq:string1|string2 |result1 |result2}} Salidas RESULT1 si cadena1 y cadena2 son iguales (orden alfabético o numérico), de lo contrario salidas result2 .
{{#iferror:test_string |result1 |result2}} Emite result1 si test_string genera un error de análisis; de lo contrario, emite result2 .
{{#ifexpr:expression |result1 |result2}} Emite result1 si expresión  es verdadera; de lo contrario, emite result2 .
{{#ifexist:pagetitle |result1 |result2}} Emite result1 si la página [[ pagetitle ]] existe; de ​​lo contrario, emite result2 . Tenga en cuenta que se necesitan guiones bajos para los espacios en los espacios de nombres.
{{#switch:string |c1=r1 |c2=r2 ... |default}} Emite r1 si la cadena es c1 , r2 si la cadena es c2 , etc., de lo contrario, emite la salida por defecto (si se proporciona).

Si, en estas funciones condicionales, los parámetros vacíos sin nombre deben analizarse como vacíos en lugar de como texto (es decir, como vacíos en lugar de como el texto "{{{1}}}", "{{{2}}}", etc. .), requerirán tuberías de salida (es decir {{{1|}}}, {{{2|}}}, etc., en lugar de {{{1}}}, {{{2}}}, etc.).

Otro

Función Descripción
{{#babel:code1|code2|...}} Render userboxes diciendo a sus conocimientos del idioma. Mejora sobre {{ Babel }} (una alternativa).
{{#categorytree:category|...}} Enumere las páginas de una categoría, de forma recursiva.
{{#coordinates:arg1|arg2|...}} Guarde las coordenadas de 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 Cadena .
{{#language:code1|code2}} Imprima el nombre representado por el código de idioma, p. Ej. En → Inglés . Imprimir en el idioma 2 si se proporciona, por ejemplo, {{#language:en|zh}}impresiones 英语
{{#lst:}} {{#lsth:}} {{#lstx:}} Tres formas de transcluir una sección de una página .
{{#property:arg1|arg2|...}} Incluya una propiedad ( Wikidata ) de una entidad con nombre, en lugar de la predeterminada en la página.
{{#related:...}} Vínculos 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íe un mensaje a una lista de páginas de discusión en el nombre de página completo, 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

Ver también

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