Ayuda:Plantillas
De Wikibello
Una plantilla es un trozo de código de Wiki que puede ser reutilizado por muchas páginas distintas, sin necesidad de copiar todo el código nuevamente. Corresponden a un tipo de páginas especiales, destinadas a utilizarse dentro de otras, y que utilizan el nombre Plantilla:Nombre.
Antes de crear una plantilla, asegúrate de leer y entender esta guía, en particular la sección Sugerencias.
Contenido |
[editar] Estructura de una plantilla
El contenido de toda plantilla está distribuido de tres maneras:
[editar] Contenido de uso
Corresponde al código base de la plantilla, que la faculta para hacer algo en particular, distinto de las demás.
[editar] Contenido inclusivo: «noinclude»
Corresponde al código que no se incluirá en las páginas que utilicen la plantilla. Debe escribirse dentro de las etiquetas <noinclude> y </noinclude>, y se utiliza sobre todo para agregar categorías o documentación a la plantilla.
[editar] Contenido exclusivo: «includeonly»
Corresponde al código que sólo se incluirá en las páginas que utilicen la plantilla (y no en la plantilla propiamente tal). Debe escribirse dentro de las etiquetas <includeonly> e </includeonly>, y se utiliza sobre todo para agregar categorías a las páginas marcadas con las plantillas.
[editar] Cómo utilizar una plantilla
Supongamos que queremos utilizar una plantilla llamada Plantilla:Nombre_de_plantilla en una página cualquiera, llamada [[Página de ejemplo]]. Esto podemos hacerlo de dos maneras diferentes:
[editar] Transclusión
Se escribe {{Nombre_de_plantilla}} en [[Página de ejemplo]], con lo cual, cada vez que la página se carga, también se carga el contenido de la [[Plantilla:Nombre_de_plantilla]], reproduciéndose en la visualización de la página. De esta forma se cargan dos páginas en vez de una: [[Página de ejemplo]] y [[Plantilla:Nombre_de_plantilla]], creando una dependencia entre ambas.
La transclusión ralentiza la carga de las páginas, pero permite rastrear aquellas páginas que utilizan las plantillas (funcionalidad muy útil en ciertas ocasiones). Además, como el contenido de la plantilla utilizada no se guarda en la página que la utiliza, el código de esta última no se ensucia, haciéndose más fácil de entender, y por tanto de editar.
[editar] Sustitución
Se escribe {{subst:Nombre_de_plantilla}} en [[Página de ejemplo]], con lo cual tanto el contenido de uso como el contenido exclusivo de la plantilla se agregan permanentemente a la [[Página de ejemplo]].
La sustitución se utiliza cuando queremos que el contenido incorporado por la plantilla pueda editarse desde la página marcada, sin alterar la plantilla propiamente tal. Así, [[Plantilla:Nombre_de_plantilla]] y [[Página de ejemplo]] siguen siendo independientes, y los cambios que afecten a una, no afectarán a la otra.
[editar] Parámetros
[editar] Plantillas con parámetros
Las plantillas aceptan parámetros o argumentos, que les permite aumentar sus funcionalidades, adecuándose a las necesidades de cada página que las utiliza. Así, el contenido de una misma plantilla puede variar en función de los valores que toman los parámetros al momento de utilizarse.
Un parámetro se define mediante la etiqueta {{{n}}}, donde n es un número o identificador de texto.
Supongamos que la Plantilla:Nombre_de_plantilla tiene dos parámetros: texto1 y texto2. Entonces, para que una página los utilice (mediante transclusión), se deberá escribir en ella: {{Nombre_de_plantilla|texto1|texto2}} si no se han definido nombres para los parámetros; y: {{Nombre_de_plantilla|parámetro1=texto1|parámetro2=texto2}} si los parámetros se han definido con los nombres parámetro1 y parámetro2, respectivamente.
Note que las plantillas no están limitadas sólo a dos parámetros, y en general se podrán usar cuantos se necesiten.
[editar] Variables predefinidas
Existen unas variables ya definidas, que se pueden emplear como plantillas o como parámetros en otras plantillas, los datos cronológicos están referidos al meridiano de Meridiano de Greenwich, estas variables son:
- Año:
- {{CURRENTYEAR}} = 2012
- Mes del año, numero:
- {{CURRENTMONTH}} = 05
- Mes del año, nombre completo:
- {{CURRENTMONTHNAME}} = mayo
- Mes del año, nombre:
- {{CURRENTMONTHNAMEGEN}} = mayo
- Mes del año, nombre breve:
- {{CURRENTMONTHABBREV}} = may
- Día del mes:
- {{CURRENTDAY}} = 24
- Nombre del dia de la semana:
- {{CURRENTDAYNAME}} = jueves
- Hora del dia, hora:minutos:
- {{CURRENTTIME}} = 14:45
- Número de semana del año:
- {{CURRENTWEEK}} = 21
- Nombre de la pagina:
- {{PAGENAME}} = Plantillas
- Tipo de la página:
- {{NAMESPACE}} = Ayuda
- Número de artículos:
- {{NUMBEROFARTICLES}} = 817
- Número de páginas:
- {{NUMBEROFPAGES}} = 28.241
- Número de usuarios
- {{NUMBEROFUSERS}} = 20.657
[editar] Sugerencias
[editar] No abuses de las plantillas
Ten en cuenta que existen muchas plantillas, y que es muy posible que alguien ya haya creado una plantilla para lo que deseas. Por eso, evita la creación de plantillas redundantes o innecesarias, revisa en la categoría las plantillas que ya se han creado.
[editar] No son razones para crear una plantilla
- Que ya exista una plantilla específica para otro tema: dado el caso, en lugar de crear otra plantilla que hace prácticamente lo mismo, es mejor pensar en ampliar la plantilla ya existente, incorporándole parámetros.
- Querer tener una plantilla que solo se usará en un tema especifico, la idea es que las plantillas se creen cuando sean necesarias en muchas paginas.
[editar] Categoriza y documenta
Nunca olvides categorizar y documentar las plantillas, mediante la etiqueta «noinclude» explicada inicialmente. Esto es muy necesario para que otros también puedan usar correctamente las plantillas.
[editar] Tipos de plantillas
[editar] Fichas
Una ficha es una plantilla utilizada exclusivamente en artículos, que sirve para resumir y sistematizar por medio de una tabla la información medular presente en cada artículo que la contiene. Se utilizan principalmente en los artículos de nuestros profesores, autores y universidades.
Un ejemplo de este tipo de plantilla: Plantilla de Profesores
[editar] Plantillas de navegación
Una plantilla de navegación es una plantilla diseñada para agrupar artículos de un modo distinto al orden cronológico proporcionado por las categorías, y de forma tal que proporciona información adicional sobre la relación entre dichos artículos.
Un ejemplo de este tipo de plantilla: Plantilla de navegación por departamento.
