Esta plantilla se utiliza para reutilizar partes de páginas en otras páginas. Esta práctica tiene varias ventajas y desventajas.
Esta plantilla amplía las capacidades de la transclusión normal integrada y la transclusión de sección etiquetada .
{{Excerpt|Page title}}
– Transcluir la sección principal ( ejemplo ){{Excerpt|Page title|Section title}}
– Transcluir una sección específica, excluyendo cualquier subsecciones ( ejemplo )Hay un parámetro obligatorio y numerosos opcionales para configurar el extracto:
Identificación de fuente
|1=
– Nombre del artículo o página a transcluir. Requerido. Alias: |article=
o |page=
.|2=
– Nombre de la sección o etiqueta a transcluir. Opcional; si se omite, transcluye la sección principal (contenido encima del encabezado de la primera sección). Alias: |section=
o |fragment=
.Configuración de transclusión
El contenido transcluible se define como uno de varios tipos de elementos : file
, list
, paragraph
, reference
, subsection
, table
o template
. Los parámetros de configuración especifican qué tipo de elemento transcluir y, en algunos casos, cuántos y qué elementos de ese tipo transcluir. Todos los parámetros de configuración son opcionales; si se omite, todos los elementos de todos los tipos de elementos se transcluyen de la página de origen identificada por los dos parámetros sin nombre. Algunos tipos de elementos admiten la transclusión condicional de elementos especificando un rango de números de elementos (1-3) o una serie de comas (1, 2, 5); estos tipos incluyen: archivos, listas, párrafos y tablas.
Hay diez parámetros de configuración de transclusión opcionales:
|only=
– Tipos de elementos a transcluir. Valores: file(s)
, list(s)
, table(s)
, template(s)
, paragraph(s)
. Predeterminado: todos los tipos de elementos.|files=
– Archivos para transcluir. Valor predeterminado: todos los archivos. Misma sintaxis básica que |paragraphs=
, pero consulte § Detalles.|onlyfreefiles=no
– Permite la transclusión de archivos que no son libres . Predeterminado: excluir contenido que no sea gratuito.|links=no
– Desvincular todos los enlaces wiki y representarlos como texto sin formato.|lists=
– Listas ( con viñetas , numeradas ) para transcluir. Predeterminado: todas las listas. Misma sintaxis que para |paragraphs=
.|paragraphs=
– Párrafos a transcluir. Valor predeterminado: todos los párrafos.|references=no
– Excluir todas las referencias entre <ref>...</ref>
etiquetas.|subsections=yes
– Incluir subsecciones de la sección transcluida. Predeterminado: solo el contenido encima del encabezado de la primera subsección.|tables=
– Tablas para transcluir. Valor predeterminado: todas las tablas. Misma sintaxis básica que |paragraphs=
, pero consulte § Detalles.|templates=
– Plantillas para transcluir. De forma predeterminada, todas las plantillas se transcluyen, excepto aquellas incluidas en la lista negra en Module:Excerpt/config . Consulte § Detalles para saber cómo especificar una plantilla o plantillas específicas para su inclusión o exclusión.Estilo y características adicionales
Estos parámetros opcionales alteran la forma en que se muestran los elementos transcluidos:
|bold=yes
– Conservar el texto en negrita .|briefdates=yes
– Abreviar la información de nacimiento y defunción al formato (AAAA-AAAA)|displaytitle=
– Cambiar el texto del enlace en la hatnote. Por ejemplo, agregue cursiva , subíndices, etc.|hat=no
– Ocultar la nota de sombrero "Esta sección es un extracto de..."|inline=yes
– Elimine la nota de sombrero y <div>
las etiquetas alrededor del extracto, para usarlo dentro de otro texto o para agregar referencias u otro contenido después sin saltos de párrafo entre ellos.|quote=yes
– Envuelva el extracto con <blockquote>
etiquetas.|this=
– Cambiar el texto inicial de la hatnote. Por ejemplo, si el contenido transcluido es una galería, puede configurarlo |this=This gallery is
para que la nota de sombrero diga "Esta galería es un extracto de..."|1=
o |article=
o|page=
|files=0
esté configurado). Además, las plantillas enumeradas en Módulo:Excerpt/config no se transcluirán (a menos que se solicite explícitamente con |templates=
, ver más abajo).|2=
o |section=
o|fragment=
<section>
etiqueta a transcluir ( ejemplo ). En el caso de una etiqueta de sección, la sección debe estar marcada con <section begin="Name of the fragment" />
y <section end="Name of the fragment" />
en la página que se va a transcluir. Tenga en cuenta que esta plantilla proporciona otras formas de apuntar a fragmentos específicos de una página sin tener que recurrir a etiquetas de sección.|only=
|only=
es un parámetro excluyente y excluye todos los demás tipos de elementos, excepto el que nombre, de modo que, por ejemplo, al especificar |only=paragraphs
se excluyen todas las listas, tablas, plantillas, etc. Los valores de parámetros pueden estar en singular (p. ej., |only=paragraph
) o plural (p. ej., |only=paragraphs
) y significar cosas diferentes: en singular, solo se transcluye el primer elemento de ese tipo de elemento; en plural, todos los elementos lo son.|only=file
– Transcluir solo el primer archivo (pero no listas, párrafos, tablas, etc.)|only=files
– Transcluir todos los archivos (pero nada más)|only=list
– Transcluir solo la primera lista, excluir todos los demás tipos de elementos|only=lists
– Transcluir todas las listas (pero nada más)|only=table
– Transcluir solo la primera tabla, excluir todos los demás tipos de elementos|only=tables
– Transcluir todas las tablas (pero nada más) ( ejemplo )|only=template
– Transcluir solo la primera plantilla (excluyendo las plantillas incluidas en la lista negra en Module:Excerpt/config , así como todos los demás tipos de elementos)|only=templates
– Transcluir todas las plantillas (excluidas las plantillas incluidas en la lista negra), (pero nada más)|only=paragraph
– Transcluir solo el primer párrafo, excluir todos los demás tipos de elementos.|only=paragraphs
– Transcluir todos los párrafos (pero nada más)|files=
|files=A.jpg
– Transcluir el archivo llamado 'A.jpg'|files=A.jpg, B.png, C.gif
– Transcluir los archivos llamados 'A.jpg', 'B.png' y 'C.gif'|files=.+%.png
– Transcluir todos los archivos PNG|files=-A.jpg
– Transcluir todos los archivos excepto el llamado 'A.jpg'|files=-A.jpg, B.png, C.gif
– Transcluir todos los archivos excepto los llamados 'A.jpg', 'B.png' y 'C.gif'|files=-.+%.png
– Transcluir todos los archivos que no sean PNG|paragraphs=
|paragraphs=0
– No transcluir párrafos|paragraphs=1
– Transcluir el primer párrafo.|paragraphs=2
– Transcluir el segundo párrafo.|paragraphs=1,3
– Transcluir los párrafos primero y tercero.|paragraphs=1-3
– Transcluir los párrafos primero, segundo y tercero.|paragraphs=1-3,5
– Transcluir los párrafos primero, segundo, tercero y quinto.|paragraphs=-1
– Transcluir todos los párrafos excepto el primero.|paragraphs=-2
– Transcluir todos los párrafos excepto el segundo.|paragraphs=-1,3
– Transcluir todos los párrafos excepto el primero y el tercero.|paragraphs=-1-3
– Transcluir todos los párrafos excepto el primero, segundo y tercero.|paragraphs=-1-3,5
– Transcluir todos los párrafos excepto el primero, segundo, tercero y quinto.|subsections=yes
|tables=
|tables=Stats2020
– Transcluir la tabla con id 'Stats2020'|tables=Stats2020, Stats2019, Stats2018
– Transcluir las tablas con los identificadores 'Stats2020', 'Stats2019' y 'Stats2018'|tables=-Stats2020
– Transcluir todas las tablas excepto la que tiene el ID 'Stats2020'|tables=-Stats2020, Stats2019, Stats2018
– Transcluir todas las tablas excepto las que tienen los identificadores 'Stats2020', 'Stats2019' y 'Stats2018'.|templates=
|templates=-Ocean
– Añade la plantilla 'Océano' a la lista negra|templates=-Ocean, Nature
– Añade las plantillas 'Océano' y 'Naturaleza' a la lista negra|templates=Infobox person
– Ignorar la lista negra y transcluir la plantilla 'Persona del cuadro de información'|templates=Infobox person, Ocean
– Ignore la lista negra y transcluya las plantillas 'Persona del cuadro de información' y 'Océano'|templates=.*
– Ignorar la lista negra y transcluir todas las plantillas.Para casos simples de transclusión de secciones de artículos, {{ #section }}, {{ #section-x }} y {{ #section-h }} (abreviados {{ #lst }}, {{ #lstx }} y {{ #lsth }})) se pueden utilizar funciones de analizador en lugar de esta plantilla. {{ #lsth : artículo | fragmentname }} transcluirá la sección de " artículo " con el encabezado " fragmentname " y {{ #lsth : artículo }} transcluirá la sección principal de " artículo ". Solo se pueden extraer párrafos específicos marcando el artículo fuente con etiquetas y usando {{ #lst : artículo | fragmentname }} para transcluir esos fragmentos, lo que equivale a usar el parámetro con esta plantilla. {{ #lsth : artículo | fragmentname }} también se puede utilizar para transcluir todo menos esos fragmentos.<section begin=fragmentname/>...<section end=fragmentname/>
|fragment=fragmentname
No se eliminará el exceso de espacios en blanco del texto, no habrá un encabezado (equivalente a |hat=no
y se incluirán todos los archivos, plantillas, tablas, referencias y subsecciones a menos que el artículo fuente esté marcado con etiquetas , o . Autoenlaces aparecerá en negrita.<section begin=fragmentname/>...<section end=fragmentname/>
<noinclude>...</noinclude>
<onlyinclude>...</onlyinclude>
Puede suceder que la fuente que desea extraer contenga notas a pie de página en un estilo de cita diferente al de su artículo, y extraer la fuente provocaría una discrepancia en el estilo de la cita, lo cual es contrario a las pautas sobre cita de fuentes . A veces, aún se puede utilizar el extracto, evitando al mismo tiempo una discrepancia en el estilo, mediante el uso de parámetros |references=no
y |inline=yes
.
Si la fuente que desea extraer tiene varias etiquetas de referencia intercaladas a lo largo de la fuente y deben mostrarse exactamente en esas ubicaciones para mantener una verificabilidad total , entonces esta fuente podría no ser una buena candidata para la transclusión mediante {{ extracto } } plantilla, y copiar el contenido de la fuente al artículo podría ser una mejor opción.
Sin embargo, si la página fuente que desea extraer tiene:
entonces puedes hacerlo. Para implementar esto, use parámetros |references=no
para eliminar las etiquetas de referencia del contenido transcluido y |inline=yes
definir el extracto como un elemento de visualización en línea para § Suprimir saltos de línea entre párrafos y luego agregar manualmente una copia de todas las referencias en la fuente. inmediatamente después de la etiqueta del extracto que termina entre llaves en el artículo de destino, sin saltos de línea intermedios, espacios en blanco u otros caracteres entre la etiqueta y las referencias adjuntas. Las referencias copiadas deberán convertirse manualmente de un estilo de nota al pie breve a un estilo de cita en línea completo , o viceversa, para que coincida con el estilo de cita del destino.
Cuando un artículo muy general utiliza extractos de artículos más específicos, que a su vez utilizan extractos de artículos aún más específicos, surge una estructura de árbol , denominada "árbol de extractos".
Aquí puede navegar por los principales árboles de extractos de la Wikipedia en inglés. Es útil para editores interesados en ampliarlos o mejorarlos. Para navegar por los árboles, haga clic en el siguiente botón (S) :
A veces, un pasaje casi encaja en una transclusión, pero no del todo. En estos casos, puede editar la página de origen para agregar <noinclude>...</noinclude>
etiquetas alrededor del contenido que no desea en el extracto y <includeonly>...</includeonly>
etiquetas alrededor del contenido que desea solo en el extracto.
Por ejemplo, la página sobre información errónea sobre el COVID-19 comienza con "La pandemia de COVID-19 ha generado desinformación ...". Sin embargo, al extraer esta guía a la sección de desinformación de la pandemia de COVID-19 , no necesitamos especificar a qué pandemia nos estamos refiriendo. Por lo tanto, el código The <noinclude>[[COVID-19 pandemic]]</noinclude><includeonly>pandemic</includeonly> has resulted in [[misinformation]]
se puede utilizar en la página de desinformación, de modo que aparecerá en la página de pandemia como "La pandemia ha provocado desinformación ...".
Para páginas con un gran volumen de ediciones, puede ser una buena idea dejar un comentario oculto que explique por qué están ahí las etiquetas, para que nadie se sienta tentado a eliminarlas, como este:The <noinclude>[[COVID-19 pandemic]]</noinclude><!--These tags are used to refine the excerpt at [[COVID-19 pandemic]]--><includeonly>pandemic</includeonly> has resulted in [[misinformation]]
Tenga en cuenta que cuando la </noinclude>
etiqueta se ajusta a una nueva línea, un carácter al lado se interpretará como el comienzo de una línea. Esto puede provocar algunos problemas de formato. Por ejemplo, cuando </noinclude>
al comienzo de una línea le sigue un carácter de espacio en blanco , el motor de la página lo traduciría como un espacio inicial que representa el párrafo siguiente en bloque de código y fuente monoespaciada con formato preservado. Por este motivo, ningún espacio debe separar la </noinclude>
etiqueta del texto que la precede.
Una sección suele ser un resumen de un artículo principal de una página más detallada sobre un subtema ubicado en una página secundaria ; estos generalmente están vinculados con Plantilla: Principal en el padre. A veces es conveniente reemplazar el contenido de dicha sección de resumen en la página principal con un extracto del encabezado de la página secundaria (después de fusionar cualquier contenido valioso de la sección en la página secundaria). En tales casos, una forma eficaz de proceder es:
Si desea fusionar dos párrafos extraídos de una fuente en uno más largo en su artículo, use dos extractos en lugar de uno y cambie el modo de visualización a en línea . Entonces, por ejemplo, en lugar de esto:
{{excerpt|Ocean color|paragraphs=2-3|file=no}}
// (ejemplo tomado de Ocean#Color )podrías codificar:
{{excerpt|Ocean color|paragraphs=2|file=no|inline=yes}}
{{excerpt|Ocean color|paragraphs=3|file=no|inline=yes}}
y esto eliminará el salto de línea entre los dos párrafos, por lo que se representarán como un solo párrafo.
De forma predeterminada, un {{ extracto }} genera una etiqueta div HTML , que es un elemento de visualización a nivel de bloque , por lo que los extractos contiguos normalmente son elementos de bloque separados con saltos de línea entre ellos. Esto se puede anular mediante el uso de param |inline=yes
, que suprime la etiqueta div y, en su lugar, genera un elemento de visualización en línea . En este caso, al igual que cuando se ejecuta texto en líneas adyacentes de wikicode , no se genera ningún salto de línea entre ellas. Esta técnica también se puede adaptar para cambiar el estilo de las citas o utilizar referencias diferentes.
El uso de {{ Extracto }} tiene las siguientes ventajas:
También tiene las siguientes desventajas:
Los problemas en la plantilla {{ R }} la hacen incompatible con la plantilla {{ excerpt }} . {{ r }} no debe usarse en secciones que serán transcluidas por {{ extracto }} .
Si se detecta un error, aparecerá un mensaje de error en el artículo en lugar del contenido transcluido esperado:
Esta plantilla se utiliza para transcluir parte de un artículo en otro artículo.