Ayuda:Transclusión

Esta es una página de información . No se trata de un artículo enciclopédico ni de una de las políticas o directrices de Wikipedia ; más bien, su propósito es explicar ciertos aspectos de las normas, costumbres, tecnicismos o prácticas de Wikipedia. Puede reflejar diferentes niveles de consenso y revisión .

Atajos H:TRADUCCIÓN H:TRANSCL WP:TRANS WP:TRANSCL

La transclusión significa la inclusión del contenido de un documento dentro de otro documento por referencia . En la transclusión de Wikipedia, el software MediaWiki hará referencia al contenido de una página, la plantilla , para incluirlo en el contenido de cualquier otra página, la página de destino. De manera similar a la forma en que cualquier nombre de página puede convertirse en un enlace colocando su nombre entre corchetes dobles, cualquier nombre de página puede convertirse en una plantilla colocándolo entre llaves dobles. Los cambios realizados en la plantilla se reflejan automáticamente en todas las páginas en las que se ha transcluido esa página (aunque a veces puede ser necesaria una purga ).{{Namespace:Pagename}}

Si el nombre de la página de la plantilla no comienza con un espacio de nombres, se asume que pertenece al espacio de nombres de la plantilla. Para hacer referencia a una página del espacio de nombres "Principal" (artículo), es necesario anteponerle dos puntos ( : ). Ejemplos:

• {{Stochastic processes}}se incluirá desde la página Plantilla:Procesos estocásticos
• {{:Stochastic processes}}se incluirá desde la página Procesos estocásticos (un artículo, en el espacio de nombres principal)
• {{Wikipedia:Assume good faith}}se incluirá en la página Wikipedia:Asumir buena fe

Lo que se transcluirá de una página se puede controlar con las etiquetas <noinclude>, <onlyinclude> y <includeonly> colocadas en el wikitexto de la página de origen. (Vea el marcado, a continuación). El uso de etiquetas permite que la plantilla transcluya parcialmente, de lo contrario, las llaves dobles siempre transcluirán todo el contenido. Para la transclusión selectiva , las partes <includeonly> de la plantilla se nombran (con la ayuda de las funciones del analizador ) y luego se llama a esa plantilla con el parámetro .transcludesection=name

Los eventos de transclusión ocurren cada vez que se carga la página , cuando se renderiza la plantilla. Otro uso del mismo mecanismo es una sustitución única de la llamada de plantilla por su página de origen transcluida. Una llamada de plantilla con el prefijo "subst:" se transcluye una vez pero nunca más, porque el wikitexto de esa llamada se reemplaza (sustituye) cuando se guarda su página . Lo que era una llamada de plantilla única se convierte en el wikitexto real de la plantilla en el momento de su llamada.{{fullpagename}}{{subst:fullpagename}}

La transclusión se ejecuta antes de analizar la página de destino en la capa HTML, por lo que es posible emitir fragmentos de sintaxis (incluso fragmentos de referencias a entidades, como "&a" y "mp;") que se analizarán correctamente como texto combinado en la página de destino. Como modismo de diseño, esto tiende a violar el principio de la menor sorpresa, por lo que se debe utilizar con moderación, cuando no se presentan soluciones más claras. Es poco probable que la emisión de fragmentos de sintaxis de plantilla, como un par de llaves de apertura, se vuelva a analizar correctamente como sintaxis de plantilla en la página de destino. Incluso si esto funcionara, no sería prudente depender de esto como un comportamiento compatible, a menos que esté documentado formalmente.

Además, es posible trasladar contenido de Wikidata a otros wikis.

Para transcluir cualquier página de origen (dentro de un único proyecto de MediaWiki, como en:Wikipedia), utilice el siguiente código en la página de destino :

{{SOURCEPAGE}}

Cada vez que escribes el código ( {{SOURCEPAGE}}) en una página de destino, le estás indicando al software de Wikipedia que coloque todo el contenido de SOURCEPAGEen la página de destino.

En el siguiente ejemplo , observe las páginas de destino A y SOURCEPAGE B.

Si B se transcluye en A , el software de Wikipedia incluirá en ese lugar específico no el código ( {{B}}) en sí sino el contenido de la página fuente B (que es simplemente la palabra foo ).

La fila superior muestra cómo se verán las páginas de destino A , P y Q con los cambios en el código que se ven en la fila inferior para transcluir la página de origen B. Observe la posición del código en cada página de destino de ejemplo.

El contenido de la página de origen, foo , no se resaltará ni se encuadrará en la página de destino. ( Foo se encuentra en un cuadro azul claro aquí para facilitar la ilustración y la comprensión).

La transclusión crea un vínculo "activo" entre una página de origen y la página de destino donde aparece el contenido de la página de origen. Esto significa que cuando editas una página de origen, estarás actualizando su contenido en todas las páginas de destino que la incluyen. Digamos que creas una página de origen en Wikipedia con la dirección, fecha y hora de un evento local de Wikimedia al que quieres invitar a 50 editores locales. A continuación, transcluyes la página de origen de la invitación en tu página de discusión, así como en las páginas de discusión de los otros 50 editores. Una semana después, descubres que el lugar del evento debe ser cambiado de lugar. Entonces, actualizarías la página de origen y la nueva dirección aparecerá automáticamente en las páginas de discusión de todos los demás asistentes. También podrías decirles a los editores que inviten a personas que quizás no hayas incluido. Entonces, ellos podrían simplemente transcluir la página de origen de la invitación en las páginas de discusión de otros editores.

Recuerde tener mucho cuidado al editar cualquier página de origen, especialmente si contiene inclusiones de otras páginas de origen. Romper inclusiones existentes en una página de origen se denomina ruptura . Evite las rupturas porque no solo se verán afectadas la página de origen más grande que está editando y todas las páginas de destino que la incluyen. También se verán afectadas tanto la página de origen ya incrustada (ahora rota) que se utilizó para agregar contenido a la página de origen más grande, como todas las páginas de destino donde se incluyó la página de origen incrustada.

La sintaxis general para la transclusión en Wikipedia es , donde describe el título de una página de Wikipedia. {{Namespace:Pagename}}Namespace:Pagename

El uso de la sintaxis de transclusión requiere cierto conocimiento de los títulos de las páginas. En Wikipedia, las páginas que no son artículos tienen títulos con un espacio de nombres visible y un nombre de página separados por dos puntos; por ejemplo, la página Wikipedia:Tips tiene Wikipediacomo espacio de nombres y Tipscomo nombre de página. Pero los artículos enciclopédicos solo tienen un nombre de página visible en sus títulos: por ejemplo, el artículo Potato tiene Potatocomo nombre de página y el espacio de nombres, llamado main namespace , no es visible.

• El wikitexto transcluirá la página titulada . Por ejemplo, si una página tiene el wikitexto , transcluirá la página Wikipedia:Notability en ella. Tenga en cuenta que esto haría exactamente lo mismo, ya que es un alias de espacio de nombres , que los servidores de Wikipedia traducen automáticamente a .{{Namespace:Pagename}}Namespace:Pagename{{Wikipedia:Notability}}{{WP:Notability}}WP:Wikipedia:
• Si se omite el espacio de nombres, pero se incluyen los dos puntos, como , se transcluirá el artículo enciclopédico . Por ejemplo, se transcluirá el artículo Notability .{{:Pagename}}Pagename{{:Notability}}
• Si se omiten tanto el espacio de nombre como los dos puntos, como , se incluirán. Por ejemplo , y también , ambos incluirán Template:Notability .{{Pagename}}Template:Pagename{{Notability}}{{Template:Notability}}

En resumen, una página de ejemplo que tenga incluido el wikitexto o , transcluirá el en esa página de ejemplo. Pero tendrá un efecto diferente: transcluirá el artículo . Además, transcluirá la página , para las páginas con títulos de ese formato. También tienes la opción de usar parámetros de plantilla y modificadores de transclusión.{{Pagename}}{{Template:Pagename}}Template:Pagename{{:Pagename}}Pagename{{Namespace:Pagename}}Namespace:Pagename

Las subpáginas son páginas separadas por una "/" (una barra) de su página "principal". Para una página principal con el formato de nombre Namespace:Pagename, el nombre de su subpágina tendría el formato . Esta función está deshabilitada en los espacios de nombresNamespace:Pagename/Subpagename principal, de archivo y de MediaWiki , pero no en sus espacios de nombres de discusión correspondientes.

Para transcluir una subpágina:

• La sintaxis general es .{{Namespace:Pagename/Subpagename}}
• En la página principal de una subpágina, es la sintaxis general o .{{/Subpagename}}
• Para una página de espacio de nombres de plantilla, es la sintaxis general o .{{Pagename/Subpagename}}
• Las subpáginas de artículos están deshabilitadas en esta wiki, pero de lo contrario lo estarían .{{:Pagename/Subpagename}}
• También tienes la opción de utilizar parámetros de plantilla y modificadores de transclusión.

Por ejemplo, para incluir Template:Like/doc , sería o . Tenga en cuenta que los nombres de las subpáginas distinguen entre mayúsculas y minúsculas y no funcionarían.{{Template:Like/doc}}{{Like/doc}}{{Like/Doc}}

La aplicación más común de la transclusión es la transclusión de plantillas . Las plantillas son páginas que se escriben con el objetivo principal de ser incluidas en otras páginas, ya sea mediante transclusión o sustitución . Como se muestra arriba, la sintaxis habitual para la transclusión de una plantilla titulada Template:Pagename es . Sin embargo, algunas plantillas también pueden usar parámetros . Los parámetros son variables a las que se les pueden dar valores (también denominados argumentos ) que se pueden pasar a ciertas plantillas para que funcionen de diferentes maneras. Las plantillas pueden no usar parámetros, usar un número fijo de parámetros o usar un número variable de parámetros. El número de parámetros que puede usar una plantilla es de uno en adelante.{{Pagename}}

La sintaxis exacta para usar parámetros con plantillas puede variar mucho, dependiendo de la plantilla que se use. Pero, para una plantilla de ejemplo titulada Template:Pagename, que usa tres parámetros, el formato general sería:

{{Pagename|parameter1|parameter2|parameter3}}

con cada parámetro siendo sustituido por un value, o un parameter name=value, cuando se utiliza en la práctica. Observe que cada parámetro está separado por una barra vertical . Los parámetros que toman la forma valuese denominan parámetros sin nombre o posicionales. Los parámetros que toman la forma parameter name=valuese denominan parámetros con nombre . Con parámetros sin nombre, el primer, segundo, tercer parámetro, etc. son equivalentes a los parámetros '1', '2', '3', etc. en la documentación de la plantilla. Los parámetros sin nombre deben estar en el orden correcto y es mejor colocarlos antes de los parámetros con nombre. Un ejemplo de la sintaxis utilizando Template:Collapse top :

{{Collapse top|This is the title text|This is a custom warning line|left=true}}

En este ejemplo particular, se utilizan tres parámetros, pero Template:Collapse top en realidad puede utilizar una cantidad variable de parámetros. This is the title texty This is a custom warning lineson los valores de los parámetros sin nombre '1' y '2'; y truees el valor del parámetro con nombre left.

Para obtener más detalles, consulte Ayuda:Plantilla . Además, consulte Wikipedia:Índice de plantillas para obtener una lista de enlaces a las plantillas relacionadas con el espacio de nombres principal (normalmente para artículos enciclopédicos) y otras plantillas relacionadas con el espacio de nombres (normalmente para páginas que no son artículos); también hay una función de búsqueda. Los parámetros de plantilla también se utilizan en el método de parametrización de la transclusión selectiva.

La sustitución tiene una sintaxis de doble corchete similar y su acción es similar a la transclusión. Cuando se obtiene una vista previa de una página que contiene un wikitexto de sustitución, su acción es idéntica a la transclusión. Pero cuando se guarda una página que contiene un wikitexto de sustitución, se diferencia en que sustituye ese wikitexto por el wikitexto real de la plantilla.

Por ejemplo, cuando se guarda, se sustituirá ese wikitexto por el wikitexto real de Template:Like . En la práctica, la principal diferencia que esto supone es que si se produce una actualización del wikitexto de Template:Like, no se actualizarán las páginas que ya se hayan guardado.{{subst:Like}}{{subst:Like}}

Las palabras mágicas no son ejemplos de transclusión, pero algunas tienen una sintaxis y una acción de doble corchete similares a las de la transclusión. Por ejemplo, muestra el nombre de página completo de cualquier página de Wikipedia. Al igual que las plantillas, algunas palabras mágicas también pueden aceptar parámetros, que se separan mediante dos puntos (:); por ejemplo , . {{FULLPAGENAME}}{{FULLPAGENAME:value}}

Existen plantillas para algunas palabras mágicas, por ejemplo Template:FULLPAGENAME ; pero estas solo invocan la palabra mágica relacionada si se pasan parámetros usando una barra vertical (|); por ejemplo, like . Pero los parámetros de las palabras mágicas se pasan mejor directamente usando dos puntos, por ejemplo, like , que omite cualquier plantilla.{{FULLPAGENAME|value}}{{FULLPAGENAME:value}}

Como se explicó anteriormente, con el ejemplo , el código altera la transclusión a sustitución. Este es un modificador de transclusión , un tipo de palabra mágica especializada para alterar la transclusión de alguna manera. Otro ejemplo es , donde el (carácter de dos puntos) fuerza la transclusión al espacio de nombres principal. Hay modificadores de transclusión adicionales como , , , , y . Para obtener más detalles sobre su uso, consulte mw:Help:Magic words § Transclusion modifiers. Consulte también los comandos modificados , y utilizados para la sección etiquetada transclusion .{{subst:Like}}subst:{{:Notability}}:safesubst:int:msg:msgnw:raw:#section:#section-x:#section-h:

La aplicación más común de la transclusión es el uso de plantillas . Sin embargo, a veces también se transcluyen otras páginas, principalmente dentro del espacio del proyecto.

Las páginas compuestas están formadas por páginas componentes transcluidas , ya sea en parte o en su totalidad. El wikitexto de una página compuesta puede incluir etiquetas HTML para incrustar o incluir páginas componentes. Los componentes suelen ser páginas completas por derecho propio y, por lo general, no se encuentran en el espacio de nombres de la plantilla. Las páginas compuestas tienen como objetivo reunirlas en una ubicación central para el lector.

Ejemplos de páginas compuestas:

• Wikipedia:Bomba de pueblo : consiste principalmente en la página transcluida Plantilla:Bomba de pueblo .
• Una página diaria como Wikipedia:Artículos para borrar/Registro/31 de mayo de 2005 , donde cada página componente consiste en la discusión sobre la eliminación de una página de Wikipedia, por ejemplo, Wikipedia:Artículos para borrar/Sp3tt . Para este día, 75 páginas componentes formaron la página compuesta.
• m:Meta:Traducción/Coordinación, que contiene principalmente
  • m:Meta:Traducción/Coordinación/Lista/Meta
  • m:Meta:Traducción/Coordinación/Lista/Principal

Esto permite elegir entre ver las páginas de los componentes por separado o juntas. Ver una página compuesta es conveniente cuando hay muchas páginas de componentes pequeñas relacionadas, ya que permite tener una visión general de todos los componentes sin el esfuerzo de seguir numerosos enlaces.

En general, cada página componente y la página compuesta se tratan por separado. Si bien los cambios reales en las páginas componentes se transcluirán en la página compuesta, el historial de edición, los cambios recientes, la configuración de seguimiento de la página, la protección de la página, la tabla de contenidos, los vínculos "qué enlaza aquí" y otras características de la página compuesta no reflejan, ni afectan, los historiales, la configuración de seguimiento, los niveles de protección y las listas de qué enlaza aquí de las páginas componentes. La página compuesta es una página en sí misma. La página de discusión de una página compuesta se utiliza para hablar sobre la composición y la página en general, no sobre las páginas componentes; aunque a su vez podría ser una composición de las páginas de discusión de las páginas componentes.

La edición de una sección de una página de componente se puede realizar directamente desde la página compuesta, consulte la sección de edición de las plantillas incluidas . Después de guardar, se termina de editar la página de componente a la que pertenece la sección.

En proyectos con la función de enlace interlingüe , la página compuesta muestra los enlaces interlingües combinados de todas las páginas componentes, por lo que es posible que haya múltiples enlaces para un idioma o incluso para una página.

Cuando dos páginas necesitan tratar el mismo material de la misma manera, pueden compartir una sección. Por ejemplo, una sección de una página existente puede ser transcluida en otras páginas. Esto también puede implicar la creación de una tercera página y transcluirla en ambas páginas. Esta tercera página puede ser una página por derecho propio o una subpágina de cualquiera de las otras dos, excepto en el espacio de artículos, donde no se permiten subpáginas (ver WP:SUB ). La tercera página puede ubicarse en el mismo espacio de nombres que las otras páginas o en el espacio de nombres de plantillas, nuevamente, excepto para su uso en el espacio de artículos, donde las plantillas no deben almacenar texto de artículos (ver WP:TG ). Las secciones comunes como esta deben marcarse con un encabezado explicativo y/o se les debe dar un diseño especial, para informar al lector que esta sección de la página está en una ubicación diferente, ya que la transclusión de secciones de artículos compartidas puede confundir fácilmente a los editores novatos y a los lectores por igual si se deja sin marcar.

Esto puede ser muy útil cuando dos páginas de desambiguación comparten contenido, ^{[ en disputa – discutir ]} o una página de lista y una página de desambiguación comparten contenido (ver el tercer ejemplo a continuación).

Ejemplos:

• El artículo Ayuda:Edición de secciones de plantillas incluidas se incluye en Ayuda:Sección con el marcado . Al incluir un encabezado en el artículo incluido, un usuario que haga clic en el enlace "Editar" en ese encabezado en Ayuda:Sección es dirigido automáticamente a editar Ayuda:Edición de secciones de plantillas incluidas .{{Help:Editing sections of included templates}}
• m:Ayuda:Orden alfabético (discusión, enlaces entrantes, edición)
• Joseph Gordon-Levitt transcluye la introducción de HitRecord en una sección de resumen del mismo nombre, en lugar de mantener dos copias del texto idéntico.

En las páginas donde hay mucha información repetitiva (generalmente, varios tipos de listas), a veces resulta útil crear una plantilla que contenga el texto repetido y luego llamarla varias veces. Por ejemplo, la plantilla:EH listed building row se usa repetidamente para construir tablas en muchos artículos.

La repetición simple del mismo texto se puede manejar con la repetición de un parámetro en una sola plantilla: por ejemplo, {{ 3x }} , donde produce .{{3x| howdy!}} howdy! howdy! howdy!

Para obtener más información sobre la repetición, consulte también m:Ayuda:Conversión recursiva de wikitexto.

Para obtener más información sobre el sistema de plantillas actual, consulte Wikipedia:Espacio de nombres de plantilla .

Al utilizar el marcado <noinclude>, <includeonly>y <onlyinclude>, es posible transcluir parte de una página, en lugar de toda ella. Estas transclusiones parciales se pueden lograr mediante la transclusión de cualquier página, incluidas las subpáginas. A menudo resulta útil excluir parte de una página en una transclusión, por ejemplo, con la documentación de plantillas.

Para ver un ejemplo de cómo se puede aplicar esta técnica para simplificar la creación de artículos de resumen , vea cómo se transcluyó parte de la Historia de la patología (vea la diferencia aquí) en Patología (vea la diferencia aquí) utilizando el marcado. El artículo de Patología en ese momento (vea aquí) consistía principalmente en párrafos introductorios transcluidos y otras secciones de varios artículos. Mire la fuente para ver cómo se hizo esto. Desde entonces, el artículo de Patología ha sido reescrito y no incluye todas estas transclusiones.{{:History of pathology}}

Otro ejemplo se puede encontrar en la transclusión de parte de HitRecord (sólo el párrafo introductorio) en una sección de resumen con el mismo nombre en Joseph Gordon-Levitt .

En la transclusión, una página de origen se transcluye en una página de destino. Sin embargo, con la transclusión parcial, solo una parte de esa página de origen se transcluirá en una página de destino. Además, lo que se transcluye en una página de destino no tiene por qué ser visible en la página de origen.

La representación de una página de origen se puede definir como la representación de esa página de origen cuando se guarda, que será la misma que la vista previa . Podemos llamar a esta representación aquí .

La representación por transclusión de una página de origen se puede definir como la representación de una página de destino que tiene una página de origen transcluida en ella, pero solo la parte de la página de destino que se transcluyó de la página de origen. La vista previa de la representación por transclusión será nuevamente idéntica. Podemos llamar a esta representación allí .

Hay tres pares de etiquetas involucradas en los casos en los que la representación de la página aquí debe ser diferente de la representación por transclusión allí . Como se describió anteriormente, estas son <noinclude>, <includeonly>y <onlyinclude>. Estas etiquetas son invisibles, pero afectan tanto a la representación de la página aquí como a la representación por transclusión allí . Estas etiquetas se emparejan para demarcar las secciones que crearán diferencias. Cada etiqueta describirá las excepciones a la transclusión de toda la página nombrada.

<noinclude> Esta sección es visible aquí, pero no allí. Las secciones que no estén incluidas en estas etiquetas serán visibles aquí y allí. </noinclude><onlyinclude> Esta sección es visible aquí; esta sección también es visible allí. Las secciones fuera de estas etiquetas serán visibles aquí, pero no serán visibles allí. </onlyinclude><includeonly> Esta sección no es visible aquí, pero sí allí. Las secciones que no estén incluidas en estas etiquetas serán visibles tanto aquí como allí. </includeonly>

Un punto importante a tener en cuenta es que <noinclude>y <onlyinclude>no afectan en absoluto lo que se representa en la página aquí<includeonly> , a diferencia de . Las <noinclude>etiquetas impiden que el texto dentro de las etiquetas se transcluya allí , mientras que <onlyinclude>tienen el efecto opuesto: impiden que el texto fuera de las etiquetas se transcluya allí .

Solo <includeonly>impide que el texto se muestre en la página aquí , pero naturalmente se transcluye allí . El texto que se encuentre fuera de las etiquetas se mostrará aquí y se transcluirá allí .

Puede haber varias secciones de este tipo. También pueden estar anidadas. Se pueden lograr todas las diferencias posibles entre aquí y allá .

Un ejemplo es un editor de contenido que escoge una <onlyinclude>sección y luego quita otra <noinclude>sección de ella, pero luego escoge otra <onlyinclude>sección para agregarla allí ; pero nada de esto afecta su artículo de ninguna manera.

Otro ejemplo es el programador de plantillas, quien se encargará <includeonly>de la sección de código y <noinclude>de la sección de documentación de una página.

La transclusión selectiva es el proceso de transcluir parcialmente una sección seleccionada de un documento que tiene más de una sección transcluible. Como se indicó anteriormente, si solo se debe transcluir una sección de un documento, esto se puede hacer simplemente rodeando la sección de interés con etiquetas y transcluyendo toda la página. Sin embargo, para transcluir selectivamente una sección de una plantilla o documento en una página, y otra sección de la misma plantilla o documento en una segunda página y/o en una sección diferente de la misma página, se requiere una forma de: <onlyinclude> … </onlyinclude>

a) marcar de forma única cada sección transcluible en el documento fuente; y

b) en el documento o documentos de destino (aquellos que muestran las secciones transcluidas), una forma de especificar qué sección se debe transcluir.

En esta sección se describe cómo lograrlo. Hay tres formas de hacerlo: (1) transclusión basada en encabezado de sección, (2) transclusión de sección etiquetada y (3) el método de parametrización.

Con , se puede transcluir fácilmente el contenido de una sección de una página a otra haciendo referencia a los encabezados de sección basados ​​en títulos estándar y omnipresentes que se utilizan en Wikipedia. Para transcluir el encabezado de un artículo con este método, se puede utilizar . Esto es más simple que los métodos de transclusión selectiva ya ampliamente utilizados de las secciones siguientes, que requieren un marcado especial del documento fuente.{{#section-h:PAGENAME|SECTIONNAME}}{{#section-h:PAGENAME}}

 Este método de transclusión selectiva suele agregar un salto de línea por encima o por debajo de la transclusión de sección, según el marcado del documento de origen y de destino; para evitar este problema, envuelva la plantilla de transclusión selectiva en una plantilla.{{trim}} En otras palabras, utilice las siguientes modificaciones al código de transclusión que se indica inmediatamente arriba:

• Código para incluir una sección en el cuerpo de un artículo:{{trim|{{#section-h:PAGENAME|SECTIONNAME}}}}
• Código para incluir el encabezado de un artículo:{{trim|{{#section-h:PAGENAME}}}}

Para indicar dónde se encuentra el contenido del artículo transcluido selectivamente, es útil incluir una nota al pie en la parte superior de la sección correspondiente de la página a la que se transcluye; es decir, utilice o , dependiendo de si el contenido transcluido es una sección completa de la página transcluida. Estas plantillas se representan de la siguiente manera:{{Transcluded section}}{{transcluded section|source=PAGENAME}}{{transcluded section|source=PAGENAME|part=yes}}

• {{transcluded section|source=PAGENAME#SECTION}}se representa como:

• {{transcluded section|source=PAGENAME#SECTION|part=yes}}se representa como:

No es necesaria una nota de este tipo en la sección que se va a incluir , ya que el contenido no tiene un interés inmediato para el lector en otros lugares. Sin embargo, es probable que sea pertinente incluir una nota de comentario HTML entre el encabezado y el contenido incluido para que los editores estén al tanto de la reutilización del material y tengan en cuenta a la audiencia más amplia al cambiar la redacción. Ejemplo:

• <!-- The content of this section is transcluded at PAGENAME2#SECTION and PAGENAME3#SECTION. -->

La transclusión selectiva de secciones etiquetadas utiliza las funciones del analizador enumeradas en mw:Extension:Labeled Section Transclusion, que están habilitadas en todos los wikis de Wikimedia, para transcluir contenido de forma selectiva. Consulte Help:Labeled section transclusion para saber cómo funciona la transclusión de secciones etiquetadas.

Inserte la siguiente línea en el documento "fuente" (aquel del cual se va a incluir el texto), inmediatamente antes de la primera línea de cada sección que se va a incluir, sustituyendo SECTIONNAME (dos veces) por el nombre único de la sección respectiva. El nombre de la sección puede ser cualquier identificador y debe ser único dentro de ese documento:

<onlyinclude>{{#ifeq:{{{transcludesection|SECTIONNAME}}}|SECTIONNAME|

Termine cada una de estas secciones transcluibles con:

}}</onlyinclude>

Para transcluir una sección marcada como arriba en otra página (la "página de destino"), utilice la siguiente línea en esa página, sustituyendo PAGENAME por el documento "fuente" desde el cual se transcluirá el texto, y SECTIONNAME por el nombre de la sección que desea transcluir:

{{PAGENAME|transcludesection=SECTIONNAME}}

Por lo tanto, cada sección encerrada en etiquetas siempre se representará cuando el parámetro no esté configurado (cuando el documento se visualice de manera normal o cuando el documento se transcluya sin configurar el parámetro como se muestra a continuación) y se representará mediante la transclusión en cualquier página que sí esté configurada con el nombre de la sección. No se representará mediante la transclusión que utilice el parámetro pero lo configure con cualquier otro valor que no sea el nombre de la sección.<onlyinclude> … </onlyinclude>transcludesectiontranscludesectiontranscludesectiontranscludesection

Además, al proporcionar PAGENAME sin proporcionar un Namespace , la wiki asumirá que PAGENAME pertenece al Template Namespace . Para realizar una transclusión desde un artículo de Mainspace , utilice :PAGENAME.

{{:PAGENAME|transcludesection=SECTIONNAME}}

Si queremos que las secciones "Criterios principales" y "Nombre común" de WP:TITLE se puedan transcluir de forma independiente, editamos la página WP:TITLE y adjuntamos la sección "Criterios principales" de la siguiente manera:

<onlyinclude> {{ # ifeq : {{{ transcludesection | principalcriteria }}} | principalcriteria | ... '' ( texto  de  la sección "Criterios principales"  ) '' ... }} </onlyinclude>

De igual forma, adjuntamos en el apartado “Nombre común”:

<onlyinclude> {{ # ifeq : {{{ transcludesection | commonname }}} | commonname | ... '' ( texto  de  la sección "Nombre común"  ) '' ... }} </onlyinclude>

Luego, para trasladar la sección "Criterios principales" a otra página, insertamos en esa página:

{{WP:TITLE|transcludesection=principalcriteria}}

Para trasladar la sección "Nombre común" a otra página, insertamos en esa página:

{{WP:TITLE|transcludesection=commonname}}

Por supuesto, la misma página puede incluir dos o más secciones de esta manera incluyendo múltiples líneas de este tipo.

No existe límite en cuanto a la cantidad de secciones seleccionables para la transclusión que puede tener un documento. El único requisito es que a cada una transcludesectionse le asigne un valor que sea único dentro de esa página.

Según MOS:LEAD#Formato de la primera oración , la primera instancia del título del subartículo debe aparecer en negrita en la primera oración principal de ese artículo; esto no suele ser deseable para una transclusión a una sección del artículo principal. Además, el artículo principal suele incluir un wikilink en la introducción de un subartículo; cuando se transcluye al artículo principal, este wikilink aparecerá como texto en negrita. El marcado de wikitexto que se indica a continuación se puede utilizar para abordar ambos problemas.

Para garantizar que el título del artículo aparezca en negrita en la primera oración del subartículo, pero sin negrita y con un enlace wiki en la transclusión al artículo principal, realice el siguiente reemplazo en la primera oración principal del subartículo:

Reemplazar

SUB-ARTICLE_PAGENAME

con

<noinclude>'''</noinclude>{{No selflink|{{var|SUB-ARTICLE_PAGENAME}}}}<noinclude>'''</noinclude>

Si hay un enlace wiki al artículo principal en la sección principal del subartículo, reemplazar el enlace wiki al artículo principal con una plantilla garantizará que se incluya en el enlace wiki en la sección principal del subartículo, pero no en la transclusión al artículo principal. En otras palabras:{{no selflink}}

1. Si el enlace wiki al artículo principal no es un enlace WP:Piped , reemplácelo con en la introducción del subartículo.[[PARENT_ARTICLE]]{{no selflink|PARENT_ARTICLE}}
2. Si el enlace wiki al artículo principal incluye una barra vertical (por ejemplo, este enlace) , reemplácelo con en la introducción del subartículo.[[PARENT_ARTICLE|Piped link wikitext]]{{No selflink|PARENT_ARTICLE|Piped link wikitext}}

Al igual que muchas tecnologías de software, la transclusión tiene una serie de inconvenientes. El más obvio es el costo en términos de mayores recursos de la máquina necesarios; para mitigar esto en cierta medida, el software impone límites de plantillas para reducir la complejidad de las páginas. A continuación se enumeran algunos inconvenientes adicionales.

• Es posible que el texto transcluido no tenga fuentes para las afirmaciones que deberían citarse donde aparecen , que tenga diferentes estilos de referencia establecidos , que contenga errores de citación sin texto o errores de clave duplicada . (Para ayudar a mitigar estos problemas, consulte Ayuda:Errores de citación )
• Los extractos rompen el vínculo entre el código del artículo y el resultado del artículo.
• Los cambios realizados al contenido transcluido a menudo no aparecen en las listas de seguimiento, lo que da como resultado cambios no visibles en la página de destino.
• El texto transcluido puede generar enlaces repetidos o tener variedades de inglés y formatos de fecha diferentes a los de la página de destino.
• Es posible que las transclusiones no reflejen los niveles de protección , lo que puede provocar que el texto transcluido tenga un nivel de protección diferente al de la página de destino. Consulte Protección en cascada
• {{ excerpt }} y las plantillas relacionadas pueden requerir el uso de <noinclude>, <includeonly>y <onlyinclude>marcado en la página transcluida para tener contenido selectivo ; eso requeriría monitorear que el marcado se mantenga.
• Los extractos hacen que los editores controlen las páginas transcluidas para comprobar si hay cambios en el "encabezado de sección" y así garantizar que la transclusión siga funcionando. (Para ayudar a mitigar esto, consulte MOS:BROKENSECTIONLINKS )
• Los extractos pueden dar lugar a debates sobre el contenido de varias páginas de discusión que pueden tener diferentes consideraciones u objetivos para los lectores.

Algunas páginas de Special:Specialpages pueden transcluirse, como AllPages , PrefixIndex , NewFiles , NewPages , RecentChanges , WhatLinksHere (consulte la página de ayuda ) y RecentChangesLinked . Ejemplos:

• {{Special:AllPages/General}}– una lista de páginas que comienzan con "General".
• {{Special:PrefixIndex/General}}– una lista de páginas con el prefijo "General".
• {{Special:NewFiles/4}}– una galería de los cuatro archivos cargados más recientemente.
• {{Special:NewPages/5}}– una lista de las cinco páginas creadas más recientemente.
• {{Special:RecentChanges/5}}– los cinco cambios más recientes.
• {{Special:RecentChangesLinked/General}}– cambios recientes en las páginas enlazadas desde "General".
• {{Special:Contribs/Larry Sanger|offset=20021108002158|limit=50}}– contribuciones de usuarios anteriores a noviembre de 2002, limitadas a 50.

Intentar transcluir no dará como resultado una lista real de categorías, pero se puede utilizar para este propósito.{{Special:Categories}}{{Special:PrefixIndex/Category:}}

A excepción de Special:RecentChangesLinked, la barra y la palabra o número después de la barra se pueden omitir, lo que da como resultado una lista de páginas sin un punto de inicio específico o una lista con la longitud predeterminada.

Los parámetros de URL se pueden proporcionar como parámetros de plantilla:

• {{Special:RecentChanges|namespace=10|limit=5}}– los cinco cambios más recientes en el espacio de nombres "Plantilla".
• {{Special:PrefixIndex/Jimbo Wales/|namespace=2|stripprefix=1}}– las subpáginas de Usuario:Jimbo Wales , pero sin el prefijo de página de usuario.

Nota: la transclusión de ciertas páginas especiales (como Special:NewPages ) puede cambiar el título mostrado de la página.

• mw:Transclusion: una introducción sencilla (en MediaWiki).
• meta:Ayuda:Incrustar página: proporciona información básica (en Meta-Wiki).
• Wikipedia:Espacio de nombres MediaWiki
  • meta: Ayuda: Espacio de nombres de MediaWiki: en Meta-Wiki.
• meta:Ayuda:Variable: información sobre las variables de MediaWiki (en Meta-Wiki).
• Ayuda:Transclusión de sección etiquetada :
  • mw: Extensión: Transclusión de sección etiquetada: en MediaWiki.
  • meta:Ayuda:Plantilla § Sección etiquetada transclusión: en Meta-Wiki.

• Ayuda:Una guía rápida sobre plantillas : una introducción sencilla.
• Ayuda:Plantilla : descripción más detallada.
  • meta:Ayuda:Plantilla: ayuda en Meta-Wiki. Enlaces a otras guías en la introducción.
  • mw:Ayuda:Plantilla: una introducción sencilla a MediaWiki.
• Wikipedia:Índice de plantillas : un directorio de plantillas disponibles.
• Wikipedia:Espacio de nombres de plantilla : acerca del espacio de nombres de plantilla .
• Wikipedia:Límites de plantilla : limitaciones en la complejidad de las páginas.

Esta página está referenciada en el Glosario de Wikipedia .

• Transclusión para tontos
• {{ User transclusion }} y {{ User transclusion no }} – casillas de usuario para declarar la propia postura sobre la transclusión
• Wikipedia:Purgar : para forzar la transclusión de plantillas recién actualizadas.
• Wikipedia:Sustitución : lo opuesto a la transclusión.
• Wikipedia: Artículos modulares de WikiProject : ahora desaparecidos.
• Bugzilla:Solicitud de transclusión de plantillas desde Commons: una propuesta para soporte de plantillas interwiki.
• Mw:Usuario:Peter17/Transclusión interwiki razonablemente eficiente