La transclusión se refiere a la inclusión del contenido de un documento dentro de otro documento por referencia . En el contexto de Wikipedia, la transclusión implica que el software MediaWiki haga referencia al contenido de una página, conocida como plantilla o fuente , para incluirlo en el contenido de otra página, denominada página de destino . De manera similar a cómo se puede vincular cualquier nombre de página colocando su nombre entre corchetes dobles, cualquier nombre de página se puede transcluir como plantilla encerrándolo entre llaves dobles. Cualquier cambio realizado en la plantilla o fuente se refleja automáticamente en todas las páginas que incluyen ese contenido transcluido. [a]{{Namespace:Pagename}}
Si el nombre de la página de la plantilla no especifica un espacio de nombres al principio, se supone que se encuentra en el espacio de nombres de la plantilla . Para hacer referencia a una página en el espacio de nombres del artículo principal , es necesario anteponerle dos puntos ( :
). Por ejemplo:
{{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 feLa transclusión y el contenido que incluye o excluye se pueden controlar utilizando las etiquetas wikitexto invisibles , , , y en la página de origen , como se describe con más detalle en Marcado a continuación. [b] Las primeras tres etiquetas habilitan la transclusión parcial , a diferencia del comportamiento predeterminado de las llaves dobles, que transcluirán todo el contenido de la página de origen. Para la transclusión selectiva , se pueden utilizar las etiquetas o y se pueden nombrar secciones de la página de origen, luego, utilizando funciones de analizador, se puede llamar a la plantilla con el nombre de la sección como parámetro : .<noinclude>
<onlyinclude>
<includeonly>
<section>
<includeonly>
<section>
{{#section:Pagename|Sectionname}}
Los eventos de transclusión ocurren cada vez que se carga la página de destino y se representa la plantilla. Un evento relacionado es Substitution , donde una llamada de plantilla se reemplaza con su contenido de origen transcluido en el momento en que se invoca. A diferencia de la transclusión, que actualiza continuamente la página de destino con los cambios de la fuente, la substitución da como resultado una inclusión única del contenido, lo que significa que las actualizaciones posteriores del contenido de origen no se reflejarán en la página de destino. Por ejemplo, una llamada de plantilla for con el prefijo da como resultado la llamada de plantilla substitution . Cuando se invoca, esta plantilla se reemplaza, también denominada stitution, con el wikitexto real de la página de origen en el momento de la llamada, lo que la convierte en una parte permanente de la página de destino. [c]{{Pagename}}
subst:
{{subst:Pagename}}
La transclusión se ejecuta antes del análisis y puede emitir fragmentos de sintaxis para preservarlos en la representación final. El contenido que se transcluye se procesa e integra antes de que la página de destino se analice y se represente por completo. Cuando la transclusión se produce en la capa HTML antes del análisis, permite que cierto contenido (como fragmentos de sintaxis, como referencias a entidades de caracteres como &
y mp;
o componentes HTML específicos) se inserten en su forma original y se conserven en la representación final. Sin embargo, este enfoque puede provocar que las páginas se representen incorrectamente o violen el principio de menor sorpresa para el lector. [d] Debe usarse con moderación cuando no haya alternativas más limpias disponibles. Es poco probable que la emisión de fragmentos de sintaxis de plantilla, como llaves de apertura ( {{}}
), se vuelva a analizar correctamente como sintaxis de plantilla en la página de destino, y no es prudente confiar en dicho comportamiento a menos que esté documentado formalmente.
Es posible transcluir contenido de Wikidata a artículos de Wikipedia u otros wikis.
Para transcluir contenido de una página de origen (dentro de un único proyecto de MediaWiki, como Wikipedia en inglés) a una página de destino , utilice {{SOURCEPAGE}}
en el código de la página de destino .
Cada vez que {{SOURCEPAGE}}
se incluye el código en una página de destino, el software de Wikipedia coloca todo el contenido SOURCEPAGE
en ese lugar de la página de destino.
Consideremos un ejemplo, complementado con la ilustración siguiente, con las páginas de destino A , P y Q , y la página de origen B.
Si la página de origen B se transcluye en A , el contenido de B (por ejemplo, la palabra "foo") aparecerá en lugar del {{B}}
código en la página A. Cuando se transcluye, este contenido no se resalta ni se enmarca en la página de destino, sino que se integra directamente en el texto de la página (resaltado aquí solo a modo de ilustración).
La transclusión crea un vínculo "activo" entre una página de origen y todas las páginas de destino a las que se transcluye y utiliza su contenido. Al editar la página de origen, se actualiza automáticamente su contenido en todas las páginas de destino que la incluyen.
Por ejemplo, si crea una página fuente con detalles sobre un evento de Wikimedia y la incluye en las páginas de discusión de 50 editores que desea invitar, cualquier actualización que realice en la página fuente (como cambiar la ubicación del evento) se reflejará inmediatamente en las 50 páginas de discusión.
Las modificaciones de una página de origen pueden afectar a todas las páginas de destino que la utilicen. Si una página de origen también contiene sus propias inclusiones de otras páginas de origen, evite realizar cambios que puedan romper estos vínculos, ya que esto afectaría a la página de origen que está editando y a todas las páginas de destino que la incluyen. Esto se conoce como "ruptura" y es mejor asegurarse de que cualquier actualización mantenga la integridad del contenido incluido en todas las páginas. Por ejemplo, la página principal es una página grande que incluye su contenido de varias páginas de origen incrustadas, como Wikipedia:Lista de destacados de hoy .
La sintaxis general para la transclusión en Wikipedia es , donde define el título de una página de Wikipedia. {{Namespace:Pagename}}
Namespace:Pagename
La estructura de Wikipedia incluye espacios de nombres que organizan las páginas en función de su propósito. Por ejemplo, una página titulada Wikipedia:Consejos utiliza Wikipedia:
como espacio de nombres y Tips
como nombre de página. Sin embargo, los artículos del espacio principal , como Potato , no tienen ningún espacio de nombres visible en su enlace wiki; residen en el espacio de nombres principal de forma predeterminada.
{{Namespace:Pagename}}
Namespace:Pagename
{{Wikipedia:Notability}}
{{WP:Notability}}
WP:
Wikipedia:
{{:Pagename}}
Pagename
{{:Notability}}
{{Pagename}}
Template:Pagename
{{Notability}}
{{Template:Notability}}
En resumen, incluir o en el código fuente de una página transcluirá el contenido de . Si se utiliza en su lugar, se transcluirá el artículo del espacio principal titulado . Al incluir, se transcluye una página en el espacio de nombres definido (como ).{{Pagename}}
{{Template:Pagename}}
Template:Pagename
{{:Pagename}}
Pagename
{{Namespace:Pagename}}
Help:Pagename
Además, los parámetros de plantilla específicos y los modificadores de transclusión permiten pasar parámetros a las plantillas, modificar la forma en que se produce la transclusión y, por lo tanto, personalizar el resultado. Esto se explica con más detalle a continuación.
Las subpáginas , que se identifican por un /
en sus nombres de página, son páginas relacionadas con una página "principal" (por ejemplo, Namespace:Pagename/Subpagename
es una subpágina de ). Esta función está deshabilitada en los espacios de nombresNamespace:Pagename
principal, de archivo y de MediaWiki , pero no en sus espacios de nombres de discusión correspondientes.
Para transcluir subpáginas:
{{Namespace:Pagename/Subpagename}}
{{/Subpagename}}
{{Pagename/Subpagename}}
{{:Pagename/Subpagename}}
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, según la plantilla que se utilice. 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 value
se denominan parámetros sin nombre o posicionales. Los parámetros que toman la forma parameter name=value
se 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 text
y This is a custom warning line
son los valores de los parámetros sin nombre '1' y '2'; y true
es 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:
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:
{{Help:Editing sections of included templates}}
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>
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.
La transclusión de secciones estándar utiliza . Se puede transcluir fácilmente el contenido de una sección de una página a otra utilizando los encabezados de sección basados en titulares que se utilizan en Wikipedia. Para transcluir la sección principal de un artículo con este método, se puede utilizar . Este método es más simple que otros métodos de transclusión selectiva, que requieren un marcado especial en el artículo o la página de origen para especificar qué contenido se debe incluir o excluir.{{#section-h:PAGENAME|SECTIONNAME}}
{{#section-h:PAGENAME}}
La transclusión de la sección estándar puede introducir un salto de línea inicial o final o una nueva línea, según el marcado de las páginas de origen y destino. Para evitarlo, envuelva el código de transclusión en una plantilla. Por ejemplo:{{trim}}
{{trim|{{#section-h:PAGENAME|SECTIONNAME}}}}
{{trim|{{#section-h:PAGENAME}}}}
Para indicar en la página de destino dónde se origina el contenido transcluido selectivamente (su fuente), se debe colocar una nota al pie en la parte superior de la sección correspondiente en la página de destino a la que se está transcluyendo el contenido . [e] [f] Utilice cualquiera de los siguientes, dependiendo de si el contenido transcluido es la sección completa o solo una parte de ella:{{Transcluded section}}
{{transcluded section|source=PAGENAME#SECTION}}
|part=yes
: , que se representa como:{{transcluded section|source=PAGENAME#SECTION|part=yes}}
Se recomienda incluir un comentario oculto al comienzo de la sección transcluida en la página de origen . Este comentario informa a los editores que el contenido se está utilizando en otro lugar y sirve como recordatorio para tener en cuenta a la audiencia más amplia al modificar la redacción. Además, ayuda a mantener la integridad del material transcluido en la página de destino. Por ejemplo (reemplace [[PAGENAME#SECTION]] con el nombre de la página de destino):
<!-- The content of this section is transcluded to
[[PAGENAME#SECTION]]
. Please be aware that changes made to the original source here will affect the transcluded version on the target page mentioned. -->
No se debe colocar ninguna nota en la página de origen , en otras palabras, no se necesita ninguna nota en la página desde la que se realiza la transclusión , ya que los lectores no necesitan saber en qué otro lugar aparece el contenido.
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>
transcludesection
transcludesection
transcludesection
transcludesection
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 transcludesection
se 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:
SUB-ARTICLE_PAGENAME
<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}}
[[PARENT_ARTICLE]]
{{no selflink|PARENT_ARTICLE}}
[[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.
<noinclude>
, <includeonly>
y <onlyinclude>
marcado en la página transcluida para tener contenido selectivo ; eso requeriría monitorear que el marcado se mantenga.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.