Diferencia entre revisiones de «Transclusión»

Revisión del 14:28 26 jul 2010

Transclusión es un término introducido por "Ted" Nelson, como parte de su propuesta de hipertexto, para designar la capacidad de reproducir en pantalla el texto de otro documento electrónico.

Rasgos

La transclusión tiene 2 rasgos importantes en ambientes de redacción cooperativa de textos:

• evita la repetición innecesaria de textos y
• asegura la actualización continua de 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 {{:Artículo}}, donde Artículo es el nombre del artículo que se quiere transcluir. 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 del Artículo.

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>Texto2lt;/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 la categoría en el código fuente usando los marcadores <noinclude>. La alternativa es usar los marcadores <onlyinclude> para abarcar el resto del artículo, dejando la Categoría 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

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

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.