El profesor Crayón se ha percatado de que la mayor parte de los artículos sobre obras pictóricas que ha consultado hasta ahora tienen una breve ficha al comienzo donde aparece una captura del cuadro y los datos básicos del mismo.
Crayón quiere incorporar una ficha parecida a su artículo sobre La fábula de Aracné, por lo que su primer paso ha sido entrar en el modo de edición de uno de estos artículos para copiar el código y modificarlo después. Al hacerlo, ha descubierto que tienen un formato especial de código wiki que no había visto hasta ahora: las plantillas.
En esta lección se explicarán los conceptos y herramientas necesarios acerca de las plantillas de contenido de forma que el profesor Crayón sea capaz de:
1) Insertar plantillas
Las plantillas son pequeños códigos que, al ser incluidos en un artículo, muestran automáticamente un contenido previamente definido.
Su cometido es agilizar el trabajo de edición evitando copiar todo el código cada vez que queremos poner una misma cosa, y también homogeneizar los artículos que comparten las mismas características.
Al tener el contenido en una plantilla, si hace falta modificarlo basta con editar la plantilla y el cambio se mostrará automáticamente en todas las páginas que la incluyen.
Sus aplicaciones son muy diversas, pero entre ellas destacan:
- Fichas de datos, para dar homogeneidad a artículos de características determinadas que comparten siempre los mismos tipos de datos como libros, países, elementos químicos, datos biográficos, etc.
- Menús de navegación específicos para enlazar ciertos grupos de artículos, como por ejemplo los antecesores y sucesores de un cargo político.
Si deseamos insertar una plantilla, simplemente escribiremos el nombre de la misma entre llaves dobles.
{{Nombre de la plantilla}}
Este es el método de uso más habitual, y se le denomina transclusión. Cuando alguien edite la plantilla, el contenido que se muestra en la página donde ha sido insertada también se verá modificado.
Existe otra forma de utilizar las plantillas llamada sustitución. Con este método, cuando pulsemos el botón “Grabar la página”, en lugar del código que hemos insertado lo que se grabará en su lugar es el contenido de la plantilla.
Esto hace posible editar el contenido en el propio artículo de forma independiente, sin afectar a la plantilla o a otras páginas que la contengan. Del mismo modo, si en el futuro la plantilla cambia, el artículo no se verá afectado. Para usar una plantilla con el método de sustitución, escribiremos:
{{subst:Nombre de la plantilla}}
Si nos equivocamos al teclear el nombre de la plantilla, con cualquiera de los dos métodos, en lugar del código de la misma aparecerá el texto “Plantilla:Nombre de la plantilla” en rojo, indicando que la plantilla no existe.
Plantilla:Nombre de la plantilla
2) Insertar plantillas con parámetros
En el apartado anterior hemos visto para qué sirven y cómo funcionan las plantillas con ejemplos muy sencillos que siempre muestran el mismo contenido, por lo que basta insertar el nombre para hacerlas funcionar.
Sin embargo, la mayoría de las plantillas utilizan parámetros personalizables, que permiten que el contenido de la misma varíe en función de los valores que asignemos a esos parámetros.
Usarlos es muy sencillo. Si los parámetros no tienen nombre, basta con añadir una pleca (|) al nombre de la plantilla y escribir a continuación el valor que queremos mostrar:
{{Nombre de la plantilla|valor1|valor2}}
Si los parámetros tienen nombre, entonces debemos añadir los valores de esta otra forma:
{{Nombre de la plantilla|parámetro1=valor1|parámetro2=valor2}}
Las plantillas no tienen limitación en cuanto a número de parámetros que pueden mostrar, y tampoco afecta a la visualización del contenido si introducimos saltos de línea a la hora de escribir los valores, siempre que dejemos uno por línea.
Estas dos cualidades hacen de las plantillas un recurso idóneo para elaborar fichas, ya que pueden mostrarse en el siguiente formato:
{{Nombre de la plantilla
|parámetro1 =
|parámetro2 =
|parámetro3 =
}}
Otra característica de las plantillas es que admiten la utilización de código wiki, haciendo posible la inserción de elementos de formato (negritas, cursivas…), enlaces, imágenes, etc.
3) Crear una plantilla
Las plantillas se crean de la misma forma que cualquier otra página del wiki. La única diferencia con los artículos es que el título debe comenzar con el espacio de nombres “Plantilla”.
Así, tenemos varias opciones para crearla. A través de enlace, si escribimos:
[[Plantilla:Nombre de plantilla]]
o bien
{{Nombre de plantilla}}
se generará un enlace en rojo, al no encontrar ninguna página con el nombre especificado. Si lo seguimos, podremos editar directamente la plantilla. También podemos hacerlo a través de buscador, tal y como vimos en la lección “Crear una página”.
Una vez en el modo edición, para definir parámetros todo lo que debemos hacer es encerrar el parámetro en cuestión entre triples llaves.
| Descripción | Código wiki |
|---|---|
| Parámetro sin nombre (el número representa el orden en que debe insertarse en la plantilla) | {{{1}}} |
| Parámetro con nombre | {{{parámetro}}} |
| Parámetro con valor por defecto | {{{parámetro|valor}}} |
A la hora de crear plantillas, funcionan muy bien las llamadas “palabras mágicas” de MediaWiki. Se trata de unos pequeños códigos que ocultan o muestran determinados elementos relacionados con la página que estamos editando.
Pueden usarse tanto en los artículos como en las plantillas, pero muchas resultan de mayor utilidad en estas últimas:
| Descripción | Código wiki |
|---|---|
| Tabla de contenidos | |
| Oculta la tabla de contenidos | __NOTOC__ |
| Fuerza la aparición de la tabla de contenidos sobre el primer título del artículo. | __FORCETOC__ |
| Fuerza la aparición de la tabla de contenidos en el punto del artículo donde escribamos el código. | __TOC__ |
| Edición | |
| Oculta el link de edición de una sección. | __NOEDITSECTION__ |
| Añade un link junto a la pestaña “editar” que permite añadir una nueva sección al final de la página. | __NEWSSECTIONLINK__ |
| Elimina el link que permite añadir una nueva sección al final de la página (aparece por defecto en las páginas de Discusión) | __NONEWSECTIONLINK__ |
| Fecha y hora | |
| Año en curso (p.ej. 2011) | {{CURRENTYEAR}} |
| Mes en curso | {{CURRENTMONTH}} {{CURRENTMONTHNAME}} {{CURRENTMONTHABBREV}} |
| Día en curso | {{CURENTDAY}} {{CURRENTDAY2}} {{CURRENTDOW}} {{CURRENTDAYNAME}} |
| Hora | {{CURRENTTIME}} {{CURRENTHOUR}} |
| Número de semana dentro del año. | {{CURRENTWEEK}} |
| Marca de fecha y hora completa, sin espacios entre las partes (equivalente a usar las variables de año, mes, día y hora) | {{CURRENTTIMESTAMP}} |
| Ruta de páginas | |
| Nombre de la página. | {{FULLPAGENAME}} |
| Namespace de la ruta de la página | {{NAMESPACE}} |
| Ruta completa de la página, sin incluir el espacio de nombres. | {{PAGENAME}} |
| Igual que {{PAGENAME}}, pero sin la última subpágina | {{BASEPAGENAME}} |
| Última subpágina de la ruta de la página. | {{SUBPAGENAME}} |
| (Si se está en página de discusión, devuelve la ruta de la página principal) | {{SUBJECTPAGENAME}} |
| Ruta completa de la página de discusión asociada. | {{TALKPAGENAME}} |
| Nombre del namespace de la página de discusión asociada a la página. | {{TALKSPACE}} |
Aquí se indican tan solo las palabras mágicas de uso más común, para ver el listado completo consultar la página de ayuda de MediaWiki.org donde se explican detalladamente las Palabras Mágicas disponibles.
Además, existen dos etiquetas que permiten hacer excepciones dentro del contenido de la plantilla para indicar:
- Contenido que no debe incluirse en las páginas que utilicen la plantilla (pero sí en la página de descripción de la misma). Se define encerrando el código entre etiquetas <noinclude> y </noinclude>
- Contenido que solamente debe incluirse en las páginas que utilicen la plantilla (y no en la página de descripción de la misma). Se define encerrando el código entre etiquetas <includeonly> e </includeonly>