stringtranslate.com

Ayuda:Sección

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 .

Creación y numeración de secciones

  • WP:NUMERACIÓN DE SECCIONES
  • WP:NIVELES DE SECCIÓN

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".

  • WP:SECCIÓN DE NIVEL
  • WP:NIVELMÁXIMO

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:

Numeración

Las secciones están numeradas en la tabla de contenidos (no aplica en Vector 2022 ).

Orden de clasificación

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 .

Secciones finales

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.

Tabla de contenidos (TOC)

  • H:Índice de contenido
  • Tabla de contenidos
Un ejemplo de tabla de contenido tal como se ve en la máscara Vector 2022 predeterminada

Ocultar la tabla de contenidos

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.

Posicionamiento de la tabla de contenidos

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.

Flotando el TOC

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}}

  1. Si la tabla de contenidos es flotante, debe ubicarse al final de la sección principal del texto, antes del encabezado de la primera sección. Los usuarios de lectores de pantalla no esperan que haya texto entre la tabla de contenidos y el primer encabezado, y no tener texto encima de la tabla de contenidos puede resultar confuso. Consulte la última línea en la información sobre los elementos de la sección principal .
  2. Al colocar una tabla de contenido, verifique si el diseño de la página se verá afectado si el usuario oculta la tabla de contenido.
  3. Las listas largas pueden crear índices muy largos. El índice no debe ser más largo de lo necesario, ya sea flotante o no. Se puede utilizar para reducir la longitud del índice ocultando subsecciones anidadas, en lugar de un índice flotante.{{TOC limit}}
  4. La tabla de contenidos predeterminada se coloca antes del primer título, pero después de cualquier texto introductorio. Si el resumen introductorio es lo suficientemente largo como para que un usuario típico tenga que desplazarse hacia abajo para ver la parte superior de la tabla de contenidos, puede colocar la tabla de contenidos flotante para que aparezca más cerca de la parte superior del artículo. Sin embargo, en la mayoría de los casos, la tabla de contenidos flotante debería aparecer al menos después del primer párrafo del texto del artículo.
  5. Si se hace flotante una tabla de contenidos amplia, se obtendrá una columna estrecha de texto legible para usuarios con resoluciones bajas. Si el ancho de la tabla de contenidos supera el 30 % de la pantalla visible del usuario (aproximadamente el doble del tamaño de la barra de navegación de Wikipedia a la izquierda), no es adecuada para que flote. (Los porcentajes suponen una configuración de usuario típica). Si hay texto atrapado entre una tabla de contenidos flotante y una imagen, se puede cancelar la flotación en un punto de texto determinado; consulte Forzar un salto de página .
  6. Si la tabla de contenido se coloca en las proximidades de otras imágenes o cuadros flotantes, puede flotar siempre que la columna de texto fluido no se vuelva más angosta que el 30 % del ancho de pantalla visible del usuario promedio.
  7. Una tabla de contenido flotante a la izquierda puede afectar a listas numeradas o con viñetas.

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í .

Limitar el ancho de la página de la tabla de contenidos

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%}}

Limitar la profundidad del contenido de la tabla de contenidos

  • H:LÍMITE C

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}}

Reemplazar la tabla de contenidos predeterminada

  • WP:REEMPLAZAR

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__

Tabla de contenidos horizontal

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.

Ejemplo: Legalidad del cannabis por país : utiliza una tabla de contenidos horizontal A-Z concisa pero funcional.
Ejemplo: Legalidad del cannabis según la jurisdicción de EE. UU .: utiliza dos TOC: uno corto y vertical, y uno largo y horizontal.

Enlace 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:

Para vincular a una posición arbitraria en una página, consulte la sección Enlaces (anclajes) .

Enlaces y redirecciones de secciones

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 .

Edición de secciones

  • WP:EDITLINK
  • WP:SECCIÓNEDIT

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.

Añadiendo una sección al final

  • Enviado:+

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.

Véase también el enlace en un resumen de edición a una sección , función "Publicar un comentario" .

Edición antes de la primera sección

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=nsection=0

Eliminar enlaces de edición de secciones

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.

Avance

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.

Subsecciones

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.

Editar una nota al pie

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.

Secciones dentro de las funciones del analizador

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.

Edición de secciones de plantillas incluidas

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.

Secciones vs. páginas separadas vs. transclusión

Ventajas de las páginas separadas:

  1. ¿Qué enlaces aparecen aquí?
  2. Historiales de edición separados
  3. Se aplican algunos límites de plantillas por página.
  4. redirección automática al cambiar el nombre
  5. Cargar una página pequeña es más rápido que cargar una página grande, pero ¿es más probable que los lectores quieran utilizar solo una sección o navegar por muchas de las secciones del tema? – Ver las ventajas de las páginas combinadas
  6. se pueden colocar por separado en categorías (sin embargo, consulte también a continuación)
  7. con Semantic MediaWiki : tener anotaciones separadas

Ventajas de una página combinada con secciones:

  1. Cargar una página combinada es más rápido y más conveniente que cargar varias páginas divididas.
  2. La búsqueda dentro de una página grande o su wikitexto con una función de búsqueda local es más rápida y tiene ventajas sobre la búsqueda en varias páginas utilizando el motor de búsqueda del sitio o un motor de búsqueda web.
  3. La tabla de contenidos permite una navegación cómoda.
  4. mayor probabilidad de cohesión editorial de un concepto en comparación con tener varias definiciones que probablemente se editen de forma independiente
  5. Se evita la duplicación de elementos relevantes para cada sección, como plantillas de navegación y cuadros de información.

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.

Sección de transclusión

  • Ayuda:TRANSECCIÓN

Transclusión de sección etiquetada

Sección de transclusión en estilo de plantilla

  • Ayuda:TST

La transclusión de secciones estilo plantilla (TST) es un método más antiguo de transclusión de secciones.

Marcado de secciones

Marque secciones en el texto usando este marcado:

< onlyinclude >{{ #ifeq :{{{ transcludesection |}}}| capítulo1 |contenido} } </soloincluye>

Sección de transclusión

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 chapter1desde una página llamada pageX:

{{:pageX|transcludesection=capitulo1}}

La página de destino define la ubicación de la sección.

Colocación de imágenes

Secciones para demostración arriba

Demostración http://example.com

Esta sección está vinculada desde #Enlace de sección.

Véase también

Manual de estilo

Notas al pie

  1. ^ Las plataformas móviles de pantalla pequeña utilizan un esquema de navegación alternativo, que no se ve afectado por __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.
  2. ^ La apariencia Vector puede ocultar el enlace debajo del menú desplegable ▾ , aunque no es el caso de la apariencia Vector predeterminada en Wikipedia en inglés.