Transclusión

Transclusión es un término introducido por "Ted" Nelson, como parte de su propuesta de hipertexto, para designar la capacidad de reproducir en un documento visualizado en pantalla, mediante un enlace o vínculo, un fragmento de otro documento electrónico independiente.

Rasgos

La transclusión tiene 2 rasgos que son muy importantes en ambientes como éste de redacción cooperativa de textos:

1. Evita la repetición innecesaria de textos preexistentes.
2. Actualiza automáticamente los contenidos, ya que siempre se muestra la última versión del texto transcluido.

En esta Enciclopedia la transclusión de textos se hace mediante el comando {{Página}}, donde Página es el nombre de la página que se quiere transcluir. Para un artículo como éste el nombre de página es el título precedido de ":", :Transclusión. Para la plantilla Institución, el nombre de página es Plantilla:Institución. Como ejemplo, vaya a su página de usuario (Mi página en el menú de la izquierda), escriba allí {{:Artículo}}, donde Artículo es el título de algún artículo existente, y visualice o grabe la página. Verá entonces que aparece allí el contenido completo de Artículo.

La transclusión es la manera recomendada de citar libros, vea el artículo citas de fuentes.

Selección del texto a transcluir

El uso de marcadores en el código fuente de una página controla lo que se muestra o ve en la página fuente y en la página receptora del texto transcluido. Estos marcadores son los siguientes (los signos < y > son indispensables):

1. <onlyinclude>Texto</onlyinclude>. Sólo se transclude a la página receptora el Texto incluido entre estos marcadores en la página fuente, aunque no todo. Tampoco es visible en la página fuente todo el Texto. La aparición o no depende de los marcadores que siguen.
2. <noinclude>Texto1</noinclude>. El Texto1 incluido entre estos marcadores se muestra en la página fuente pero no en la página receptora.
3. <includeonly>Texto2</includeonly>. El Texto2 se muestra en la página receptora, pero no en la página fuente.

Si no se pone ningún marcador, en la página receptora se muestra la totalidad de la página fuente, cuya Categoría queda incorporada a la página receptora. Es necesario por ello excluir explícitamente las Categorías en el código fuente usando los marcadores <noinclude>. La alternativa es usar los marcadores <onlyinclude> para abarcar el resto del artículo, dejando las Categorías fuera de ellos.

Los marcadores <includeonly> se usan habitualmente para no mostrar código que no es de interés para un lector común, caso de las plantillas.

"Transclusión" permanente o subclusión

A veces sólo se quiere copiar parte del contenido de Artículo, sin dejar un vínculo permanente que permita su actualización automática. Esto se hace con el comando de sustitución {{Subst:Artículo}}. Esta operación se denomina subclusión.

Ejemplo

Se ejemplifica a continuación el uso de los marcadores <onlyinclude>, <noinclude> e <includeonly>. La subpágina transclusión/Ejemplo contiene el siguiente código:

Código fuente

Esta página ejemplifica el uso de las marcas que controlan la visualización e inclusión de textos transcluidos.

<includeonly>

:1. Este texto no puede verse en la página fuente (por que lo impiden los marcadores includeonly), ni en la página receptora (por no estar comprendido entre los marcadores <nowiki><onlyinclude></onlyinclude></nowiki>).

</includeonly>

<onlyinclude>

:2. Aquí comienza el primer fragmento de texto que se puede ver (aunque no necesariamente en su totalidad) en la página receptora. El texto que no está comprendido entre los marcadores <nowiki><onlyinclude></nowiki> y <nowiki></onlyinclude></nowiki> sólo puede verse en la página fuente (aunque no necesariamente en su totalidad, veáse el ítem 1 del código).

<noinclude>

:3. Este texto se ve en la página fuente, pero no en la receptora.

</noinclude>

<includeonly>

:4. Este texto no se ve en la página fuente, pero sí en la receptora.

</includeonly>

:5. Aquí termina el primer fragmento de texto que se puede ver (aunque no necesariamente en su totalidad, por lo antedicho) en la página receptora.

</onlyinclude>

<onlyinclude>

:6. Puede haber más de un fragmento de texto comprendido entre los marcadores <nowiki><onlyinclude></nowiki> y <nowiki></onlyinclude></nowiki>, es decir, visible en la página receptora.

</onlyinclude>

:7. Este texto, que incluye la categoría de la página fuente (visible sólo en el mensaje de la parte superior derecha), no se ve en la página receptora.

[[Categoría:cyt-ar]]

Visualización de la plantilla {{:transclusión/Ejemplo}}

2. Aquí comienza el primer fragmento de texto que se puede ver (aunque no necesariamente en su totalidad) en la página receptora. El texto que no está comprendido entre los marcadores <onlyinclude> y </onlyinclude> sólo puede verse en la página fuente (aunque no necesariamente en su totalidad, veáse el ítem 1 del código).

4. Este texto no se ve en la página fuente, pero sí en la receptora.

5. Aquí termina el primer fragmento de texto que se puede ver (aunque no necesariamente en su totalidad, por lo antedicho) en la página receptora.

6. Puede haber más de un fragmento de texto comprendido entre los marcadores <onlyinclude> y </onlyinclude>, es decir, visible en la página receptora.