Una página puede y debe dividirse en secciones , utilizando la sintaxis de encabezado de sección. Para cada página con al menos cuatro encabezados de sección, se genera automáticamente una tabla de contenido (TOC). Esta página explica la sintaxis de estos elementos. Para obtener información sobre cómo nombrar secciones o cómo usar secciones para estructurar artículos, lea la Guía de diseño .
Las secciones se crean creando sus encabezados, como se muestra a continuación.
== Sección == === Subsección === ==== Sub-subsección ====
A veces se les llama "niveles" según la cantidad de signos iguales antes y después, de modo que la "Sección" superior con dos signos iguales es un encabezado de "nivel dos", la subsección es un encabezado de "nivel tres" y la "sub-subsección" es un encabezado de "nivel cuatro".
No utilice un encabezado de "nivel uno" (solo un signo igual en cada lado, es decir: =Encabezado= ). Esto generaría un encabezado de sección tan grande como el título de la página en la parte superior de la página. El número máximo de niveles es seis.
Los títulos de las secciones (incluidas las subsecciones) deben ser únicos en cada página. El uso del mismo título más de una vez en una página causa problemas:
Las secciones están numeradas en la tabla de contenidos (no aplica en Vector 2022 ).
Para el orden de las secciones (apéndice y pie de página), consulte: Wikipedia:Manual de estilo/diseño § Orden de los elementos del artículo .
La jerarquía de secciones y subsecciones en el wikitexto está determinada principalmente por el nivel de los encabezados, por lo que cualquier texto sin un nuevo encabezado se considera automáticamente parte de la sección o subsección anterior. Esto significa que no hay una manera directa de indicar que el texto final pertenece a la sección principal. Si hacer esta distinción es importante, reordenar el texto o simplemente agregar otra subsección son enfoques comunes.
Para cada página con al menos cuatro encabezados, se genera automáticamente una tabla de contenidos (TOC) a partir de los encabezados de sección, a menos que se agregue la palabra mágica __NOTOC__
(con dos guiones bajos a cada lado de la palabra) al wikitexto del artículo . no__NOTOC__
debe usarse en artículos que (a) tengan menos de cuatro encabezados o (b) no quepan en una pantalla. [1]
El uso de ciertas plantillas, como {{ Compact ToC }} , reemplazará la funcionalidad de la tabla de contenido normal.
Cuando se coloca __FORCETOC__
o __TOC__
(con dos guiones bajos a cada lado de la palabra) en el wikitexto, se genera una tabla de contenidos incluso si la página tiene menos de cuatro encabezados.
Al usar, __FORCETOC__
la tabla de contenidos se coloca inmediatamente antes del encabezado de la primera sección. Al usar, __TOC__
la tabla de contenidos se coloca en la misma posición que este código.
La mayoría de los artículos tienen un texto introductorio antes de la tabla de contenidos, conocido como "sección principal". Aunque normalmente el encabezado de la sección debe seguir inmediatamente a la tabla de contenidos, el uso de este __TOC__
puede evitar que te veas obligado a insertar un encabezado sin sentido solo para colocar la tabla de contenidos correctamente (es decir, no demasiado abajo). Sin embargo, si hay algún texto entre la tabla de contenidos y el primer encabezado, esto causará problemas de accesibilidad.
En algunos casos, la tabla de contenidos puede flotar hacia la derecha o hacia la izquierda utilizando o cuando sea beneficioso para el diseño del artículo o cuando la tabla de contenidos predeterminada interfiera con otros elementos. Antes de cambiar la tabla de contenidos predeterminada a una tabla flotante, tenga en cuenta las siguientes pautas:{{TOC right}}
{{TOC left}}
{{TOC limit}}
A principios de julio de 2005 se propuso eliminar la plantilla:TOC right , pero no hubo consenso al respecto. El archivo de la discusión y la votación al respecto se puede consultar en Wikipedia:Plantillas para eliminar/TOCright . La discusión sobre el Manual de estilo se puede encontrar aquí .
Una circunstancia atenuante puede requerir que el ancho de una tabla de contenidos se ajuste como porcentaje de una página. Por ejemplo:{{TOC left|width=30%}}
De forma predeterminada, la tabla de contenidos incluye todos los encabezados de la página, independientemente de su nivel. Cuando una página de artículo o proyecto tiene una gran cantidad de subsecciones, puede ser adecuado ocultar las subsecciones de nivel inferior de la tabla de contenidos. Puede especificar un límite para la sección de nivel más bajo que se debe mostrar utilizando , donde es el número de signos que se utilizan en cada lado del encabezado de la sección de nivel más bajo que se debe mostrar (por ejemplo, para mostrar todos los encabezados hasta pero ocultar todos los encabezados debajo de ese). El parámetro también se puede dar a o de la misma manera.{{TOC limit|n}}
n
=
3
===sub-sections===
====sub-sub-sections====
limit=n
{{TOC left}}
{{TOC right}}
La tabla de contenidos generada automáticamente no es la más apropiada o útil en todos los tipos de artículos, como artículos de listas largas y glosarios , por lo que existen numerosas plantillas de reemplazo . Para usar una, coloque la plantilla de tabla de contenidos de reemplazo, como (que se puede personalizar para muchos estilos de lista) donde sea necesario. Se recomienda colocarla en la parte superior del artículo para garantizar una funcionalidad correcta, pero en muchos casos la tabla de contenidos normal se suprimirá simplemente con la adición de la plantilla de tabla de contenidos de reemplazo.{{Compact TOC}}
__NOTOC__
La plantilla {{ Horizontal TOC }} presenta la tabla de contenidos en una lista horizontal en lugar de vertical. Puede resultar práctica en una tabla de contenidos con muchas entradas breves. La capacidad de mostrar una tabla de contenidos larga sin necesidad de desplazarse la hace adecuada para tablas en las que las filas contienen encabezados de sección.
En el código HTML de cada sección hay un atributo "id" que contiene el título de la sección. Esto permite vincular directamente a las secciones. MediaWiki utiliza automáticamente estos anclajes de sección cuando genera una tabla de contenidos para la página y, por lo tanto, cuando se hace clic en el encabezado de una sección en la tabla de contenidos, se saltará a la sección. Además, los anclajes de sección se pueden vincular manualmente directamente a una sección dentro de una página.
El código HTML generado al comienzo de esta sección, por ejemplo, es:
< span class = "mw-headline" id = "Section_linking" > Enlace de sección </ span >
Un enlace a esta sección (Enlace de sección) se ve así:
[[Help:Section#Section linking|Section linking]]
(NB: los enlaces de sección distinguen entre mayúsculas y minúsculas, incluido el primer carácter ( Ayuda:Enlace ).)
Para vincular a una sección en la misma página puedes utilizar [[#section name|displayed text]]
, y para vincular a una sección en otra página [[page name#section name|displayed text]]
.
Los anclajes no tienen en cuenta la profundidad de la sección; un enlace a una subsección o sub-subsección, etc. será [[#subsection name]]
y [[#sub-subsection name]]
etc.
Se añaden un guión bajo y un número a los nombres de secciones duplicadas. Por ejemplo, para tres secciones llamadas "Ejemplo", los nombres (para el enlace de secciones) serán "Ejemplo", "Ejemplo_2" y "Ejemplo_3". Sin embargo, después de editar la sección "Ejemplo_2" o "Ejemplo_3" (ver a continuación), uno, de manera confusa, llega a la sección "Ejemplo" desde el resumen de edición .
Si una sección tiene un espacio en blanco como encabezado, se genera un vínculo en la tabla de contenidos que no funciona. Para ver un efecto similar, consulte NS:0 .
Para crear un destino de ancla sin un encabezado de sección, puede utilizar la plantilla {{ anchor }} o un span: <span id="anchor_name"></span>
.
Para formatear un enlace a una sección con un signo de sección ("§") en lugar de "#" o texto personalizado, utilice {{ Section link }} (o {{ slink }} ). Por ejemplo, es equivalente a un enlace Foo#Bar , pero tiene el formato Foo § Bar .{{Section link|Foo|Bar}}
Notas:
[[#section| ]]
-> [[page#section| ]]
-> [[namespace:page#section| ]]
-> Para vincular a una posición arbitraria en una página, consulte la sección Enlaces (anclajes) .
Un enlace que especifica una sección de una página de redirección corresponde a un enlace a esa sección del destino de la redirección.
Una redirección a una sección de una página también funcionará, pruebe por ejemplo la página de redirección Enlaces de sección y redirecciones .
Una complicación es que, a diferencia de cambiar el nombre de una página, cambiar el nombre de una sección no crea ninguna redirección desde el nombre de la sección anterior. Por lo tanto, los enlaces entrantes al nombre de la sección anterior deberán corregirse. Este problema se puede solucionar agregando un enlace de ancla manual al nombre anterior, utilizando la plantilla de ancla .
Sin embargo, si no desea conservar los enlaces a los nombres antiguos, deberá buscarlos y corregirlos. No existe una función separada de Qué enlaces aquí para las secciones: la lista no distingue entre enlaces a una sección u otra y enlaces a la página completa. Las siguientes posibles soluciones alternativas ayudarán a "proteger en el futuro" los enlaces entrantes que haga a una sección, pero no ayudarán a rastrear enlaces simples a secciones durante un cambio de nombre:
Las páginas de redireccionamiento se pueden categorizar añadiendo una etiqueta category después del comando redirect. En el caso de que el objetivo del redireccionamiento sea una sección, esto tiene hasta cierto punto el efecto de categorizar la sección: a través del redireccionamiento, la página de categoría enlaza a la sección; sin embargo, a menos que se ponga un enlace explícito, la sección no enlaza a la categoría. En la página de categoría, los redireccionamientos se muestran con la clase redirect-in-category, por lo que se pueden mostrar, por ejemplo, en cursiva; esto se puede definir en MediaWiki:Common.css . Véase también WP:Categorizing redirects .
Las secciones se pueden editar por separado haciendo clic en los enlaces de edición especiales etiquetados "[editar]" junto al encabezado, o haciendo clic derecho en el encabezado de la sección.
Para insertar una sección, se puede editar la sección anterior o posterior. Un editor puede fusionar una sección con la sección anterior eliminando el encabezado.
La navegación en páginas desde los espacios de nombres "discusión" proporciona un enlace especial etiquetado como "Nueva sección", "+" o "Agregar tema" que se utiliza para crear una nueva sección al final de la página. [2] El enlace se puede eliminar de una página con la palabra mágica __NONEWSECTIONLINK__
o agregar con __NEWSECTIONLINK__
.
La URL para tal acción se ve así:
https://en.wikipedia.org/w/index.php?title=Wikipedia:Sandbox&action=edit§ion=new.
En este caso, aparecerá un cuadro de texto con el título "Asunto:", y el contenido que escriba en él se convertirá en el nombre del nuevo encabezado de sección. No hay ningún cuadro de entrada para el resumen de la edición ; se crea automáticamente.
De forma predeterminada, no hay ningún enlace para editar la sección principal de una página, por lo que se debe editar toda la página. La edición de la sección principal se puede habilitar a través de Preferencias → Gadgets → Apariencia → Agregar un enlace [editar] para la sección principal de una página . También puede hacer clic en "[editar]" en otra sección y cambiar manualmente la URL a . section=n
section=0
Los enlaces de edición de secciones se pueden eliminar, por ejemplo en los archivos, con la palabra mágica __NOEDITSECTION__
. Algunas plantillas la agregan automáticamente.
La vista previa en la edición de una sección no siempre muestra lo mismo que la parte correspondiente de la página completa, por ejemplo, si en la página completa una imagen de la sección anterior invade la sección en cuestión. Además, los <ref> suelen quedar ocultos; consulte #Edición de una nota al pie para obtener una solución.
La página de edición muestra la lista de plantillas utilizadas en toda la página, es decir, también las plantillas utilizadas en otras secciones.
Las subsecciones se incluyen en la parte de la sección que se está editando. La numeración de las secciones es relativa a la parte que se está editando, por lo que en el nivel superior relativo siempre aparece solo el número 1; todas las subsecciones relativas tienen números que comienzan con 1: 1.1., 1.2, etc.; por ejemplo, al editar la subsección 3.2, la subsección 3.2.4 se numera como 1.4. Sin embargo, el formato del encabezado es según el nivel absoluto.
Para editar una nota al pie presentada en una sección que contiene el código <references />, edite la sección con la marca de nota al pie que hace referencia a ella (consulte Ayuda:Notas al pie). Al obtener una vista previa de la sección, se mostrará una vista previa de la nota al pie.
Al incluir condicionalmente (usando una función de analizador ) una plantilla con secciones, los enlaces de "edición" de esta sección y las subsiguientes editarán la sección incorrecta o darán el mensaje de error de que la sección no existe (aunque la página (incluyendo la tabla de contenidos) se muestra correctamente y la tabla de contenidos se vincula correctamente). Esto se debe a que para los objetivos de los enlaces de "edición", el contenido de las plantillas incluidas condicionalmente se considera parte de la página en sí, y las secciones se cuentan después de la expansión.
De este modo, los enlaces de "edición" de las secciones de la plantilla incluida enlazan a la página misma en lugar de a la plantilla, y los enlaces de "edición" después de la plantilla incluida enlazan a la página correcta pero al número de sección incorrecto.
De manera más general, las secciones condicionales plantean tal complicación.
El problema no ocurre cuando se transcluye una plantilla con un nombre condicional (que tiene más ventajas). Utilice m:Template:void (backlinks edit) para que la plantilla que se va a transcluir no produzca nada.
Las funciones de edición también se pueden aplicar a una sección de una plantilla incluida. Esta sección, Ayuda: Edición de secciones de plantillas incluidas , es un ejemplo.
Para la edición de secciones, la extensión de una sección se rige por los encabezados de la página que la llama. Puede constar de una parte antes de la etiqueta de plantilla, la etiqueta de plantilla y una parte después de la etiqueta de plantilla, incluso si la plantilla tiene secciones.
Puede resultar confuso si la extensión de las secciones según el sistema es diferente a la que sugiere la página renderizada. Para evitarlo:
Puede resultar conveniente, cuando sea conveniente, comenzar una plantilla con un encabezado de sección, incluso si normalmente el contenido de la plantilla no necesitaría una división en secciones y, por lo tanto, la plantilla es solo una sección. Las funciones de edición para editar secciones se pueden utilizar para editar la plantilla desde una página que la incluya, sin colocar específicamente un enlace de edición. Esta plantilla es un ejemplo; no necesita una división en secciones, pero tiene un encabezado en la parte superior.
Una desventaja de esta solución es que no se puede cambiar el nivel de sección en la página que incluye la plantilla. Esto significa que el nivel de sección que se utiliza en la plantilla será el mismo que se muestra en todas las páginas donde se incluye la plantilla, a pesar de que esto podría entrar en conflicto con la jerarquía deseada en las diferentes páginas.
Tenga en cuenta que un valor de parámetro que aparece en una plantilla, por ejemplo "{{{1}}}", si queremos conservar el parámetro, no se edita editando la plantilla sino editando la llamada a la plantilla, aunque la página renderizada y sus enlaces de edición no lo muestren automáticamente. Puede resultar útil incluir algún texto explicativo o un enlace de edición adicional. En este caso, para editar "{{{1}}}", tenemos que editar la etiqueta de plantilla en la página que llama a la plantilla. Si utilizamos la edición de secciones, el enlace de edición de secciones relevante es el que aparece en el encabezado antes del encabezado en la propia plantilla.
La etiqueta __NOEDITSECTION__ en cualquier plantilla afecta tanto a esa plantilla, como a las páginas en las que está incluida y a cualquier otra plantilla incluida en la misma página.
{{ fake header }} se puede usar en plantillas y páginas de ayuda donde se desea que aparezca un encabezado sin que se muestre en la tabla de contenido y sin un enlace de edición.
Ventajas de las páginas separadas:
Ventajas de una página combinada con secciones:
Una alternativa es componer una página a partir de otras páginas utilizando la función de plantilla (creando un documento compuesto por transclusión ). Esto permite una búsqueda sencilla dentro de la página renderizada combinada, pero no en el wikitexto combinado. Como desventaja, se debe proporcionar un título para cada página. Para el límite de tamaño de inclusión de pre-expandido, esto es desventajoso incluso en comparación con una página grande: el tamaño de inclusión de pre-expandido es la suma de los tamaños de inclusión de pre-expandido de los componentes más la suma de los tamaños de los wikitextos de los componentes.
La transclusión de secciones estilo plantilla (TST) es un método más antiguo de transclusión de secciones.
Marque secciones en el texto usando este marcado:
< onlyinclude >{{ #ifeq :{{{ transcludesection |}}}| capítulo1 |contenido} } </soloincluye>
Después de etiquetar la sección (o subsección) correspondiente, puede utilizar una llamada de plantilla para transcluir la sección. Por ejemplo, para transcluir una sección llamada chapter1
desde una página llamada pageX
:
{{:pageX|transcludesection=capitulo1}}
La página de destino define la ubicación de la sección.
Esta sección está vinculada desde #Enlace de sección.
Manual de estilo
__NOTOC__
. Para la visualización de artículos en una PC, si un artículo cabe en una pantalla depende del tamaño de la pantalla y de la configuración de visualización.