La transclusión de sección etiquetada (LST) ofrece dos formas básicas de especificar una "sección" de una página para la transclusión . Una forma utiliza el nombre de la página y un encabezado (título de la sección, como se ve en la página renderizada). La otra forma permite una "sección" arbitraria para la transclusión, pero primero requiere un marcado para agregar la etiqueta .
Tres funciones pueden transcluir una sección de un nombre de página determinado .
Tenga en cuenta que también existen nombres equivalentes para estas funciones, siendo los nombres base #lst
, #lstx
y #lsth
.
Para preparar una "sección" arbitraria para una transclusión de sección etiquetada, márquela con atributos de inicio y fin<section />
dentro de las etiquetas que contienen su etiqueta :
<section begin=label />
y<section end=label />
En comparación con la transclusión LST, el marcado de transclusión parcial no se puede etiquetar y, por lo tanto, la página de origen no puede tener un conjunto de secciones transcluidas a una página y al mismo tiempo tener un conjunto diferente para otra página. Una página marcada solo con etiquetas de transclusión parcial siempre transcluirá la misma. Pero la LST y la transclusión parcial pueden funcionar juntas en la misma página.
Estas funciones LST toman parámetros adicionales, como se explica a continuación. § Las páginas de ejemplo proporcionan enlaces de búsqueda para los artículos que actualmente emplean LST para que pueda ver cómo lo usan.
Esta sección resume las tres funciones del analizador en la extensión Transclusión de sección etiquetada.
Sintaxis: {{ función : nombre de página completa | sección | rango / cambio }}
No es posible pasar parámetros de plantilla a la sección o página transcluida, pero el código de la página puede usar palabras mágicas como {{PAGENAME}}
probar dónde está y comportarse de manera diferente.
<includeonly>
contenido en la página de destino .Comportamiento de las etiquetas LST <section />
:
Opciones de transclusión LST:
Se aplica la sintaxis estándar:
Errores de uso comunes.
No es necesario marcar la página de origen si solo se utilizan títulos de sección para especificar la transclusión. Este es el caso de #section-h.
Para etiquetar una sección para la transclusión LST, utilice el siguiente marcado.
<section />
Marque los límites de su sección en la página de origen utilizando dos etiquetas singulares ; por ejemplo, para etiquetar una sección como "capítulo1":
<section begin=chapter1 />
este es un capitulo<section end=chapter1 />
Tenga en cuenta que esto no es HTML normal de etiqueta de apertura y etiqueta de cierre. En HTML <section>...</section>
no es válido. Esta etiqueta de analizador, <section />
, es incompatible con un elemento HTML porque el marcado de MediaWiki emplea una etiqueta de analizador única, agregada solo para la extensión Transclusión de sección etiquetada.
Utilice la función de analizador #section
para transcluir la sección. Por ejemplo, para transcluir la sección denominada capítulo1 de una página llamada artículoX :
{{#sección:ArtículoX|capítulo1}}
Para transcluir una página, pero excluir una sección específica, utilice la #section-x
función de analizador:
{{#sección-x: nombre de página completa | etiqueta }}
o
{{#sección-x: nombre de página completa | título }}
Opcionalmente, puede agregar texto de reemplazo a la sección excluida.
{{#sección-x: nombre de página completa | etiqueta | texto de reemplazo }}
Ejemplo:
{{ #sección-x : artículoX | capítulo1 | Consulte el capítulo 1 en [[ artículoX ]] . }}
El texto de reemplazo aparecerá en el área donde se omite (excluye) la sección.
De forma predeterminada, #section
incluirá todos los espacios en blanco de la sección, lo que puede generar problemas si intenta transcluir la sección en un artículo diferente. Para resolver esto, aproveche el hecho de que la función del analizador {{#if}} recorta sus entradas, por ejemplo
{{#if:1|{{#sección:ArtículoX|capítulo1}}}}
Esto eliminará los espacios en blanco iniciales y finales, y el artículo se mostrará según lo previsto. Debido a que está anidando plantillas, se duplicará el tamaño de inclusión posterior a la expansión del extracto, lo que puede presentar un problema en páginas más largas, por lo que es posible que desee editar la página de origen para ajustar el contenido que desea incluir, sin los espacios en blanco. en <onlyinclude>...</onlyinclude>
etiquetas en su lugar. También puedes usar la plantilla {{ trim }} en lugar de {{#if:1}}, pero debido a que es solo un envoltorio para la técnica {{#if:1}} anterior, resulta en una triplicación de la publicación. -expandir incluir tamaño.
Es posible tener varias secciones con el mismo nombre; en este caso, se incluirán/excluirán todas las secciones con ese nombre. Esto es especialmente útil para marcar varias discusiones.
Estas funciones pueden transcluir toda la página, por lo que tienen dos argumentos opcionales para especificar comportamientos: 1) una sección etiquetada con nombre o título de encabezado, 2) un rango de etiquetas de sección o títulos de sección con nombre, y 3) reemplazo contenido para una sección con nombre.
{{#section:articleX|chapter1|chapter3}}
incluye todo desde el principio del capítulo 1 hasta el final del capítulo 3. Esto permite usar pares de marcadores vacíos para marcar un final de la sección, posiblemente en una plantilla.{{#section-h:articleX|chapter1|chapter3}}
Incluye contenido del capítulo 1, título y contenido del capítulo 2.{{#section-x:articleX|chapter1|chapter3}}
reemplaza el título y el contenido del capítulo1 con la palabra "capítulo3".En lugar de transcluir cada vez, para "transcluir" una vez (para copiar), utilice la sustitución :
Por ejemplo, para archivar una conversación antigua en su página de discusión, puede copiarla a una página de archivo y luego eliminarla, todo usando LST:
<section begin=archive />
al principio de la sección que deseas archivar y <section end=archive />
al final. (Usamos "archivo" para la etiqueta, pero cualquier etiqueta servirá). Esta sección puede estar en cualquier lugar y puede tener varias secciones.Cuando utilice la sustitución para transcluir contenido en Wikipedia, utilice el resumen de edición para aplicar los derechos y obligaciones de los reutilizadores . Esto se aplica a cualquier contenido sustancial, y no sólo al contenido de los artículos.
Actualmente, ninguna plantilla puede facilitar este marcado LST porque es necesario usar #tag para "preSaveTransform" palabras mágicas dentro de una etiqueta de cualquier tipo. Para el intento adecuado, consulte (el que no funciona) {{ sección }} .
La única forma de evaluar los argumentos de la plantilla dentro de una etiqueta (debido al orden de análisis) es #tag . LST necesitaría una evaluación (plantilla) de la etiqueta a medida que se genera la etiqueta de sección:
{{ #tag : sección | {{{ 1 }}} }}
Pero #tag solo produce etiquetas tipo XML (equilibradas, abiertas-cerradas, de inicio a fin, pares de), mientras que LST usará una etiqueta singular, explícitamente de cierre automático. Por lo tanto, ninguna plantilla puede generar etiquetas LST. Compare la producción real (solo en efecto):
{{#tag:sección| contenido |comenzar= etiqueta }} → < sección comenzar= etiqueta > contenido </ sección>
con la salida solicitada:
<sección comienzo= etiqueta /> contenido <sección fin= etiqueta />
Estas son búsquedas almacenadas en un enlace: