Ayuda:Palabras mágicas
From Open Energy Information
Las palabras mágicas son cadenas de texto que MediaWiki asocia con un retorno de valor o función, tales como la hora, los detalles del sitio o los nombres de páginas. Esta página trata el uso de palabras mágicas estándar. Si desea consultar una referencia técnica, vea el artículo Manual:Magic words.
Existen tres tipos generales de palabras mágicas:
- Interruptores de conducta: palabras escritas en mayúsculas y encerradas por guiones bajos, p.ej __FOO__
- Variables: palabras escritas en mayúsculas y encerradas entre dos pares de llaves, P.ej. <tt>{{FOO}}</tt>. >. Las variables son similares a las plantillas.
- Funciones del corrector sintáctico: consideran parámetros tanto de la forma <tt>{{foo:...}}</tt> o <tt>{{#foo:...}}</tt>. Para mayor información consulte el artículo Help:Extension:ParserFunctions.
Las palabras mágicas que dependen de páginas afectarán o brindarán datos acerca de la página actual, incluso si la palabra se añade por medio de un reemplazo de plantilla o si se incluye en el mensaje de sistema.
Contents |
Interruptores de conducta
Un interruptor de conducta lleva un control del diseño de la página y se puede utilizar a menudo para especificar omisiones e inclusiones deseadas en el contenido.
| Palabra | Descripción | Versiones |
|---|---|---|
| Tabla de contenidos | ||
| __NOTOC__ | Oculta la tabla de contenidos (TOC). | |
| __FORCETOC__ | Hace que la tabla de contenidos aparezca en su posición normal (sobre el primer encabezado) | |
| __TOC__ | Coloca una tabla de contenidos en la posición actual de la palabra (anulando __NOTOC__). Si es utilizada varias veces, la tabla de contenidos aparecerá en la posición de la primera palabra | |
| Edición | ||
| __NOEDITSECTION__ | Oculta los vínculos de la sección de edición que se encuentran a un lado de los encabezados | |
| __NEWSECTIONLINK__ | Agrega un vínculo ("+" predeterminado) a un lado de la pestaña “edición” que permite añadir una nueva sección en una página non-talk (véase Adding a section to the end). | 1.7+ |
| __NONEWSECTIONLINK__ | Quita el vínculo que se encuentra al lado de la pestaña “edición” en páginas que se encuentran en una discusión de espacios de nombre. | 1.15+ |
| Categorías | ||
| __NOGALLERY__ | Se utiliza en una página de categoría y reemplaza las vistas en miniatura en la interfaz de categoría con vínculos normales | 1.7+ |
| __HIDDENCAT__ | Se utiliza en una página de categoría y su función es ocultar la categoría dentro de los elementos de las listas de categorías y de las categorías matrices (existe una opción en la sección preferencias de usuario para mostrar la categorías. | 1.13+ |
| Conversión de Lenguaje | ||
| __NOCONTENTCONVERT__ __NOCC__ |
OCuando se trata con variantes lingüísticas en páginas wiki, es recomendable realizar ninguna conversión de lenguaje de contenido (caracteres y sincronización) en la visualización de un artículo. Por ejemplo, se sugiere utilizar chino (zh) en desmedro de variantes como zh_cn, zh_tw, zh_sg, or zh_hk. | |
| __NOTITLECONVERT__ __NOTC__ |
Cuando se trata con variantes lingüísticas en páginas wiki, no es recomendable realizar una conversión de lenguaje en el título (el contenido restante será convertido). | |
| Otros | ||
| __START__ | No tiene efecto. | |
| __END__ | Indica explícitamente el término de un artículo con el fin de impedir que WikiMedia retire espacio en blanco que no haya sido utilizado Retirado 19213. | |
| __INDEX__ | Le dice a los motores de búsqueda que proceda a indexar la página (anula $wgArticleRobotPolicies, pero no robots.txt). | 1.14+ |
| __NOINDEX__ | Le indica a los motores de búsqueda que no indexe la página (es decir, que no coloque la página entre los resultados de búsqueda) | 1.14+ |
| __STATICREDIRECT__ | Con respecto a las páginas de redirección no permita que MediaWiki actualice automáticamente el vínculo cuando alguien cambie de lugar una página y la revise. “Actualice cualquier redirección que se refiera al título original” | 1.13+ |
Variables
Las variables retornan información acerca de la página actual, página wiki o de la fecha y su sintaxis es similar a la de las plantillas. El software se encarga de rastrear las variables marcadas como "[costosas]" y el número de variables que se pueden incluir en una página es limitado.
Si el nombre de una plantilla entra en conflicto con una variable, la variable será utilizada (es decir, para reemplazar la plantilla Template:PAGENAME será necesario escribir {{Template:PAGENAME}}). En algunos casos la suma de parámetros forzará al corrector sintáctico a tratar a una variable como una plantilla. Por ejemplo, {{CURRENTDAYNAME|x}} transcluirá Template:CURRENTDAYNAME.
| Tip for wiki admins: Es posible configurar el número de funciones costosas del corrector sintáctico permitidas en una página utilizando las opciones de configuración de $wgExpensiveParserFunctionLimit. |
Fecha y hora
Las variables que se muestran a continuación brindan la fecha y hora actual de acuerdo a las preferencias de zona horaria del usuario, definiendo el Código de tiempo Universal (UTC) como la zona horaria predeterminada.
Debido al caché de archivos del buscador y de MediaWiki, estas variables aparecen con frecuencia cuando la página se almacena en vez de definir la hora actual..
| Variable | Salida | Descripción | Versiones |
|---|---|---|---|
| Year | |||
| {{CURRENTYEAR}} | 2013 | Año | |
| Mes | |||
| {{CURRENTMONTH}} | 05 | Mes (número con cero) | |
| {{CURRENTMONTHNAME}} | May | Mes (nombre) | |
| {{CURRENTMONTHNAMEGEN}} | May | Mes(forma genitiva) | |
| {{CURRENTMONTHABBREV}} | May | Mes (abreviación) | 1.5+ |
| Día | |||
| {{CURRENTDAY}} | 22 | Día del mes (número sin respaldo) | |
| {{CURRENTDAY2}} | 22 | Día del mes (número con respaldo igual a cero) | 1.6+ |
| {{CURRENTDOW}} | 3 | Día de la semana (número sin respaldo) | |
| {{CURRENTDAYNAME}} | Wednesday | Día de la semana (nombre) | |
| Hora | |||
| {{CURRENTTIME}} | 20:28 | Hora del día (formato HH:mm de 24 horas) | |
| {{CURRENTHOUR}} | 20 | Hora (número con respaldo igual a cero de 24 horas) | |
| Otros | |||
| {{CURRENTWEEK}} | 21 | Semana (número) | |
| {{CURRENTTIMESTAMP}} | 20130522202810 | Sello de hora con formato AAAAMMDDHHmmss | 1.7+ |
Las siguientes variables funcionan de la misma forma que las anteriores, pero utilizando la zona horaria local pertinente al sitio en desmedro de las preferencias del usuario y del UTC:
- {{LOCALYEAR}}
- {{LOCALMONTH}}
- {{LOCALMONTHNAME}}
- {{LOCALMONTHNAMEGEN}}
- {{LOCALMONTHABBREV}}
- {{LOCALDAY}}
- {{LOCALDAY2}}
- {{LOCALDOW}}
- {{LOCALDAYNAME}}
- {{LOCALTIME}}
- {{LOCALHOUR}}
- {{LOCALWEEK}}
- {{LOCALTIMESTAMP}}
- Si se desea un formato de tiempo más riguroso, se puede instalar la Extension:ParserFunctions y utilizar la #time: parser function
Metadatos técnicos
Las variables de revisión proporcionan datos acerca de las últimas ediciones realizadas a la página actual, incluso si se está visitando una versión más antigua de la página.
| Variable | Salida | Descripción | Versiones |
|---|---|---|---|
| Sitio | |||
| {{SITENAME}} | Open Energy Information | El nombre del sitio wiki ($wgSitename). | |
| {{SERVER}} | http://en.openei.org | URL del dominio ($wgServer) | |
| {{SERVERNAME}} | en.openei.org | Nombre de dominio ($wgServerName) | |
| {{DIRMARK}} {{DIRECTIONMARK}} |
|
OEntrega una marca direccional Unicode que se ajusta a la dirección del lenguaje wiki predeterminado (‎ en wikis de izquierda a derecha, ‏ en wikis de derecha a izquierda), sumamente útil en textos con escrituras multidireccionales.
|
1.7+ |
| {{SCRIPTPATH}} | /w | Ubicación relativa de script ($wgScriptPath) | |
| {{CURRENTVERSION}} | 1.20.2 | La versión MediaWiki de la página wiki | 1.7+ |
| {{CONTENTLANGUAGE}} {{CONTENTLANG}} |
en en |
Lenguaje de interfaz determinado de la página wiki ($wgLanguageCode) | 1.7+ |
| Últimas revisiones de la página actual | |||
| {{REVISIONID}} | 330067 | ID única de la revisión | 1.5+ |
| {{REVISIONDAY}} | 24 | Día que se realizó la edición (número sin cero a la izq.) | 1.8+ |
| {{REVISIONDAY2}} | 24 | Día que se realizó la edición (número con cero a la izq.) | 1.8+ |
| {{REVISIONMONTH}} | 01 | Mes en que se realizó la edición (número sin cero a la izq.) | 1.8+ |
| {{REVISIONYEAR}} | 2011 | Año que se realizó la edición | 1.8+ |
| {{REVISIONTIMESTAMP}} | 20110124090721 | Sello de tiempo que indica el momento de la edición | 1.8+ |
| {{REVISIONUSER}} | Tfendez | El nombre de usuario de la persona que realizó la edición más reciente de la página | 1.15+ |
| {{PAGESIZE:page name}} | 31,274 | [expensive] Brinda el tamaño (en bytes) de la página especificada | 1.13+ |
| {{PROTECTIONLEVEL:action}} | Nivel de Protección | Entrega el nivel de protección (p.ej., “autoconfirmar”, “sysop”) para una acción dada (p. ej., "editar", "mover") en la página actual o en una cadena vacía si no se cuenta con protección. | 1.15+ |
| Acciones que afectan el contenido de la página | |||
| {{DISPLAYTITLE:title}} | Otorga un formato al encabezado del título de la página. El valor debe ser equivalente al título predeterminado: solamente cambios en el uso de mayúsculas y reemplazar espacios por guiones bajos. Se puede activar o desactivar por medio del vínculo $wgAllowDisplayTitle. Esta opción se encuentra desactivada en las versiones anteriores a 1.10+ y activado en las versiones posteriores. | 1.7+ | |
| {{DEFAULTSORT:sortkey}} {{DEFAULTSORTKEY:sortkey}} {{DEFAULTCATEGORYSORT:sortkey}} |
Se utilizan para categorizar las páginas al definir una clave de ordenamiento de categorías. Por ejemplo, si usted coloca {{DEFAULTSORT:Smith, John}} al final de John Smith, la página será indexada bajo la letra "S" en las categorías predeterminadas. | 1.10+ | |
Estadísticas
Normalmente los números resultantes de estas variables contienen separadores (comas o espacios, dependiendo del lenguaje local), pero que pueden brindar números brutos con el indicador ":R" (p.ej., {{NUMBEROFPAGES}} → 156,682 and {{NUMBEROFPAGES:R}} → 156682). Use ":R" para las palabras mágicas que requieran de un parámetro como PAGESINCATEGORY (p.ej., {{PAGESINCATEGORY:Help}} y {{PAGESINCATEGORY:Help|R}}).
| Variable | Saida | Descripción | Versiones |
|---|---|---|---|
| Toda la wiki | |||
| {{NUMBEROFPAGES}} | 156,682 | Número de páginas wiki | 1.7+ |
| {{NUMBEROFARTICLES}} | 59,254 | Número de páginas en el espacio de nombre principal y que no cuenta con página principal | |
| {{NUMBEROFFILES}} | 7,794 | Número de archivos existentes | 1.5+ |
| {{NUMBEROFEDITS}} | 639,912 | Número de ediciones de página | 1.10+ |
| {{NUMBEROFVIEWS}} | Número de visitas a la página. Una cualidad comúnmente inútil en una página wiki con almacenamiento de memoria | 1.14+ | |
| {{NUMBEROFUSERS}} | 5,654 | Número de usuarios registrados | 1.7+ |
| {{NUMBEROFADMINS}} | 23 | Número de usuarios en el grupo sysop | 1.7+ |
| {{NUMBEROFACTIVEUSERS}} | 91 | Número de usuarios activos según el criterio utilizado en Especial:Estatisticas | 1.15+ |
| {{PAGESINCATEGORY:categoryname}} {{PAGESINCAT:Help}} |
68 68 |
[expensive] Número de páginas en una categoría dada (reemplace “Ayuda” con el nombre de la categoría pertinente) | 1.13+ |
| {{NUMBERINGROUP:groupname}} {{NUMINGROUP:groupname}} |
11 11 ({{NUMBERINGROUP:bureaucrat}} used here) |
Número de usuarios en un grupo específico | 1.14+ |
| {{PAGESINNS:index}} {{PAGESINNAMESPACE:index}} |
not enabled | Número de páginas en el espacio de nombre dado (reemplace 2 con el índice de espacio de nombre). Por ejemplo, {{PAGESINNAMESPACE:14}} es igual al número de categorías. Se encuentra predeterminadamente desactivado pero se puede activar con $wgAllowSlowParserFunctions. | 1.7+ |
Nombres de página
| Variable | Salida | Descripción | Versiones |
|---|---|---|---|
| {{FULLPAGENAME}} | Ayuda:Palabras mágicas | Nombre de espacio y título de la página | 1.6+ |
| {{PAGENAME}} | Ayuda:Palabras mágicas | Título de la página | |
| {{BASEPAGENAME}} | Ayuda:Palabras mágicas | Título de la página que excluye la subpágina actual y el espacio de nombre /”Título/foo” en “Título/foo/bar. | 1.7+ |
| {{SUBPAGENAME}} | Ayuda:Palabras mágicas | El título de la subpágina (“foo” en “Título/foo") | 1.6+ |
| {{SUBJECTPAGENAME}} | Ayuda:Palabras mágicas | El espacio del nombre y título del contenido asociado a la página | 1.7+ |
| {{TALKPAGENAME}} | Talk:Ayuda:Palabras mágicas | El espacio del nombre y título de la página de diálogo asociada | 1.7+ |
Las palabras mágicas {{BASEPAGENAME}} y {{SUBPAGENAME}} solo funcionan en nombres de espacio que tengan las subpáginas activadas. Para mayor información sobre la activación de subpáginas consulte Manual:$wgNamespacesWithSubpages
La lista siguiente son equivalentes URL:
- {{FULLPAGENAMEE}}
- {{PAGENAMEE}}
- {{BASEPAGENAMEE}}
- {{SUBPAGENAMEE}}
- {{SUBJECTPAGENAMEE}}
- {{TALKPAGENAMEE}}
Al igual que con la versión 1.15+, todas las anteriores pueden considerar un parámetro, permitiendo una especificación de la página donde operarán en desmedro de la página actual:
- {{PAGENAME:Template:Main Page}} → Main Page
Espacios de nombre
| Variable | Salida | Descripción | Versiones |
|---|---|---|---|
| {{NAMESPACE}} | Espacio de nombre (nombre) | ||
| {{SUBJECTSPACE}} {{ARTICLESPACE}} |
|
Nombre del contenido asociado al espacio de nombre | 1.7+ |
| {{TALKSPACE}} | Talk | Nombre del diálogo de espacio de nombre asociado | 1.7+ |
Los elementos que se indican a continuación constituyen equivalentes URL:
- {{NAMESPACEE}}
- {{SUBJECTSPACEE}}
- {{TALKSPACEE}}
Al igual que la versión 1.15+, todas las anteriores pueden considerar un parámetro, especificando el retorno de la propiedad junto con un título dado en desmedro de la página actual:
- {{NAMESPACE:Template:Main Page}} → Template
Funciones del corrector sintáctico
Las funciones del corrector sintáctico son muy similares a las variables, no obstante pueden abarcar uno o más parámetros (técnicamente, se considera una función de corrector sintáctico a cualquier palabra mágica que considere un parámetro), y en ciertos casos se antepone un signo de número al nombre con el fin de diferenciarlo de las plantillas.
La página describe solamente las funciones del corrector sintáctico que son integrales para el software MediaWiki. Se pueden agregar otras funciones de corrector a través de las extensiones, tales como la Extensión de funciones de corrector sintáctico. Para acceder a ellas consulte
Help:Extension:ParserFunctions.
Datos URL
| Función del corrector | Entrada → Salida | Descripción | Versiones |
|---|---|---|---|
| {{localurl:page name}} {{localurl:page name|query string}} |
{{localurl:MediaWiki}} → /wiki/MediaWiki {{localurl:MediaWiki|printable=yes}} → /w/index.php?title=MediaWiki&printable=yes |
La ruta relativa para el título | |
| {{fullurl:page name}} {{fullurl:page name|query_string}} {{fullurl:interwiki:remote page name|query_string}} |
{{fullurl:Category:Top level}} → http://en.openei.org/wiki/Category:Top_level {{fullurl:Category:Top level|action=edit}} → http://en.openei.org/w/index.php?title=Category:Top_level&action=edit |
La ruta definitiva que dirige al título y que también determina los prefijos Interwiki. | 1.5+ |
| {{filepath:file name}} {{filepath:file name|nowiki}} |
{{filepath:Wiki.png}} → {{filepath:Wiki.png|nowiki}} → |
La URL para un archivo de medio | 1.12+ |
| {{urlencode:string}} | {{urlencode:x y z á é}} → x+y+z+%C3%A1+%C3%A9 | La entrada codificada para trabajar con URLs | 1.7+ |
| {{anchorencode:string}} | {{anchorencode:x y z á é}} → x_y_z_.C3.A1_.C3.A9 | La entrada codificada para trabajar con el anclajes de sección URL (después del símbolo “#” en una URL) | 1.8+ |
Espacios de nombres
La Variable {{ns:}} brinda el nombre localizado para el espacio de nombre con ese índice. Por otro lado, {{nse:}} constituye el equivalente codificado en URL. Tiene el mismo efecto; sin embargo, este reemplaza los espacios con guiones bajos con el fin de ser compatible con vínculos externos.
| Espacios de nombre de contenido | Espacios de nombre de diálogos | |||
|---|---|---|---|---|
| Uso | Salida | Uso | Salida | |
| {{ns:-2}} o {{ns:Media}} | Media | {{ns:-1}} o {{ns:Special}} | Special | |
| {{ns:0}} | {{ns:1}} o {{ns:Talk}} | Talk | ||
| {{ns:2}} o {{ns:User}} | User | {{ns:3}} o {{ns:User talk}} | User talk | |
| {{ns:4}} o {{ns:Project}} | OpenEI | {{ns:5}} o {{ns:Project talk}} | OpenEI talk | |
| {{ns:6}} o {{ns:File}} or {{ns:Image}} | File | {{ns:7}} o {{ns:File talk}} or {{ns:Image talk}} | File talk | |
| {{ns:8}} o {{ns:MediaWiki}} | MediaWiki | {{ns:9}} o {{ns:MediaWiki talk}} | MediaWiki talk | |
| {{ns:10}} o {{ns:Template}} | Template | {{ns:11}} o {{ns:Template talk}} | Template talk | |
| {{ns:12}} o {{ns:Help}} | Help | {{ns:13}} o {{ns:Help talk}} | Help talk | |
| {{ns:14}} o {{ns:Category}} | Category | {{ns:15}} o {{ns:Category talk}} | Category talk | |
Diseño de Formato
| Usage | Input → Output | Description | Version |
|---|---|---|---|
| {{lc:string}} | {{lc:DATA CENTER}} → data center | Entrada de minúsculas | 1.5+ |
| {{lcfirst:string}} | {{lcfirst:DATA CENTER}} → dATA CENTER | La entrada con el primer carácter en minúscula | 1.5+ |
| {{uc:string}} | {{uc:text transform}} → TEXT TRANSFORM | La entrada de mayúsculas | 1.5+ |
| {{ucfirst:string}} | {{ucfirst:text transform}} → Text transform | La entrada con el primer carácter en mayúscula | 1.5+ |
| {{formatnum:unformatted num}} {{formatnum:formatted num|R}} |
{{formatnum:-987654321.654321}} → -987,654,321.654321 {{formatnum:-987,654,321.654321|R}} → -987654321.654321 |
La entrada con separadores decimales, de grupo decimal y de escritura de dígitos localizada según la configuración local de la página wiki. El parámetro |R se utiliza para quitar el formato a un número que participará en problemas matemáticos | 1.7+ 1.13+ |
|
|
{{#dateformat:11 seP 2001|ymd}} Note: In the example above, "your pref" refers to your date preference on the current MediaWiki wiki only. |
Da formato a una fecha no relacionada basándose en el “formato de fecha” del usuario y además añade metadatos al etiquetarla como “fecha con formato”. En el caso de usuarios no conectados o que no han escogido un formato de fecha entre sus preferencias, la fecha aparecerá con el formato preestablecido por la norma ISO 8601: mda, dma, amd (todas estas sensibles al uso de mayúsculas y minúsculas). Si es que no se especifica un formato o este resulta inválido, se aplicará un formato de entrada predeterminado. Si no se reconoce como válida la fecha ingresada, entonces se procederá a considerarla obsoleta y por lo tanto se suspenderá la creación de metadatos.
Aviso: Aunque la norma ISO 8601 requiere que las fechas se rijan bajo el calendario gregoriano, los parámetros de esta función darán formato a las fechas que no se encuentren dentro del rango del calendario gregoriano (p.ej., fechas anteriores a 1583). Por otro lado, la palabra mágica no puede convertir correctamente entre años negativos (utilizados con la norma ISO 8601) y años a. de C. o años previos a nuestra era (utilizados en la escritura general) |
1.15+ |
| {{padleft:xyz|stringlength}} {{padleft:xyz|strlen|char}} |
{{padleft:xyz|5}} → 00xyz {{padleft:xyz|5|_}} → __xyz |
Ingresa una cadena de caracteres de relleno (escogidos en un tercer parámetro; “0” como predeterminado) de una longitud específica (segundo parámetro) y conjunta a una base de caracteres o variable (primer parámetro). Los últimos dígitos o caracteres en la base reemplazarán a los últimos caracteres en el relleno; es decir, 044 produce 044. | 1.8+ |
| {{padright:xyz|stringlength}} {{padright:xyz|strlen|char}} |
{{padright:xyz|5}} → xyz00 {{padright:xyz|5|_}} → xyz__ |
Similar al método padleft, pero añade caracteres de relleno al lado derecho | |
| {{plural:2|is|are}} | {{plural:1|is|are}} → is {{plural:2|is|are}} → are |
Proporciona la forma de pluralización correcta (parámetros a excepción del primero) dependiendo de la cantidad (primer parámetro). Las transformaciones plurales se utilizan con lenguajes como el ruso que se basan en el "contador MOD 10" | |
| {{grammar:N|noun}} | Salidas
Brinda la forma modulada correcta de la palabra dada y descrita por el código de inflexión después de los dos puntos (dependiente del lenguaje). Las transformaciones gramaticales se utilizan en lenguas moduladas como el polaco. |
1.7+ |
Misceláneo
| Uso | Salida | Descripción | Versión |
|---|---|---|---|
| {{int:message name}} | <tt>{{int:edit}} → Edit (depends on user language, try: fr •ja) |
Internacionaliza (traduce) el mensaje interfaz dada (espacio de nombre MediaWiki) a la lengua del usuario. | |
| {{#language:language code}} {{#language:ar}} {{#language:th}} |
language code العربية ไทย |
El nombre nativo para el código de idioma dado según la norma ISO 639. | 1.7+ |
| {{#special:special page name}} {{#special:userlogin}} |
No such special page Special:UserLogin |
El nombre localizado del Especial autorizado dado: página | 1.9+ |
| {{#tag:tagname}} {{#tag:tagname |tag content |parameter=value |parameter2=value }} |
(depends on parser tag) | Nombre artificial para el corrector sintáctico tipo XML o de las pestañas de extensión, pero que analizan el código wiki. Los valores de atributo son considerados como valores de parámetro('<tagname attribute="value">' → '{{#tag:tagname|attribute=value}}'), al contenido interno como parámetro no definido ('<tagname>content</tagname>' → '{{#tag:tagname|content}}').
Aviso : ' |
1.12+ |
| {{gender:username |return text if user is male |return text if user is female |return text if user hasn't defined their gender}} |
(depends on the named user's gender) | Un interruptor para el género establecido en el apartado Special:Preferences | 1.15+ |
| {{groupconvert:groupname}} | (only works on wikis with language variants) | Permite activar normas de conversión de grupos definidos en [[MediaWiki:Groupconversiontable-groupname/variantcode]]. | 1.15+ |