El impulso de FANDOM hacia un ecosistema más inclusivo incluye ahora una "práctica más eficiente" (que no es necesariamente la mejor práctica para usar los infoboxes portátiles, puedes ver también estos enlaces de ayuda para CSS y etiquetas). Estas continúan evolucionando, y son la próxima generación de plantillas después de las InfoboxBuilder. ¡Muchas de las infoboxes portátiles ya se han creado! Este documento es una alternativa a la documentación oficial.
Si usualmente no creas o modificas tus plantillas, esta guía puede que no sea de mucha utilidad.
Es una buena idea leer la lista de preguntas frecuentes.
Como en cualquier nueva funcionalidad, habrán bugs, y trataremos de rastrearlos todos en esta lista.
Trasfondo[]
Como la mayoría de las infoboxes, el formato se desarrolla dentro de una plantilla: artículo (ej. Plantilla:Infobox personaje). Sin embargo, a diferencia de las otras plantillas, una plantilla de una infobox portátil se escribe en un formato XML especial en vez de wikitexto. Este tipo de markup es típico del HTML o de Extensions dentro del wikitexto, y la sintaxis de la infobox portátil es un script de la extensión; esto permite que el formato de la plataforma sea el mismo en plataformas diferentes.
Una vez la plantilla se ha creado se puede usar como cualquier otra plantilla en un artículo. Para muchos, esto significa que una sustitución es posible para la mayoría de los archivos, sin tener que cambiar lo que está escrito en los artículos. La herramienta de migración tiene esto como objetivo, el resultado necesitará de algunos ajustes en muchos casos, y no podrán ser usados en algunas wikis. En estos casos, se necesita perfeccionar más la sintaxis del código si es necesario. Se debe recordar que en la mayoría de los casos donde la herramienta de migración no ofrece un buen resultado, es cuando las plantillas son o muy antiguas, o complejas (que utilizan Lua o funciones Parser, o atípicas (con diseños que no se ven bien en todos los dispositivos.
Información básica[]
Dentro de un artículo, una infobox se usa de la misma que siempre se ha hecho.
{{infobox personaje
| título = Daisy
| imagen = Ejemplo.jpg
| leyenda = Daisy, en el viento
| posición = Flor suprema
| edad = 2 meses
| estado = Activa
| altura = 5 pulgadas
| peso = 20 gramos
}}
La plantilla utilizada (en este caso Plantilla:Infobox personaje) puede estar utilizando la sintaxis de una Infobox portátil, que se ve así:
<infobox>
<title source="título" />
<image source="imagen">
<caption source="leyenda" />
</image>
<data source="posición" />
<data source="edad" />
<data source="estado" />
<data source="altura" />
<data source="peso" />
</infobox>
El ejemplo de abajo no hace una infobox viable, y de hecho puede que sea el resultado básico cuando se usa la herramienta de migración. Hay algunas funciones que faltan pero se puede usar para hacer el borrador mejor.
<infobox>
<title source="título">
<default>{{PAGENAME}}</default>
</title>
<image source="imagen">
<caption source="leyenda" />
</image>
<data source="posición">
<label>Posición</label>
</data>
<data source="edad">
<label>Edad</label>
</data>
<data source="estado">
<label>Estado</label>
</data>
<data source="altura">
<label>Altura</label>
<format>{{{altura}}} pulgadas</format>
</data>
<data source="peso">
<label>Peso</label>
<format>{{{peso}}} gramos</format>
</data>
</infobox>
Borradores de la herramienta de migración de infoboxes[]
La herramienta de migración de infoboxes se usa para convertir otros tipos de infoboxes a infoboxes portátiles con resultados mixtos. En algunos casos más complejos, es necesario hacer ediciones manualmente.
Insertar las infoboxes con el Editor Visual[]
Insertando una infobox con el Editor Visual
Usando el Editor Visual - la herramienta más común para los nuevos usuarios en tu wiki - el proceso de añadir una infobox es muy sencillo. Hay una opción en la barra de herramientas que provee una lista de las infoboxes portátiles. Modificar la misma infobox y algunas operaciones que conlleva no es tan sencillo. Al mismo tiempo, los parámetros para una infobox se exponen sin explicación, y las imágenes y videos no se pueden insertar fácilmente.
Etiquetas[]
Si estás acostumbrado a las plantillas tradicionales, puede que reconozcas la palabra encerrada en tres corchetes (por ejemplo {{{word}}}), que se llama un parámetero.
Estos representan un parámetro para una plantilla, donde el valor de "word" es lo que sea que esté asignado en el artículo. El mismo valor se reconoce en las infoboxes portátiles, usando source="word". Tales parámetros se usan para guardar data en el artículo, aunque no tienen que mostrarse de la misma manera. Se pueden representar usando el tag de <format>.
Para agrupar los elementos en una sección (ya sea horizontal o verticalmente), el tag de <group> puede ser útil.
Los <navigation> tags representan una manera genérica de hacer modificar cualquier tipo de wikitexto dentro de una infobox portátil. Estos tags ocupan típicamente una sección completa (como el <data> tag) y se puede usar para mostrar enlaces o cualquier otro tipo de información. Casi siempre un tag de navegación se usa como un footer.
Imágenes[]
La funcionalidad parecida al tabber es soportada si se pasa un conjunto de imágenes a la plantilla adjuntada en <gallery> o en los tags de <tabber>. Vea la sección de Using multiple images or videos para más ayuda.
- Ejemplo de un infobox portátil
<!-- Infobox character -->
<infobox layout="stacked">
<title source="name"><default>{{PAGENAME}}</default></title>
<image source="image" />
<data source="season"><label>Season(s)</label></data>
<data source="first"><label>First seen</label></data>
</infobox>
- Ejemplo de uso de una galería
{{Infobox character
|name = Mary Crawley
|image = <gallery>
Mary riding.jpg|Mary on a horse
Mary wedding.jpg|Mary in wedding dress
Mary dancing.jpg|Mary dancing
</gallery>
|season = [[Series 1|1]], [[Series 2|2]], [[Series 3|3]],
[[Series 4|4]], [[Series 5|5]], [[Series 6|6]]
|first = [[Episode 1.01]]
}}
- Ejemplo de uso de un tabber
{{Infobox character
|name = Mary Crawley
|image = <tabber>
Riding = [[File:Mary riding.jpg]] |-|
Wedding = [[File:Mary wedding.jpg]] |-|
Dancing = [[File:Mary dancing.jpg]]
</tabber>
|season = [[Series 1|1]], [[Series 2|2]], [[Series 3|3]],
[[Series 4|4]], [[Series 5|5]], [[Series 6|6]]
|first = [[Episode 1.01]]
}}
Cambiando el estilo con CSS[]
Las infoboxes que usan este tipo de codificación ya tienen un estilo predeterminado, tomando por ejemplo el tema estándar de tu comunidad. Si cualquiera de las variables están vacías, la fila o línea de la variable no se va a mostrar (al menos que el tag de 'default' se use).
El inline CSS no puede ser soportado. También un número limitado de clases predefinidas se pueden usar para cambiar el estilo de los elementos mediante los atributos de theme y theme-source.
Layout[]
El diseño predeterminado es un layout "table-like" con etiquetas como las que mostramos en el encasillado de la izquierda.
El otro layout es <infobox layout="stacked"> el cual coloca los labels encima de la información y a la derecha.
Los layouts también le aplican a los grupos (ver abajo) y les da más opciones en las que se pueden describir con la ayuda de Grupos.