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 supone que está en el espacio de nombres de la plantilla. Para hacer referencia a una página en el espacio de nombres "Principal" (artículo), es necesario anteponerle dos puntos ( : ) . Ejemplos:
{{Stochastic processes}}se transcluirá de la página Plantilla: procesos estocásticos{{:Stochastic processes}}se transcluirá de la página Procesos estocásticos (un artículo, en el espacio de nombres principal){{WP:Assume good faith}}se transcluirá de la página Wikipedia: se asume buena feLo 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. (Consulte el marcado a continuación). El uso de etiquetas permite que la plantilla se transcluya parcialmente; de lo contrario, las llaves dobles siempre transcluirán todo el contenido. Para la transclusión selectiva , se nombran las partes <includeonly> de la plantilla (con la ayuda de 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 representa la plantilla. Otro uso del mismo mecanismo es una sustitución única de la llamada de plantilla por su página fuente 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 fue 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 de entidades, como "&a" y "mp;") que se analizarán correctamente como texto combinado en el destino. página. Como lenguaje de diseño, esto tiende a violar el principio de mínima sorpresa, por lo que debe usarse con moderación, cuando no se presentan caminos de solución más limpios. 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 respaldado, a menos que esté documentado formalmente.
Además, es posible transcluir 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 escribe el código ( {{SOURCEPAGE}}) en una página de destino, le está indicando al software de Wikipedia que coloque todo el contenido 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 solo 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 . Tenga en cuenta 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 recuadrará en la página de destino. ( Foo está aquí en un cuadro azul claro para facilitar la ilustración y la comprensión).
La transclusión crea un vínculo "en vivo" entre una página de origen y las páginas de destino donde aparecen los contenidos de la página de origen. Esto significa que cuando edites una página de origen, actualizarás su contenido en todas las páginas de destino que la incluyan. Digamos que creas una página fuente en Wikipedia con la dirección, fecha y hora de un evento local de Wikimedia al que deseas invitar a 50 editores locales. A continuación, transcluye la página de origen de la invitación a su página de discusión, así como a las páginas de discusión de los otros 50 editores. Una semana después descubres que el lugar del evento debe ser trasladado. Luego actualizará 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 puede decirles a los editores que inviten a personas que quizás se hayan perdido. Luego, podrían simplemente transcluir la página fuente de la invitación a las páginas de discusión de otros editores.
Recuerde tener mucho cuidado al editar cualquier página fuente, especialmente si contiene transclusiones de otras páginas fuente. Romper transclusiones existentes en una página de origen se llama rotura . Evite roturas 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. Lo mismo ocurrirá tanto con la página de origen ya incrustada (ahora rota) que se usó para agregar contenido a la página de origen más grande, como con cada página de destino donde se transcluyó 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: Consejos tiene Wikipediacomo espacio de nombres y Tipscomo nombre de página. Pero los artículos enciclopédicos sólo 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 espacio de nombres principal , no es visible.
{{Namespace:Pagename}} transcluirá la página titulada Namespace:Pagename. Por ejemplo, si una página tiene el wikitexto {{Wikipedia:Notability}}, transcluirá la página Wikipedia: Notability en ella. Tenga en cuenta que esto {{WP:Notability}}haría exactamente lo mismo, ya que WP:es un alias de espacio de nombres , que los servidores de Wikipedia traducen automáticamenteWikipedia: a .{{:Pagename}}el artículo enciclopédico . PagenamePor ejemplo, {{:Notability}}transcluirá el artículo Notability .{{Pagename}}, se Template:Pagenametranscluirá. Por ejemplo {{Notability}}, y también {{Template:Notability}}, ambos transcluirán la Plantilla:Notabilidad .Entonces, en resumen, una página de ejemplo que tenga el wikitexto {{Pagename}}incluido {{Template:Pagename}}, se transcluirá Template:Pagenameen esa página de ejemplo. Pero {{:Pagename}}tendrá un efecto diferente: trascluirá el artículo Pagename. Además, {{Namespace:Pagename}}transcluirá la página Namespace:Pagename, para páginas con títulos de ese formato. También tiene la opción de utilizar parámetros de plantilla y modificadores de transclusión.
Las subpáginas son páginas separadas por una "/" (una barra diagonal) 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 Namespace:Pagename/Subpagename. Esta función está deshabilitada en los espacios de nombres principal, de archivos y de MediaWiki , pero no en sus espacios de nombres de conversación correspondientes.
Para transcluir una subpágina:
{{Namespace:Pagename/Subpagename}}.{{/Subpagename}}.{{Pagename/Subpagename}}.{{:Pagename/Subpagename}}.Por ejemplo, para transcluir Plantilla:Me gusta/doc , sería {{Template:Like/doc}}o {{Like/doc}}. Tenga en cuenta que los nombres de las subpáginas distinguen entre mayúsculas y minúsculas y {{Like/Doc}}no funcionarían.
La aplicación más común de 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 transluir una plantilla titulada Plantilla:Nombre de página es {{Pagename}}. 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 utilizar parámetros, utilizar un número fijo de parámetros o un número variable de parámetros. El número de parámetros que puede utilizar una plantilla es de uno en adelante.
La sintaxis exacta para usar parámetros con plantillas puede variar mucho, dependiendo de la plantilla real que se utilice. Pero, para una plantilla de ejemplo titulada Plantilla:Nombre de página, que utiliza tres parámetros, la forma general sería:
{{Pagename|parameter1|parameter2|parameter3}}
y cada parámetro se sustituye por a value, o a 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 posicionales o sin nombre . 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 sintaxis usando Plantilla: Contraer parte superior :
{{Collapse top|This is the title text|This is a custom warning line|left=true}}
En este ejemplo particular, se usan tres parámetros, pero Plantilla: Collapse top en realidad puede usar un número 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 nombrado left.
Para obtener más detalles, consulte Ayuda:Plantilla . Además, consulte Wikipedia: índice de plantillas para obtener una lista de enlaces a plantillas relacionadas con el espacio de nombres principal disponibles (generalmente para artículos enciclopédicos); y otras plantillas relacionadas con espacios 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 transclusión selectiva.
La sustitución tiene una sintaxis similar de doble llave y su acción es similar a la transclusión. Cuando obtienes una vista previa de una página con wikitexto de sustitución, su acción es idéntica a la transclusión. Pero cuando guardas una página con wikitexto de sustitución, se diferencia en que sustituye ese wikitexto por el wikitexto real de la plantilla.
Por ejemplo, cuando {{subst:Like}}se guarda, sustituiría ese wikitexto con el wikitexto real de Plantilla:Me gusta . En la práctica, la principal diferencia que esto hace es que si se actualiza el wikitexto de Plantilla: Me gusta, no se actualizarán las páginas que {{subst:Like}}ya se hayan guardado.
Las palabras mágicas no son ejemplos de transclusión. Pero algunos tienen una sintaxis de doble llave similar y una acción de transclusión. Por ejemplo, {{FULLPAGENAME}}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 tomar parámetros, que se separan mediante dos puntos (:); Por ejemplo {{FULLPAGENAME:value}}.
Existen plantillas para algunas palabras mágicas, por ejemplo Plantilla:FULLPAGENAME ; pero estos simplemente invocan la palabra mágica relacionada si se pasan parámetros usando una barra vertical (|); por ejemplo como {{FULLPAGENAME|value}}. Pero es mejor pasar los parámetros de palabras mágicas directamente usando dos puntos, por ejemplo como {{FULLPAGENAME:value}}, lo que omite cualquier plantilla.
Como se discutió anteriormente, con el ejemplo {{subst:Like}}, el subst: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 {{:Notability}}, donde :(el carácter de dos puntos) fuerza la transclusión al espacio de nombres principal. Hay modificadores de transclusión adicionales como safesubst:, int:, msg:, msgnw:y raw:. Para obtener más detalles sobre su uso, consulte mw:Ayuda:Palabras mágicas § Modificadores de transclusión. Consulte también los comandos modificados #section:y utilizados para la transclusión #section-x:de secciones etiquetadas .#section-h:
La aplicación más común de la transclusión es en 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 constan, total o parcialmente, de páginas componentes transcluidas. El wikitexto de dicha página puede, parcial o totalmente, consistir en etiquetas, para la inclusión de páginas componentes. Las páginas componentes normalmente no están en el espacio de nombres de la plantilla y, a menudo, son páginas completas por derecho propio. Las páginas compuestas están destinadas a reunirlos en una ubicación central.
Ejemplos de páginas compuestas:
Esto permite elegir entre ver las páginas 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 una descripció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 incluirán en la página compuesta, el historial de edición, los cambios recientes, la configuración de visualización de la página, la protección de la página, el TOC, los enlaces "qué enlaces aquí" y otras características de la página compuesta no reflejan , o afectan, los historiales, la configuración de visualización, los niveles de protección, las listas de enlaces aquí de las páginas componentes. La página compuesta es una página por derecho propio. 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 que la componen; aunque a su vez podría ser una combinació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 secciones de edición de plantillas incluidas . Después de guardar, se termina editando la página del componente al que pertenece la sección.
En proyectos con la función de enlace entre idiomas , la página compuesta muestra los enlaces entre idiomas combinados de todas las páginas componentes, por lo que posiblemente haya varios enlaces para un idioma o incluso para una página.
Véase también la charla de Wikipedia: Espacio de nombres de plantilla/Archivo 1#transcluyendo prosa .
Cuando dos páginas necesitan discutir el mismo material de la misma manera, pueden compartir una sección. Por ejemplo, una sección de una página existente puede transcluirse en otras páginas. Esto también puede implicar la creación de una tercera página y su transclusión 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 del artículo, donde no se permiten subpáginas (ver WP:SUB ). La tercera página puede colocarse en el mismo espacio de nombres que las otras páginas o en el espacio de nombres de la plantilla, nuevamente, excepto para su uso en el espacio del artículo, donde las plantillas no deben almacenar el texto del artículo (ver WP:TG ). Las secciones comunes como esta deben marcarse con un encabezado explicativo y/o tener un diseño especial para informar al lector que esta sección de la página se encuentra en una ubicación diferente, ya que la transclusión de secciones de artículos compartidos puede confundir fácilmente tanto a los editores novatos como a los lectores si dejado sin marcar.
Esto puede resultar muy útil cuando dos páginas de desambiguación comparten contenido, [ disputado ] o una página de lista y una página de desambiguación comparten contenido (consulte el tercer ejemplo a continuación).
Ejemplos:
{{Help:Editing sections of included templates}}. Al incluir un encabezado en el artículo incluido, un usuario que hace clic en el enlace "Editar" en ese encabezado en Ayuda:Sección es dirigido automáticamente a editar Ayuda:Edición de secciones de las plantillas incluidas .En páginas donde hay mucha información repetitiva (por lo general, varios tipos de listas), a veces es útil crear una plantilla que contenga el texto repetido y luego llamar a esa plantilla varias veces. Por ejemplo, Plantilla: fila de edificio listado EH 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 {{3x| howdy!}}produce 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 plantillas .
Al utilizar <noinclude>y el marcado, es posible transcluir parte<includeonly> de una página, en lugar de toda ella. Estas transclusiones parciales se pueden lograr transcluyendo desde 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 plantilla. <onlyinclude>
Para ver un ejemplo de cómo se puede aplicar esta técnica para simplificar la creación de artículos resumidos , vea cómo parte de la Historia de la patología (consulte la diferencia aquí) se transfirió a Patología (consulte la diferencia aquí) utilizando el {{:History of pathology}}marcado. El artículo de Patología en ese momento (ver aquí) consistía principalmente en párrafos iniciales 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.
Otro ejemplo se puede encontrar en la transclusión de parte de HitRecord (solo el párrafo introductorio) en una sección de resumen del mismo nombre en Joseph Gordon-Levitt .
En la transclusión, una página de origen se transcluye en una página de destino. Pero con la transclusión parcial, solo una parte de esa página de origen se transcluirá en una página de destino. Pero además, lo que se transcluye a 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 del renderizado de transclusión volverá a ser 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í debería diferir de la representación de transclusión allí . <noinclude>Como se describió anteriormente , estos son <includeonly>y <onlyinclude>. Estas etiquetas son invisibles, pero afectan tanto la representación de la página aquí como la representación de transclusión allí . Estas etiquetas se emparejan para demarcar secciones que crearán diferencias. Cada etiqueta describirá excepciones a la transclusión de toda la página nombrada.
<noinclude> Esta sección es visible aquí; pero esta sección no es visible allí. Las secciones fuera de estas etiquetas serán visibles tanto aquí como 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 allí. </onlyinclude><includeonly> Esta sección no es visible aquí; pero ahí se ve. Las secciones fuera de estas etiquetas serán visibles tanto aquí como allá. </includeonly>
Un punto importante a tener en cuenta es que <noinclude>y <onlyinclude>no afecta en absoluto la página representada aquí<includeonly> , a diferencia de . Las <noinclude>etiquetas evitan que el texto dentro de las etiquetas se transcluya allí , mientras que <onlyinclude>tiene el efecto opuesto: impide que el texto fuera de las etiquetas se transcluya allí .
Aquí solo <includeonly>evita que el texto se represente en la página . Pero, naturalmente, allí queda transcluido . El texto fuera de las etiquetas se representará aquí y se transcluirá allí .
Puede haber varias secciones de este tipo. Además, se pueden anidar. Todas las diferencias posibles entre aquí y allá son alcanzables.
Un ejemplo es un editor de contenido que elige una <onlyinclude>sección y luego <noinclude>la elimina; pero luego elige otra <onlyinclude>sección más para agregarla allí ; pero nada de esto afecta de ninguna manera su artículo.
Otro ejemplo es el programador de plantillas, que realizará <includeonly>la sección de código y <noinclude>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 señaló anteriormente, si solo se va a transcluir una sección de un documento, esto se puede hacer simplemente rodeando la sección de interés con <onlyinclude> … </onlyinclude>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 una sección diferente de la misma página, se requiere una forma de:
Esta sección describe cómo lograr esto. Hay tres formas de hacer esto: (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 {{#section-h:PAGENAME|SECTIONNAME}}, 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 estándar y omnipresentes basados en titulares que se utilizan en toda Wikipedia. Para transcluir el encabezado de un artículo con este método, se puede utilizar {{#section-h:PAGENAME}}. 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.
Este método de transclusión selectiva a menudo agrega un salto de línea encima y/o debajo de la transclusión de la sección, dependiendo del marcado del documento de origen y de destino; Para evitar este problema, ajuste la plantilla de transclusión selectiva en una plantilla. {{trim}}En otras palabras, utilice las siguientes modificaciones al código de transclusión enumerado inmediatamente arriba:
{{trim|{{#section-h:PAGENAME|SECTIONNAME}}}}{{trim|{{#section-h:PAGENAME}}}}Con el fin de indicar dónde se encuentra el contenido del artículo transcluido selectivamente, es útil incluir una nota de sombrero 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 se necesita ninguna nota de este tipo en la sección que se está transcluyendo , ya que el otro lugar donde podría aparecer el contenido no es de interés inmediato para el lector. Sin embargo, una nota de comentario HTML entre el título y el contenido transcluido probablemente sea pertinente para que los editores sean conscientes 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:Extensión:Transclusión de secciones etiquetadas, que están habilitadas en todos los wikis de Wikimedia, para transcluir contenido de forma selectiva. Consulte Ayuda: Transclusión de secciones etiquetadas 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 transcluir el texto), inmediatamente antes de la primera línea de cada sección a transcluir, sustituyendo NOMBRE DE LA SECCIÓN (dos veces) con 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 transclibles 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" del cual se transcluirá el texto y SECTIONNAME por el nombre de la sección que desea transcluir. quiero transcluir:
{{PAGENAME|transcludesection=SECTIONNAME}}Por lo tanto, cada sección encerrada entre <onlyinclude> … </onlyinclude> etiquetas siempre se representará cuando el transcludesectionparámetro no esté configurado (cuando el documento se vea normalmente o cuando el documento se transcluya sin configurar el transcludesectionparámetro como se muestra a continuación) y se representará mediante transclusión en cualquier página que lo haga. establecido transcludesectionen el nombre de la sección. No se representará mediante una transclusión que utilice el transcludesectionparámetro pero lo establezca en otro valor que no sea el nombre de la sección.
Además, al proporcionar PAGENAME, sin proporcionar un Namespace , el wiki asumirá que PAGENAME pertenece al Template Namespace . Para transcluir de un artículo de Mainspace , utilice :PAGENAME.
{{:PAGENAME|transcludesection=SECTIONNAME}}Si queremos que las secciones "Criterios principales" y "Nombre común" de WP:TITLE sean transclibles de forma independiente, editamos la página WP:TITLE y adjuntamos la sección "Criterios principales" de la siguiente manera:
<onlyinclude> {{ # ifeq : {{{ transcludesection | criterios principales }}} | criterios principales | ... '' ( texto de la sección "Criterios principales" ) '' ... }} </onlyinclude>De manera similar, adjuntamos la sección "Nombre común" con:
<onlyinclude> {{ # ifeq : {{{ transcludesection | nombre común }}} | nombre común | ... '' ( texto de la sección "Nombre común" ) '' ... }} </onlyinclude>Luego, para transcluir la sección "Criterios principales" a otra página, insertamos en esa página:
{{WP:TITLE|transcludesection=principalcriteria}}Para transcluir 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 transcluir dos o más secciones de esta manera al incluir varias líneas de este tipo.
No hay límite en la cantidad de secciones seleccionables para la transclusión que puede tener un documento. El único requisito es que a cada uno transcludesectionse le asigne un valor que sea único dentro de esa página.
Según MOS:LEAD#Format 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; A menudo, esto no es deseable para una transclusión de una sección del artículo principal. Además, el artículo principal suele tener un enlace wiki al principio de un subartículo; cuando se transcluye al artículo principal, este enlace wiki aparecerá en negrita. El marcado de wikitexto que se enumera a continuación se puede utilizar para abordar ambos problemas.
Para garantizar que el título del artículo esté en negrita en la primera oración del subartículo, pero sin negrita y con enlace wiki en la transclusión del artículo principal, realice el siguiente reemplazo en la primera oración principal del subartículo:
SUB-ARTICLE_PAGENAME<noinclude>'''</noinclude>{{No selflink|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 esté vinculado 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}}Como muchas tecnologías de software, la transclusión presenta una serie de inconvenientes. El más obvio es el costo en términos de mayores recursos de máquina necesarios; Para mitigar esto hasta cierto punto, el software impone límites de plantilla para reducir la complejidad de las páginas. Algunos inconvenientes adicionales se enumeran a continuación.
<noinclude>y marcado <includeonly>en <onlyinclude>la página transcluida para tener contenido selectivo ; eso requeriría monitorear que el margen se mantenga.Algunas páginas de Special:Specialpages se pueden transcluir, como Special:Allpages , Special:Prefixindex , Special:Newfiles , Special:Newpages , Special:Recentchanges y Special:Recentchangeslinked . Muestras:
{{Special:Allpages/General}}– una lista de páginas que comienzan en "General".{{Special:Prefixindex/General}}– una lista de páginas con el prefijo "General".{{Special:Newfiles/4}}– una galería de los cuatro archivos subidos 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".Intentar transcluir {{Special:Categories}}no dará como resultado una lista real de categorías, pero {{Special:Prefixindex/Category:}}puede usarse para este propósito.
Excepto Special:Recentchangeslinked, la barra diagonal y la palabra o número después de la barra diagonal se pueden omitir, lo que proporciona una lista de páginas sin un punto de inicio específico o una lista de 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: Transcluir ciertas páginas especiales (como Special:Newpages ) puede cambiar el título mostrado de la página.
