Usuario:Grillitus/Manual-Plantillas

Grillitus puede trasladar los datos de una plantilla a otra usando una plantilla, para hacer esto usa un grupo de parámetros y funciones para copiar los datos de la plantilla original a la de destino.

Para los ejemplos usaremos una plantilla origen llamada "PersonData"

{{PersonData
|name = Mark
|lastname = Owen
|age = 25
|notes = 
}}

Elementos básicos

<param>

Extrae el valor de un campo de la plantilla original y reemplaza su contenido, ejemplo:

Uso: <param>nombre del campo en la plantilla original</param>

{{Ficha de ejemplo
|nombre = <param>name</param> <param>lastname</param>
|edad =
|nota =
}}

Al hacer el traspaso reemplazaría name y lastname:

{{Ficha de ejemplo
|nombre = Mark Owen
|edad =
|nota =
}}

~campo~

Alternativa al uso de <param>

Uso: ~nombre del campo en la plantilla original~

{{Ficha de ejemplo
|nombre = ~name~ ~lastname~
|edad =
|nota =
}}

Al hacer el traspaso reemplazaría name y lastname:

{{Ficha de ejemplo
|nombre = Mark Owen
|edad =
|nota =
}}

<param-lit>

Obliga a Grillitus a reemplazar primero los parámetros y luego interpretar el resultado como código Wiki

Uso: <param-lit>... algo ... [Parametros] ... algo ...</param-lit>
lit viene de "literal" (tal como viene)

{{Ficha de ejemplo
|nombre = <param-lit>Escudo: [[Archivo:Escudo de ~name~.jpg]] </param-lit>
|edad =
|nota =
}}

Al hacer el traspaso reemplazaría name y luego interpretaría el resultado como un enlace:

{{Ficha de ejemplo
|nombre = Escudo: [[Archivo:Escudo de Mark.jpg]]
|edad =
|nota =
}}

Funciones

<if>

Evalúa los elementos de tipo "Condición", les aplica un AND y devuelve un resultado:

Uso: <if>[Una o más condiciones]Resultado en caso de ser verdad las condiciones</if>
Nota: Aún no está implementado el "ELSE"

Ejemplo:

{{Ficha de ejemplo
|nombre = 
|edad =
|nota = <if><tienevalor>~name~</tienevalor>La persona tiene nombre y su apellido es ~lastname~</if>
}}

Paso 1: Evalúa los PARAM

{{Ficha de ejemplo
|nombre = 
|edad =
|nota = <if><tienevalor>Mark</tienevalor>La persona tiene nombre y su apellido es Owen</if>
}}

Paso 2: Evalúa las condiciones, en este caso TIENEVALOR

{{Ficha de ejemplo
|nombre = 
|edad =
|nota = <if>(true)La persona tiene nombre y su apellido es Owen</if>
}}

Como es (true) genera la salida:

{{Ficha de ejemplo
|nombre = 
|edad =
|nota = La persona tiene nombre y su apellido es Owen
}}

<else>

Elemento que se genera si la condición no se cumple en el IF, ejemplo: Ejemplo:

{{Ficha de ejemplo
|nombre = 
|edad =
|nota = <if><tienevalor>~name~</tienevalor>Parte verdadera<else>Parte falsa</else></if>
}}

<or>

Devuelve verdadero si se cumple alguna de sus condiciones:

Uso: <or>[Una o más condiciones]</or>

Ejemplo:

<or><tienevalor>~name~~lastname~</tienevalor></or>

Funciones de análisis de campos

<elprimero>

Deja el primer parámetro que tenga valor, el resto lo descarta

Uso: <elprimero>~param 1~~param 2~...~param N~</elprimero>

Ejemplo: Si en la original existe:

|title=Grillo loco
|nombre=
|titulo2=Grillitus

y se aplica:

|titulo=<elprimero>~nombre~~titulo2~~title~</elprimero>

quedaría

|titulo=Grillitus

<separaBR>

Separa los elementos no vacíos con un <br /> (los que están vacíos los ignora)

Uso: <separaBR>~param 1~~param 2~...~param N~</separaBR>

Ejemplo: Si en la original existe:

|title=Grillo loco
|nombre=
|titulo2=Grillitus

y se aplica:

|titulo=<separaBR>~nombre~~titulo2~~title~</separaBR>

quedaría

|titulo=Grillitus<br />Grillo loco

Condiciones

Se usan en las expresiones condicionales, ejemplo, dentro de un IF.

<tienevalor>

Devuelve Verdadero si su contenido tiene algo:

Uso: <tienevalor>Algo que haya quedado acá</tienevalor >

Ejemplo:

{{Ficha de ejemplo
|nombre = 
|edad =
|nota = <if><tienevalor>~name~</tienevalor>La persona tiene nombre y su apellido es ~lastname~</if>
}}

Parámetros especiales

Grillitus admite algunos parámetros especiales usando un espacio de nombres "Opciones", con eso se puede indicar comportamientos y post-procesos con sus datos, la sintaxis es:

{{Opciones:Nombre de la plantilla|Parámetro 1|Parametro 2...}}

Estos son todos los parámetros existentes y su funcionalidad:

{{Opciones:nombre
|Dibujar=[Vertical|Horizontal]          (Indica como dibujar la plantilla; dibujar verticar u horizontal)
|MoverAlPrincipio                       (Mueve la plantilla al principio del documento)
|MoverAlFinal                           (Mueve la plantilla al final del documento, antes de las categorías)
|BorrarComentarios                      (Elimina todos los comentarios de la plantilla y de sus subplantillas)
|BorrarParametrosVacios                 (Elimina todos los parámetros que no tengan datos)
|MantenerParametrosVacios=campo1,campo2 (Indica cuales campos mantener en caso de usar "BorrarParametrosVacios")
}}

Ejemplos

En este ejemplo se indica para que Ficha de química" que dibuje la plantilla verticalmente, borre los parámetros que no se usaron y quite los comentarios:

{{Opciones:Ficha de química
|Dibujar=Vertical
|BorrarParametrosVacios
|BorrarComentarios 
}}

Otros reales que uso:

{{Opciones:Bueno             |Dibujar=Horizontal|MoverAlFinal}}
{{Opciones:Destacado         |Dibujar=Horizontal|MoverAlFinal}}
{{Opciones:Wikiquote         |Dibujar=Horizontal|MoverAlFinal}}
{{Opciones:Commonscat        |Dibujar=Horizontal|MoverAlFinal}}
{{Opciones:Artículo destacado|Dibujar=Horizontal|MoverAlPrincipio}}
{{Opciones:Otrosusos         |Dibujar=Horizontal|MoverAlPrincipio}}
{{Opciones:Otros usos        |Dibujar=Horizontal|MoverAlPrincipio}}