Transclusión: inclusión dinámica de contenido (plantillas) en wikis
Transclusión en wikis: aprende a incluir dinámicamente plantillas y secciones con {{ }}, manejar anidación, exclusiones y límites para mantener contenido sincronizado.
La transclusión es una forma de utilizar el contenido de un documento electrónico en otro documento sin tener que copiar el contenido de uno a otro. Si se modifica el contenido original, el cambio aparecerá automáticamente en el artículo que utiliza el contenido transcluido. Los dos documentos están conectados por hipertexto. La palabra es una combinación de trans, que significa a través, y de inclusión, por lo que significa incluir algo que se trae desde otro lugar.
En Wikipedia, esto se utiliza normalmente para poner el contenido de un artículo especial llamado plantilla en otros artículos, pero el método también funciona para otros tipos de artículos.
Cuando pones las llaves dobles {{ }} alrededor del nombre de una página, el programa lee el código fuente del wiki y lo convierte a HTML para que se muestre en un navegador. El programa verá que usted desea añadir el contenido de la página nombrada en ese punto, e irá a leerlo, convertirlo a html y añadirlo en ese punto antes de continuar con la conversión del resto del código fuente de la página original a html. Eso es la transclusión. Se hace referencia a la página que se va a transcluir nombrándola entre llaves, lo que se llama referenciar.
Hay formas de excluir partes de la página transcluida, y formas de transcluir parte de una página, como sólo una sección, pero eso no cambia el concepto básico.
Una página transcluida puede incluir también transclusiones de otras páginas. Esto se llama anidación. Se puede hacer un número moderado de veces, con una página que transcluye otras, que a su vez pueden transcluir otras, una y otra vez. Hay un límite en el número de niveles de transclusión permitidos para evitar bucles infinitos accidentales o intencionados, que harían que el programa de traducción se atascara.
Cómo se usa en la práctica
En los wikis, la transclusión se emplea sobre todo para:
- Mantener elementos repetidos en muchas páginas (por ejemplo, avisos, cajas de información o pie de página) en un solo lugar.
- Crear plantillas reutilizables que aceptan parámetros para adaptarse a distintos usos.
- Separar contenido estructural o técnico del contenido principal, facilitando su edición y mantenimiento.
Sintaxis básica y ejemplos
La sintaxis más simple es llamar a una plantilla por su nombre entre llaves dobles. Por ejemplo:
{{NombreDePlantilla}}— inserta el contenido completo de la plantilla.{{NombreDePlantilla|param1=valor1|param2=valor2}}— inserta la plantilla pasando parámetros que ésta usa para personalizar la salida.
Las plantillas pueden definir parámetros posicionales (ej.: {{Plantilla|valor1|valor2}}) o con nombre (ej.: parametro=valor). Esto permite que una sola plantilla sirva para muchos casos distintos.
Incluir o excluir fragmentos
Para controlar qué parte de una página se transcluye, los wikis suelen ofrecer etiquetas especiales que se colocan en la página origen:
- <noinclude>: el contenido dentro de estas etiquetas no se incluye cuando la página se transcluye, pero sí aparece cuando se visita o edita directamente la página origen.
- <onlyinclude>: sólo el contenido entre estas etiquetas se incluirá al transcluir la página; el resto se ignora en la transclusión.
- <includeonly>: el contenido dentro de estas etiquetas sólo aparece en la versión transcluida y no en la página origen al visualizarla normalmente.
Además de estas etiquetas, otras estrategias frecuentes para transcluir sólo una parte son crear subpáginas o plantillas específicas que contengan únicamente la sección deseada.
Anidación y límites
La transclusión puede anidarse: una plantilla transcluida puede a su vez incluir otras plantillas. Esto facilita la composición modular de páginas complejas, pero también puede complicar la depuración cuando algo no se muestra como se espera.
Para evitar problemas como bucles infinitos o consumo excesivo de recursos, las plataformas de wiki suelen imponer límites en la profundidad y en el número total de transclusiones. Si una cadena de transclusiones alcanza ese límite, la transclusión deja de expandirse más allá del tope y puede mostrarse un mensaje de error o parte del contenido sin expandir.
Ventajas y desventajas
- Ventajas:
- Centraliza contenido repetido: una sola edición actualiza todos los usos.
- Facilita el mantenimiento y la coherencia entre páginas.
- Permite crear componentes reutilizables y parametrizables.
- Desventajas:
- Aumenta la complejidad para editores principiantes, que deben entender cómo funcionan las plantillas.
- Puede afectar al rendimiento cuando hay muchas transclusiones o anidaciones complejas.
- Cambios en una plantilla pueden producir efectos involuntarios en muchas páginas.
Buenas prácticas
- Documentar bien cada plantilla: explicar sus parámetros, su propósito y dónde se utiliza.
- Probar los cambios en una copia o en la propia plantilla antes de editarla en producción, para evitar ediciones masivas no deseadas.
- Usar <onlyinclude> para marcar explícitamente qué parte debe transcluirse cuando la página origen contiene información adicional destinada sólo a la edición.
- Evitar anidaciones innecesarias y mantener las plantillas lo más simples y generales posible.
Terminología relacionada
- Plantilla: página diseñada para ser transcluida y reutilizada.
- Parámetro: valor pasado a una plantilla para personalizar su salida.
- Anidación: proceso por el cual una página transcluida incluye a su vez otras transclusiones.
- Referencia o inclusión: el acto de nombrar la página a incluir entre llaves para que su contenido sea insertado.
Resumen
La transclusión es una técnica poderosa y central en los wikis: permite reutilizar contenido, mantener coherencia y simplificar actualizaciones. Comprender la sintaxis básica, las etiquetas de control (<noinclude>, <onlyinclude>, <includeonly>), y las implicaciones de rendimiento y mantenimiento ayuda a usarla de forma eficaz y segura.
Preguntas y respuestas
P: ¿Qué es la transclusión?
R: La transclusión es una forma de utilizar el contenido de un documento electrónico en otro documento sin tener que copiar el contenido. Los dos documentos están conectados por hipertexto, y cuando se colocan llaves dobles {{ }} alrededor del nombre de una página, el software lo leerá y añadirá el contenido de esa página en ese punto antes de continuar con la conversión del código fuente de la página original.
P: ¿Cómo funciona la transclusión en Wikipedia?
R: En Wikipedia, la transclusión se utiliza normalmente para poner contenido de un artículo especial llamado plantilla en otros artículos, pero también funciona para otros tipos de artículos. Cuando se colocan llaves dobles {{ }} alrededor del nombre de una página, el software lo leerá y añadirá el contenido de esa página en ese punto antes de continuar con la conversión del código fuente de la página original.
P: ¿Qué ocurre si se realizan cambios en un documento original?
R: Si se realizan cambios en un documento original, aparecerán automáticamente en cualquier artículo que utilice contenido transcluido de ese documento.
P: ¿Existe un límite en el número de niveles de transclusión que se pueden realizar?
R: Sí, hay un límite en el número de niveles de transclusión que se pueden hacer para evitar bucles infinitos accidentales o intencionados que causarían problemas con la traducción de programas.
P: ¿Cómo se denomina la referenciación cuando se utiliza la transclusión?
R: Referenciar cuando se utiliza la transclusión significa nombrar las páginas entre llaves {{ }}, de forma que su contenido pueda añadirse en determinados puntos dentro de otro documento.
P: ¿Es posible excluir partes de una página transcluida?
R: Sí, es posible excluir partes de una página trancluida, así como incluir sólo parte de una, como una sección.
P: ¿Puede una página trancluida incluir otras tranclusiones? R:Sí, esto se denomina anidamiento y puede hacerse hasta alcanzar el límite establecido evitando bucles infinitos accidentales o intencionados que podrían causar problemas con los programas de traducción.
Buscar dentro de la enciclopedia