Ayuda:Palabras Mágicas
De Wikibello
Las magic words, –palabras mágicas–, son strings –cadenas de texto– que Wiki 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.
Hay tres clases generales de magic words:
- Modificadores de comportamiento: 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: {{FOO}}).
- Funciones del analizador sintáctico (Parser Functions): pueden llevar parámetros, y son del tipo {{foo:...}} o {{#foo:...}}.
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.
Contenido |
[editar] Modificadores de Comportamiento
Un 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.
| Magic words | Descripción |
|---|---|
| Tabla de contenidos | |
| __NOTOC__ | Oculta la tabla de contenidos –table of contents– (TOC). |
| __FORCETOC__ | Fuerza a la tabla de contenidos, a aparecer en su posición normal –sobre el primer encabezado del artículo–. |
| __TOC__ | Coloca la tabla de contenidos, en el lugar donde se ha puesto la palabra mágica. Si aparece más de una vez esta palabra mágica, la tabla de contenidos se pondrá donde aparezca la primera de ellas. |
| Edición | |
| __NOEDITSECTION__ | Oculta el link de edición de cada sección individual. |
| _._NOTITLE__ | Oculta el título de la página. |
| __NEWSECTIONLINK__ | Añade un link ("+" por defecto) al lado de la pestaña "editar", que permitirá añadir una nueva sección, en esa página –como se hace en las páginas de discusión&ndash. |
| __NONEWSECTIONLINK__ | Elimina la pestaña para "añadir nueva sección" ("+" por defecto), que hay al lado de la pestaña "editar" en las páginas de discusión. |
| Categorías | |
| __NOGALLERY__ | Usada en las páginas de las categorías. Reemplaza la vista en miniatura –thumbnails–, por la vista tradicional de links, por orden alfabético. |
| __HIDDENCAT__ | Se usa en las páginas de las categorías para ocultar la misma categoría de las listas de categorías, y en las páginas que la usan. A pesar de su uso, hay una opción en preferencias de usuario que permite mostrar las categorías ocultas. |
| Otros | |
| __START__ | Sin efecto. |
| __END__ | Indica cuál es el final del artículo; se usa con objeto de evitar que Wiki elimine espacios en blanco o saltos de línea del final del artículo. |
| __INDEX__ | Le indica a los motores de búsqueda, que indexen la página. |
| __NOINDEX__ | Le indica a los motores de búsqueda, que no indexen la página que usa la magic word, es decir, que la página no aparecerá en los resultados de búsqueda de los diferentes buscadores. |
| __STATICREDIRECT__ | En las páginas de redirección, evita que MediaWiki actualice automáticamente el link de redirección, cuando alguien mueve la página, o usa "Actualizar cualquier redirección que apunte al título original". |
[editar] 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.
[editar] 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.
| Variable | Muestra | Descripción |
|---|---|---|
| Año | ||
| {{CURRENTYEAR}} | 2010 | Año |
| Mes | ||
| {{CURRENTMONTH}} | 09 | Mes –comenzando por cero, si es menor de diez–. |
| {{CURRENTMONTHNAME}} | septiembre | Nombre del mes, en el idioma de la wiki local. |
| {{CURRENTMONTHABBREV}} | sep | Abreviatura del mes, en el idioma de la wiki local. |
| Día | ||
| {{CURRENTDAY}} | 4 | Día del mes, –sin comenzar por cero–. |
| {{CURRENTDAY2}} | 04 | Día del mes, –comenzando por cero, si es menor de diez–. |
| {{CURRENTDOW}} | 6 | Número del día de la semana –siendo el lunes, el día 1–. |
| {{CURRENTDAYNAME}} | sábado | Nombre del día, en el idioma de la wiki local. |
| Hora | ||
| {{CURRENTTIME}} | 19:41 | Hora y minutos, –formato: 24-horas, HH:mm–. |
| {{CURRENTHOUR}} | 19 | Hora, –en formato 24-horas, y comenzando por cero si es menor de diez–. |
| Otros | ||
| {{CURRENTWEEK}} | 35 | Número de semana, dentro del año |
| {{CURRENTTIMESTAMP}} | 20100904194132 | Marca de fecha y hora completa, sin espacios entre las partes. Equivalente a usar: {{CURRENTYEAR}}{{CURRENTMONTH}}{{CURRENTDAY2}}{{CURRENTHOUR}}{{#time:i}}{{#time:s}} |
[editar] 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.
| Variable | Muestra | Descripción |
|---|---|---|
| Del sitio | ||
| {{SITENAME}} | Wikibello | El nombre de la wiki local ($wgSitename). |
| {{SERVER}} | http://www.wikibello.cl | La URL del dominio de la wiki local ($wgServer) |
| {{SERVERNAME}} | www.wikibello.cl | El nombre del dominio ($wgServerName) |
| {{CURRENTVERSION}} | 1.15.1 | La versión del software MediaWiki, de la wiki local. |
| Ultima revisión de la página | ||
| {{REVISIONDAY}} | 6 | Día de la última revisión, –sin comenzar por cero–. |
| {{REVISIONDAY2}} | 06 | Día de la última revisión, –comenzando por cero, si es menor de diez–. |
| {{REVISIONMONTH}} | 4 | Día de la última revisión, –sin comenzar por cero–. |
| {{REVISIONYEAR}} | 2010 | Año de la última revisión |
| {{REVISIONUSER}} | Nalanqui | Nombre del usuario que hizo la última edición de la página. |
| {{PAGESIZE:<PageName>}} | 22.070 | [expensive] Devuelve el tamaño –en bytes–, de la página que se le pase como parámetro: <PageName>. |
| {{PROTECTIONLEVEL:<action>}} | Indica el nivel de protección de la página actual –'autoconfirm', 'sysop', etcétera–, según la acción indicada en el parámetro <action> –'edit', 'move', etcétera–, o devuelve una cadena vacía, si no hay definida ninguna protección específica. | |
| Afectan al contenido de la página | ||
| {{DEFAULTSORT:<sortkey>}} {{DEFAULTSORTKEY:<sortkey>}} {{DEFAULTCATEGORYSORT:<sortkey>}} | Se usa para categorizar páginas, indicando una clave de ordenación –<sortkey>–. Por ejemplo, si pones el código: {{DEFAULTSORT:Pedro}}[[Category:Categoy_example]] al final de una página, dicha página se pondrá en la letra "P" en Category:Categoy_example.
|
[editar] Estadísticas
Los números devueltos por estas variables, habitualmente contienen separadores como comas, espacios o puntos, pero se pueden formatear los números, con el modificador «:R»
- {{NUMBEROFPAGES}} → 2.223
- {{NUMBEROFPAGES:R}} → 2223)
| Variable | Muestra | Descripción |
|---|---|---|
| De todo WikiBello | ||
| {{NUMBEROFPAGES}} | 2.223 | Número de páginas en la wiki. |
| {{NUMBEROFARTICLES}} | 689 | Número de páginas en el namespace principal. |
| {{NUMBEROFFILES}} | 625 | Número de archivos subidos. |
| {{NUMBEROFEDITS}} | 14.092 | Número de ediciones. |
| {{NUMBEROFVIEWS}} | 830.509 | Número de páginas vistas. Normalmente no refleja la realidad cuando se está detrás de la caché. |
| {{NUMBEROFUSERS}} | 122 | Número de usuarios registrados. |
| {{NUMBEROFADMINS}} | 6 | Número de usuarios en el grupo sysop –administradores–. |
| {{NUMBEROFACTIVEUSERS}} | 3 | Número de usuarios activos, según el criterio en Special:Estadísticas. |
| {{PAGESINCATEGORY:<categoryname>}} {{PAGESINCAT:<categoryname>}} | 0 | [expensive] Número de páginas en la categoría que se pasa como parámetro – <categoryname>–. |
| {{NUMBERINGROUP:<groupname>}} {{NUMINGROUP:<groupname>}} | {{NUMBERINGROUP:bureaucrat}}→ →3 | Número de usuarios en el grupo que se le pasa como parámetro –<groupname>–. |
[editar] 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:
- <Namespace>:<Título_principal>/<Sub_página1>/<Sub_pagina2>...
- Pudiendo faltar el <Namespace> (en caso de usar el principal), o las <Sub_paginas>
Nota: Para todos los ejemplos, se tomará como si se estuviera en la página: Help:Title/Subtitle/Foo1/Foo2.
| Variable | Muestra | Descripción |
|---|---|---|
| {{FULLPAGENAME}} | Ayuda:Title/Subtitle/Foo1/Foo2 | Ruta completa de la página. |
| {{NAMESPACE}} | Ayuda | Namespace de la ruta de la página |
| {{PAGENAME}} | Title/Subtitle/Foo1/Foo2 | Ruta completa de la página, sin incluir el <Namespace> –espacio de nombres–. |
| {{BASEPAGENAME}} | Title/Subtitle/Foo1/Foo2 | Igual que {{PAGENAME}}, pero sin la última <Sub_pagina>. |
| {{SUBPAGENAME}} | Title/Subtitle/Foo1/Foo2 | Última <Sub_pagina> de la ruta de la página. |
| {{SUBJECTPAGENAME}} | Ayuda:Title/Subtitle/Foo1/Foo2 | Ruta completa de la página de contenidos asociada. (Si se está en página de discusión, devuelve la ruta de la página principal) |
| {{SUBJECTSPACE}} {{ARTICLESPACE}} | Ayuda | Nombre del namespace de la página de contenidos asociada a la página. (Si se está en página de discusión, devuelve en namespace de la página principal) |
| {{TALKPAGENAME}} | Ayuda Discusión:Title/Subtitle/Foo1/Foo2 | Ruta completa de la página de discusión asociada. |
| {{TALKSPACE}} | Ayuda Discusión | Nombre del namespace de la página de discusión asociada a la página. |
[editar] Parser functions
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.
[editar] URL
Estas parser functions toman como parámetro el título completo de una página –<Namespace>:<Título_principal>/<Sub_página1>/<Sub_pagina2>...–, y devuelven la URL asociada a la misma. Nota: Para todos los ejemplos que sigan, se usará de parámetro el título: Help:Title/Foo.
| Parser function | Muestra | Descripción |
|---|---|---|
| {{localurl:<PageName>}} {{localurl:<PageName>|<query_string>}} | /Ayuda:Title/Foo /index.php?title=Ayuda:Title/Foo&variables | Devuelve la ruta relativa, de la página que se pase como parámetro. Se puede especificar una query string, pasando un segundo parámetro. |
| {{fullurl:<PageName>}} {{fullurl:<PageName>|<query_string>}} {{fullurl:<prefijo>:<PageName> |<query_string>}} | http://www.wikibello.cl/Ayuda:Title/Foo http://www.wikibello.cl/index.php?title=Ayuda:Title/Foo&variables http://www.wikibello.cl/W:es:Help:Title/Foo | Como {{localurl}}, pero devuelve un hiperenlace con la URL absoluta. Igualmente se puede pasar el parámetro <query_string>. También se pueden usar prefijos-interwiki –<prefijo>–. En el anterior ejemplo, se usó: {{fullurl:w:es:Help:Title/Foo}} |
| {{filepath:<FileName>}} {{filepath:<FileName>|nowiki}} | | Devuelve la URL del archivo multimedia, de la página de descripción, cuyo título se pasa como parámetro –<FileName>–. Si se añade el parámetro «nowiki», se devolverá sólo un string con la URL, y no un hiperenlace. |
[editar] 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.
| Uso | Explicación |
|---|---|
| {{subst:<NombrePlantilla>}} | Substituye la llamada a la plantilla –{{<NombrePlantilla>}}– con el contenido de la misma. Esta "sustitución" hace que una vez que la página ha sido guardada, el contenido de la plantilla pasará a formar parte de la página con el contenido que tenía en el momento exacto del guardado.
Nota: El resultado de usar subst: en plantillas, queda indefinido, si la plantilla en cuestión, contiene otras plantillas o funciones, variables o Magic words que no han sido previamente sustituidas. Esto es: cuando se usa subst: en, por ejemplo, una plantilla que haga uso de otra plantilla, esta misma queda sin sustituir. Para evitar esto, se podría usar substall:, en lugar de subst:, cuando fuera necesaria esta sustitución recursiva. |
| {{msg:<NombrePlantilla>}} {{raw:<NombrePlantilla>}} | Si una plantilla está en conflicto con una palabra mágica, al usar el modificador msg: se utilizará la plantilla –{{<NombrePlantilla>}}– en lugar de la palabra mágica. En otro caso se usará la palabra mágica.
|
| {{msgnw:<NombrePlantilla>}} | La plantilla –{{<NombrePlantilla>}}– se pegará como una etiqueta sin evaluar al estilo <nowiki>. |
| {{int:<NombrePlantilla>}} | véase su uso una línea más abajo. |
[editar] Varios
| Parser function | Ejejmplo de uso | Descripción |
|---|---|---|
| {{int:<message name>}} | {{int:edit}} → Editar | Traduce la palabras internacionalizada –<message name>– de la interface de MediaWiki, al idioma elegido en las preferencias del usuario que visita la página. |
| {{#language:<lang_code>}} | {{#language:ar}} → العربية {{#language:th}} → ไทย {{#language:es}} → Español {{#language:en}} → English | Devuelve el nombre del idioma dado por el código ISO 639-1 de dos cifras, –<lang_code>–, en ese mismo idioma. |
| #REDIRECT [[<PageName>]] | Este código crea una redirección automática que apunta a la página <PageName>. AVISO: Debe situarse al inicio del código fuente de la página donde se desea la redirección. |
