Cómo crear una plantilla

De YPPedia
(Redirigido desde «Ayuda:Plantillas»)

Para información de las plantillas que se usan de manera estándar en YPPedia, echa un vistazo al manual de estilo. La mayoría de las plantillas mas complejas generalmente tienen instrucciones de uso.

¿Qué son las plantillas y para qué sirven?

Una plantilla es un trozo de código de Wikipedia 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 espacio de nombres Plantilla:

Una plantilla básica sigue el siguiente formato: {{Nombre|1=parámetro|2=parámetro2}}

Al principio se ve bastante difícil, pero si se separan las partes, se ve que sigue una forma lógica:

  • Las partes {{ }}, a menudo llamados llaves, solamente indican donde la plantilla empieza o termina.
  • La parte Nombre es el nombre de la plantilla. Al escribir esa parte, esto llamará a la plantilla para usarla. cada plantilla tiene un nombre, y por supuesto, todas las plantillas sirven para cosas diferentes.
  • La barra vertical, o pleca[1], | separa las plantillas en el nombre y los parámetros.
  • La parte de 1=parámetro son en realidad los parámetros. Estos simplemente le dicen a la plantilla que llenar y donde. A menudo, la parte 1= se omite, ya que no siempre se necesita. Sin embargo, vale la pena saber que existen, especialmente cuando quieres plantillas. Ahora veamos plantillas básicas.

Ejemplos de plantillas básicas

Sin parámetros

Hay muchas páginas que están incompletas. Como tales, se marcan como esbozos, o artículos cortos. Pueden designarse como tales con la plantilla esbozo, que se puede encontrar en la página Plantilla:Esbozo. La plantilla siempre se va a encontrar en Plantilla:Nombre donde Nombre es el nombre específico de la plantilla.

Se puede llamar el uso de la Plantilla:Esbozo tal y como es, simplemente escribiendo {{esbozo}} y mostrará lo siguiente en la página donde se incluya, además de que añade la página a la Categoría:Esbozos (en este ejemplo):

Ejemplo esbozo.png

(Es posible también escribir {{esbozo}} sin que este sea sustituido, usando lo que se llaman etiquetas nowiki. Normalmente, cualquier cosa que se escriba entre las llaves se convierte en una plantilla, pero si se escribe <nowiki>{{esbozo}}</nowiki>, no será cambiado.)


En la página de la Plantilla:Esbozo, verás el siguiente código si das clic en Editar:

{| cellpadding="4" cellspacing="4" style="clear:both; margin: 0.5em auto; border: 1px solid #8B0000; background-color: #antiquewhite" |- |[[Image:Esbozo.png|25px]] |<center>¡Arr! Este '''artículo o sección''' es solo un esbozo.<br>Puedes ayudar a YPPedia añadiendo [{{SERVER}}{{localurl:{{NAMESPACE}}:{{PAGENAME}}|action=edit}} más información].</center> |} <includeonly>[[Categoría:Esbozos|{{PAGENAME}}]]</includeonly><noinclude>{{uso|Esta plantilla es para indicar que un '''artículo o sección''' está incompleto y puede usar más información. Si deseas añadir la notificación de esbozo a la página de un [[plantilla:esbozopirata|pirata]], la página de una [[plantilla:esbozotrip|tripulación]] o la página de un [[plantilla:esbozoblas|blasón]] hay otras plantillas para esto.}}[[Categoría:Plantillas de mensaje de contenido|Esbozoblas]]</noinclude>

Se ve bastante feo, especialmente si no entiendes HTML. Es mucho más sencillo escribir {{esbozo}} que todo eso, especialmente para los nuevos editores. Aún mas, es más sencillo de recordar.

También hay un tercer beneficio - si la plantilla se cambia, actualizará automáticamente todas las páginas, en lugar de tener que volver a escribir todo en cada página. El artículo esbozo se usa cientos de veces - ¡imagina el trabajo que tomaría actualizarlo de uno por uno!

Ahora veamos un ejemplo de una plantilla que usa un solo parámetro:

Un parámetro

Las plantillas con más parámetros son mas interesantes.

Tomemos por ejemplo la Plantilla:Ejemplo fuente. El contenido es el siguiente:

<font color="green">{{{1}}}</font><noinclude> [[Categoría:Plantillas de ayuda]] </noinclude>

Las partes de noinclude y categoría no nos interesan en este momento. Lo que hace esta plantilla es que toma un parámetro y lo hace color verde (green).

Usar esta plantilla es bastante simple: escribe {{Ejemplo fuente|1=Hola}} o {{Ejemplo fuente|Hola}} nos da Hola.

En lugar de tener que escribir un verboso código HTML para que el color verde enfatice digamos, una respuesta correcta, se puede usar esa plantilla. De nuevo mencionamos, si se necesita cambiar el color de todos a un tono de verde distinto, se puede hacer con una sola edición en lugar de hacerlo uno por uno.

Dos parámetros

Las plantillas con múltiples parámetros permiten que haya más variedad, pero también crean mayor confusión.

Muy a menudo, las plantillas de este tipo como la Plantilla:Ejemplo texto se ven como:

<font>{{{texto}}}</font> <noinclude> [[Categoría:Plantillas de ayuda]] </noinclude>

(La parte funcional de esta plantilla se ve en negritas)

Esta plantilla permite al editor escribir un bloque de texto en un color determinado.

Para llamar esta plantilla, se usa la siguiente sintaxis:

{{Ejemplo texto|color=cyan|texto=hola}}

Esto le dice al navegador que:

  • Use la plantilla Ejemplo texto,
  • Use el texto en color cyan
  • Use el texto color cyan en la palabra hola.

Esto da como resultado lo siguiente:

hola

Signos de igual, palabras y números - ¡ay!

En la plantilla con un solo parámetro, la plantilla contiene el texto {{{1}}}. Esto le indica al navegador que debe reemplazar {{{1}}} con lo que se haya designado como primer parámetro.

En el ejemplo de dos parámetros, los números no funcionan:

{{Ejemplo texto|cyan|hola}} nos da lo siguiente que se bastante extraño:

{{{texto}}}

Se pueden encontrar mas detalles de este tipo de plantillas en la página de ayuda de Wikipedia, en los enlaces externos mas abajo.

Para resumir:

Es muy importante que cuando se llame una plantilla se usen las palabras correcta, de otra manera no siempre van a funcionar.

De hecho, hay maneras de permitir entradas múltiples para una cierta plantilla. Esto requiere de los defaults de parámetro que hacen que sea mas complejo de lo que es. Para el lector interesado, el siguiente código permite que un enfoque al texto= color= y a 1= 2= para que funcionen:

<font>{{{texto|{{{2}}}}}}</font>

Usos repetidos de los valores

Digamos que una cierta palabra deba ser escrita 10 veces seguidas. Una plantilla como la Plantilla:X10 puede ocuparse de esto.

Para usarla, simplemente escribe lo siguiente:

{{x10|texto}} donde texto es el texto que necesita repetirse 10 veces.

Por ejemplo:

{{x10|hola}} nos da:

holaholaholaholaholaholaholaholaholahola


Nota que la plantilla no puede añadir espacios. Una plantilla separada con {{{1}}} con espacios entre palabras deberá ser construida.

Alternativamente:

{{x10|hola }} nos da hola hola hola hola hola hola hola hola hola hola


aunque esto resulta en un espacio después del último hola.


Más ejemplos:

{{x10|[[Imagen:Esbozo.png]]}} nos da Esbozo.pngEsbozo.pngEsbozo.pngEsbozo.pngEsbozo.pngEsbozo.pngEsbozo.pngEsbozo.pngEsbozo.pngEsbozo.png

La entrada del parámetro puede absorber otras plantillas:

{{x10|{{x10|hola }}}} produce

hola hola hola hola hola hola hola hola hola hola hola hola hola hola hola hola hola hola hola hola hola hola hola hola hola hola hola hola hola hola hola hola hola hola hola hola hola hola hola hola hola hola hola hola hola hola hola hola hola hola hola hola hola hola hola hola hola hola hola hola hola hola hola hola hola hola hola hola hola hola hola hola hola hola hola hola hola hola hola hola hola hola hola hola hola hola hola hola hola hola hola hola hola hola hola hola hola hola hola hola

Esta es una manera sencilla de repetir algo 100 veces sin tener que hacer una plantilla x100.

El usar trucos de este tipo para ahorrar esfuerzo y tiempo son las llave para ser un excelente usuario de plantillas.

Aparte: En teoría es posible crear una manera de construir una plantilla Xn para cualquier n (donde n es un número natural), usando únicamente las plantillas para los números primos. El como hacer eso exactamente se deja en las manos del lector interesado (y los matemáticos). Sin embargo, hay un uso limitado para ese tipo de plantillas.

Sustitución

Algunas veces es necesario sustituir algún texto en un artículo, por ejemplo la página de YPPedia:Candidaturas a bibliotecario. Hacer esto es bastante simple; todo lo que se necesita es añadir subst: al principio de la plantilla, como sigue:

{{subst:Ejemplo texto|color=green|texto=Hola}} nos da: Hola, pero en realidad mostrará:

<font>{{{texto}}}</font> <noinclude> [[Categoría:Plantillas de ayuda]] </noinclude>

en lugar de {{subst:Ejemplo texto|color=green|texto=Hola}} en la sección de editar de la página.

Vale la pena hacer notar que la sustitución es irreversible (excepto si se revierte una página); esto es, la sustitución ocurre cuando la página de guarda, y una vez ques se guarda, no deja trazos de la plantilla de la cual fue llamada. La sustitución es algo muy raro, ya que no se puede controlar por una edición en la página de la plantilla. Sin embargo, es algo útil saber.

Ver también