Transclusion/es

"Transclusión" es generalmente la inclusión del contenido de un documento en otro por referencia. En el contexto de wiki, es el uso de la funcionalidad de plantilla de MediaWiki para incluir el mismo contenido en documentos múltiples sin la necesidad de editar los documentos por separado.



Cómo funciona transclusión


Para transcluir cualquier página fuente (dentro de un solo proyecto MediaWiki, como Wikipedia) dentro de otra página objetivo, incluya el siguiente código:

Siempre que se renderice la página de destino A, todo el contenido de la página de origen B (en este caso, SOMEPAGE), se renderizará en el lugar donde se colocó la etiqueta de transclusión.

Por ejemplo, podrías decidir colocar un mensaje de bienvenida en la página de charla de cada recién llegado. La transclusión crea un enlace "en vivo" entre la página de la plantilla y la(s) página(s) de destino en la que debe aparecer el mensaje. Cuando se edita la plantilla, también se editan todas las páginas de destino.

También puedes decidir crear una página (plantilla) con tu dirección de correo e incluir esa plantilla no sólo en tu página, sino también en las de tus amigos. Cuando cambies el televisor y el sofá a otro apartamento, puedes cambiar la plantilla de tu dirección, y esa nueva información se actualizará automáticamente en todas las páginas de tus amigos.



Marcado de transclusión y sintaxis
Si la fuente está en el espacio de nombres de la Plantilla (por ejemplo, "Template:Welcome"), sólo hay que usar el nombre en sí, solo:

Si la fuente está en el espacio de nombres del Artículo Principal (por ejemplo, "VisualEditor"), se deben agregar dos puntos delante del nombre:

Si la fuente se encuentra en cualquier otro espacio de nombres (por ejemplo, "User:Example"), debe utilizar el nombre completo, incluido el espacio de nombres:

Si la fuente es una subpágina de la página de destino, (por ejemplo, "Transclusion/ja"), puede simplemente especificar el nombre de la subpágina sin importar el espacio de nombre:

Etimología
Ted Nelson acuñó el término "transclusión", así como "hipertexto" e "hipermedia", en su libro de 1982 Máquinas Literarias.



Transclusión parcial
Utilizando las marcas "noinclude", "onlyinclude" y "includeonly" es posible transcribir parte de una página en lugar de toda ella. Esas transclusiones parciales también pueden lograrse transcluyendo desde otras páginas, como las subpáginas. A menudo es conveniente no transcluir alguna información, como la documentación de plantilla y las categorías.



Ejemplos de cuándo usar transclusión total o parcial
Utilice la transclusión completa cuando desee incluir el contenido completo de una página de origen en una página de destino. Por ejemplo, podría incluir el contenido completo de una página sobre manzanas en una página sobre frutas de árboles. Utilice la transclusión parcial cuando solo desee incluir parte de una página de origen en una página de destino. Por ejemplo, podría incluir solo información sobre manzanas Granny Smith de una página sobre manzanas en una página sobre ingredientes que se usan comúnmente para hornear.



Marcado de la transclusión

 * noinclude - El marcado  significa que el texto entre las etiquetas no se transcribirá a otra página y sólo aparecerá en la propia página. Esto es útil para la documentación de plantillas y categorías.
 * includeonly - El marcado  significa que el texto entre las etiquetas sólo se usará cuando la página se transcriba en otra página, y no aparecerá en la propia página. Esto puede ser útil, por ejemplo, para añadir categorías a las páginas que transcluyen una plantilla, sin añadir la propia plantilla a estas categorías.
 * onlyinclude - El marcado  indica que sólo el texto rodeado por el marcado "$2" debe ser transcluido en otra página, pero aparecerá en la propia página si no va acompañado de las etiquetas "$3" también. Esta es la más sutil de las etiquetas de transcripción parcial porque a menudo anula las otras. Si hay al menos un par de etiquetas de "onlyinclude" en una página, entonces cada vez que esta página es transcluida, es "sólo" el material dentro de las etiquetas de "onlyinclude" el que es transcluido. Puede haber varias secciones "onlyinclude" de este tipo en una página. Esto puede ser útil, por ejemplo, para repetir una pequeña parte de una página en una segunda: sólo hay que rodear la pequeña parte con etiquetas onlyinclude, y transcluirla en la segunda página.

Puede anidar los tres tipos de transclusión entre sí, lo que le permite refinar exactamente qué contenido se muestra en la página actual y es visible en las páginas transcluidas.

Subpáginas
Puede cortar y pegar el texto que desea transcluir en una subpage y luego usar el nombre de la subpágina en la plantilla de transclusión. Este enfoque solo se puede usar cuando las subpáginas están habilitadas; por ejemplo, en la Wikipedia en inglés, las subpáginas solo se pueden usar desde las páginas User, Talk o Wikipedia; actualmente, las subpáginas no se pueden crear a partir de las páginas principales del artículo.

Ejemplo: desea discutir la eliminación y la redirección de Pussycat a Cat. Primero, crea la subpágina Discusión:Pussycat/¡Eliminemos a Pussycat!, escribe tu comentario en ella, luego transclúyelo en Discusión:Pussycat y Discusión:Gata usando la plantilla ' . Los comentarios publicados en cualquiera de las páginas de discusión se mostrarán en ambas.



Páginas especiales

 * Ver también:w:Wikipedia:Transclusion y 

Algunas páginas en Special:Specialpages se pueden transcluir, como Special:AllPages, Special:PrefixIndex, Special:NewFiles, Special:NewPages, Special:RecentChanges y Special:RecentChangesLinked.

Ejemplo: genera 3 páginas nuevas.

Parámetros de URL se pueden proporcionar como parámetros de plantilla, e. g..



Alternativas a la transclusión por plantilla
Ocasionalmente, es posible que desee utilizar una plantilla, pero por una u otra razón es posible que no desee utilizar la transclusión. La copia automática única del código/texto de una plantilla en la ubicación de una etiqueta de plantilla se denomina sustitución o subclusión de plantilla (sustitución + transclusión). Para subcluir el código/texto de una plantilla, la etiqueta de la plantilla se modifica de la etiqueta de transclusión estándar a una etiqueta de sustitución, simplemente agregando subst:, creando una etiqueta con la forma:.



Transclusión de sección etiquetada
Una extensión llamada Transclusión de sección etiquetada permite transcluir secciones de texto marcadas. Una extensión con una función algo similar es la extensión de $1 (sin mantenimiento).

Scribunto
You can transclude page content, or even parts of it, using Lua with the extension. See Module:Transcluder for an example on this wiki.



Semántica MediaWiki
La extensión Semantic MediaWiki utiliza consultas en línea para consultar y mostrar datos semánticos. Actualmente existen dos formas de realizar la transclusión o algo similar:


 * 1) Transclusión propiamente dicha. El formato de visualización "incrustado" garantiza que las páginas seleccionadas (artículos del espacio principal, plantillas, etc.) se transcluyan. Al igual que con las plantillas, se omitirán las secciones ubicadas entre etiquetas no incluidas.
 * 2) A los pasajes seleccionados en una página se les puede asignar una propiedad de tipo 'Texto'. Estas selecciones se pueden solicitar ejecutando una consulta en línea para este tipo de propiedad.

Consulte consultas en línea para obtener más información.



Páginas relacionadas con la transclusión de MediaWiki

 * w:Wikipedia:espacio de nombres de MediaWiki
 * m:Ayuda:espacio de nombres de MediaWiki
 * m:Ayuda:Variable
 * w:Wikipedia talk:Template namespace

Plantillas

 * w:Wikipedia:espacio de nombres de plantilla
 * w:Wikipedia:Límites de plantilla
 * w:Wikipedia:Límites de plantilla

<span id="See_also">

Véase también

 * Solicitud de transclusión de plantilla de Commons (plantillas interwiki, etc.)
 * w:Wikipedia:Substitution (lo opuesto a transclusión)
 * Extensión:Transclusión de sección etiquetada