|
Article on other languages:
|
Véase también: Ayuda:Guía rápida de plantillas
Una plantilla es un trozo de código de Wikipedia que puede ser re-utilizado 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 espacio de nombres Plantilla:. Antes de crear una plantilla, asegúrate de leer y entender esta guía, en particular la sección Sugerencias.
Estructura de una plantillaEl contenido de toda plantilla está distribuido de tres maneras: Contenido de usoCorresponde al código base de la plantilla, que la faculta para hacer algo en particular, distinto de las demás. 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 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
Cómo utilizar una plantillaSupongamos que queremos utilizar una plantilla llamada SustituciónSe escribe 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í, TransclusiónSe escribe La transclusión relentiza 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. Pseudo-plantillasExisten páginas, que a pesar de no utilizar el espacio de nombres Plantilla:, son utilizadas como tales. Su inclusión es análoga a las Plantillas normales, con la salvedad de que no se puede obviar el espacio de nombres. El ejemplo por antonomasia de pseudo-plantillas son las userboxes. ParámetrosPlantillas con parámetrosLas 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 Supongamos que la
si no se han definido nombres para los parámetros; y
si los parámetros se han definido con los nombres Ejemplo:
Nótese cómo en la segunda inclusión, al no asignársele valores a los parámetros fecha y clave, los textos Si se le asigna más de un valor al mismo parámetro, sólo la última asignación se tomará en cuenta. Por ejemplo,
es equivalente a
Parámetros posicionalesPodemos llamar a los parámetros mediante números, de manera que prescindamos de nombrarlos explícitamente. Así, podríamos escribir
y la plantilla reconocerá automáticamente los parámetros por orden secuencial, como si el primer campo se llamara Ejemplo:
Otro Ejemplo:
Note que este ejemplo falla. El problema está en que el texto que estamos pasando como primer parámetro («2+2=4») tiene un signo igual. El signo igual se utiliza en la sintaxis de los parámetros nombrados, por lo que el sistema cree que le estamos pasando un parámetro de nombre «2+2» con valor «4». La solución consiste en nombrar explícitamente el nombre del parámetro («1»). Luego del primer signo igual, que se usa para separar el nombre del parámetro de su valor, ya no importa si hay más.
Este problema suele suceder a menudo cuando se pasan URL como parámetros posicionales. Muchas veces, las URL (como http://es.wikipedia.org/w/index.php?title=Ayuda:Plantillas) suelen tener signos igual, y el sistema toma como nombre del parámetro todo lo que esté delante del primero (con la URL de ejemplo, interpretaría que hay un parámetro llamado «http://es.wikipedia.org/w/index.php?title» con valor «Ayuda:Plantillas»). Por eso, siempre es conveniente nombrar el parámetro explícitamente cuando se le quiera pasar una URL a una plantilla. Parámetros combinadosLos parámetros nombrados y posicionales se pueden combinar sin problema. El sistema le asignará un número secuencial a cada uno de los parámetros sin nombre, y luego aplicará las reglas de los parámetros nombrados. Por ejemplo,
es equivalente a
que, como el parámetro «2» aparece dos veces, es lo mismo que
Valores por defectoEs posible especificar valores por defecto para los parámetros, de la siguiente manera:
Ejemplo:
Como se ve, en la segunda inclusión de la plantilla no se le asignó valor al parámetro fecha, por lo que se incluyó el valor por defecto, hoy. Parámetros variablesEs posible utilizar como parámetros las palabras mágicas que provee Wikipedia. SugerenciasNo abuses de las plantillasTen en cuenta que existen muchísimas plantillas para los más diversos temas, 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. No son razones para crear una plantilla:
Respeta las convenciones de títulosA pesar que la política de convenciones de títulos no está orientada a las plantillas, sí es muy deseable que los títulos que elijas sean en español e intuitivos. Lo mismo pasa con los nombres de los parámetros: prefiere aquellos explicativos en lugar a las abreviaciones, pero también evita que sean demasiado largos, para facilidad de uso. Categoriza y documentaNunca olvides categorizar y documentar las plantillas, mediante la etiqueta «noinclude» explicada inicialmente. Tipos de plantillasFichasUna ficha (en inglés llamada infobox) 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 categorizan en la Categoría:Wikipedia:Fichas, y un ejemplo de ellas es la plantilla {{ficha de edificio}}. UserboxesUna userbox (término propio del inglés, aún no traducido al español) es una pseudo-plantilla utilizada exclusivamente en páginas de usuario y en algunos wikiproyectos, cuyo espacio de nombres es Usuario:, y que sirve para mostrar características del usuario que la utiliza. Se categorizan en la Categoría:Wikipedia:Plantillas de usuario, y un ejemplo de ellas es la pseudo-plantilla {{Usuario:Userbox/Astronomía}}. Todas las plantillasVéase tambiénAyuda adicional
Convenciones y políticas de plantillas |
This article is from Wikipedia. All text is available under the terms of the GNU Free Documentation License.