Manual wiki/Edición/Plantillas

De Wikilibros, la colección de libros de texto de contenido libre.
Ir a la navegación Ir a la búsqueda

Las plantillas son una utilidad que permite insertar fácilmente trozos de texto, imágenes y cuadros o tablas, que de otra forma sería muy complicado hacer manualmente.

Usar plantillas[editar]

La forma de añadir una plantilla sin variables (que ya ha sido creada) a tu página es muy sencillo, hay que añadir:

{{Nombre de la plantilla}}

Para explicar cómo funcionan las plantillas que usan variables, en primer lugar hay que saber cómo funcionan. Algunas tienen una explicación en su página: [[Plantilla:Nombre de la plantilla]]

Un ejemplo de plantilla que se usa en la Portada y es el usado para poner enlaces a los libros es el que ahora se muestra. Constituye una Política de Wikilibros.

Vamos a explicar la Plantilla:Libro. Está estructurada de la siguiente forma:

{{Libro|Nombre del libro|Nombre para mostrar (op) }}

Libro: Es obligatorio ponerlo. Es la forma de indicar que usaremos la Plantilla:Libro.

Nombre del libro: Hay que poner el nombre exacto del libro. Sirve para crear el enlace a ese libro.

Nombre para mostrar: Es opcional. Si no se pone, el texto del enlace tendrá el mismo nombre que el libro.

Aplicación práctica:
Existe el libro Inmersión en Python pero en portada debe aparecer como un lenguaje de programación: Python. Para que aparezca Python pero enlace a Inmersión en Python se usa la plantilla con las dos variables. Junto a los otros Wikilibros añadiríamos el siguiente texto:

{{Libro|Inmersión en Python|Python}}


La plantilla anterior añade, además el nivel de desarrollo "oficial" de cada libro, mostrado en la subpágina Desarrollo de todos los libros que si no existe habrá que crearla, poniendo la siguiente plantilla que vamos a explicar. Es una política oficial. Para completar la página Desarrollo se usa la siguiente plantilla:


Otro ejemplo de plantilla que usa variables es la plantilla desarrollo:

{{Desarrollo|100%|Junio de 2006}} cuyo efecto es: Grado de desarrollo: 100% (a fecha de Junio de 2006)

  • Desarrollo es el nombre de la plantilla, así que si queremos visualizarla o editarla tendremos que ir a la página: Plantilla:Desarrollo.
  • 100% es la primera variable. Lo que hace esta variable es añadir la imagen 100%.png 100 percent.svg.
  • Junio de 2006 es la segunda variable.

La particularidad que tiene esta plantilla es que añade una imagen que cuando te paras sobre ella te dice cuándo ha sido la última revisión. Ejemplo: Grado de desarrollo: 100% (a fecha de Junio de 2006)

Crear plantillas[editar]

Supongamos que queremos hacer una plantilla en la que salga un semáforo con un color diferente cada vez. Para ello sabemos la existencia de: "Semaforo verde.png", "Semaforo amarillo.png" y "Semaforo rojo.png". Así que nuestra plantilla debe tener una variable que pueda tomar los valores verde, rojo y amarillo.

Las variables en las plantillas son números correlativos dentro de tres corchetes, así la variable {{{1}}} será sustituida por el primer valor que le demos y así sucesivamente.

En primer lugar debemos crear una página con el nombre de nuestra plantilla. Si nuestra plantilla se va a llamar "Semáforo", debemos crear la página: Plantilla:Semáforo.

Como queremos que muestre una imagen su texto será: [[Imagen:Semaforo {{{1}}}.png]]

Cuando vayamos a aplicar la plantilla pondremos {{Semáforo|"color"}} pudiendo valer "color": verde, amarillo y rojo.

Los efectos son:
Archivo:Semaforo verde.png


[[Imagen:Semaforo {{{"verde"}}}.png]] - {{Semáforo|verde}}

Archivo:Semaforo amarillo.png


[[Imagen:Semaforo {{{"verde"}}}.png]] - {{Semáforo|amarillo}}

Archivo:Semaforo rojo.png


[[Imagen:Semaforo {{{"verde"}}}.png]] - {{Semáforo|rojo}}

Variables[editar]

Hemos visto un ejemplo de variables. Realmente es el más usual y más cómodo. Consiste en llamar a las variables {{{1}}}, {{{2}}}... y así sucesivamente. Ésto hará que cuando introduzcamos una plantilla la primera variable sin nombre la llamará {{{1}}} por defecto, y se sustituirá su valor en la parte de la plantilla que aparezca {{{1}}}.

Nosotros también podemos dar nombres a las variables ya que en algunos casos concretos se hace necesaria, (véase {{Artes culinarias/Datos de receta}}). En ese ejemplo concreto facilita al editor de la receta qué valores debe introducir (cuando la crea a partir de la caja que se encuentra en la portada del libro). Nombrar las variables es fácil: Al editar una plantilla en lugar de poner números correlativos, llámalas como quieras, debes saber que al introducir la plantilla debes especificar: |Variable1 = Valor|Variable2 = Valor|, por eso quizá no merezca la pena en la mayoría de plantillas poner nombres a las variables. Cuando no lo escribas así, seguirá llamándolas {{{1}}}, {{{2}}}...

Otro tipo de plantillas: Transclusiones[editar]

Hay casos en los que es útil mostrar el contenido de una página en algún lugar, es el caso de Ayuda en el que se muestra el contenido de Wikilibros:Manual.

Otra utilidad es hacer una página para imprimir, en el que queremos añadir a una página todo el contenido de un libro.

Para usar una página como plantilla:

{{:Nombre de la página}}

Nota: Este no debe ser el sistema general para hacer plantillas, ya que el software de wikimedia reconoce el prefijo "Plantilla:" para darle un trato especial.

Explicación de la plantilla[editar]

Para dar una breve explicación sobre la plantilla, puedes usar las etiquetas: <noinclude> [...] </noinclude>.

Si añades estas etiquetas, lo que haya entre ellas no se mostrará en la plantilla. Es una buena forma de explicar al usuario y editor cómo funciona la plantilla en cuestión. Debes saber que todo lo que preceda a la etiqueta se mostrará, incluidos los saltos de línea. Es posible que no te interese mostrarlos. Puedes ver un ejemplo en Plantilla:Semáforo.

Otras variables[editar]

Los wikis tienen unas variables que dan información sobre la hora, el día, el mes y el año. Estas variables son:
{{CURRENTMONTH}} - 10
{{CURRENTMONTHNAME}} - octubre
{{CURRENTMONTHNAMEGEN}} - octubre
{{CURRENTMONTHABBREV}} - oct
{{CURRENTTIME}} - 17:54
{{CURRENTDAY}} - 21
{{CURRENTDAYNAME}} - lunes
{{CURRENTWEEK}} - 43
{{CURRENTYEAR}} - 2019


{{NAMESPACE}} -
{{NUMBEROFARTICLES}} - 8153
{{PAGENAME}} - Manual wiki/Edición/Plantillas
Estas variables se pueden usar en todas las páginas. Se utilizan como si fueran plantillas.