Manual:Table of contents/es


 *  This page is about tables of contents in wiki pages. For the contents page of the MediaWiki technical manual, see . 

Cuando una página contiene más de tres cabeceras de sección, se genera de forma automática un índice o tabla de contenidos.

Típicamente, el índice reproduce y numera esos encabezados.

En el índice se eliminan todas las etiquetas HTML de los encabezados, excepto $tags.



The table of contents is not generated for section headings that are found within html tags.



Cómo ocultar el índice
Place  anywhere you want on the page to hide its TOC.

Using certain templates, such as Template:Compact ToC (found on English Wikipedia), will replace the regular Table of Contents functionality.



Cómo ubicar el índice
De forma predeterminada, el índice se coloca justo antes del primer encabezamiento de sección. El texto anterior a la primera sección se muestra antes del índice. Any prior text is placed before the TOC. Para colocar el índice en otra posición, use la palabra mágica  en el punto deseado de la página.

Una piel puede suprimir el índice o trasladarlo a otra sección de la página, usando.



Cómo añadir el índice
Si a pesar de tener menos de cuatro cabeceras quiere tener un índice, escriba la palabra mágica  en cualquier punto de la página y el índice se mostrará en la posición predefinida, o bien escriba   en el punto donde desee mostrarlo.



Width
An extenuating circumstance may require the width of a TOC width to be adjusted as a percentage of a page. For example:

Profundidad
El nivel máximo de cabeceras que se muestran en el índice lo define. Para personalizar esto en páginas individuales, el índice puede encerrarse en un elemento con clase, siempre que las reglas CSS apropiadas estén definidas en $Common.

Véase un ejemplo en y las reglas pertinentes en Template:TOC/limit-styles.css.

Numeración automática
Por defecto, en el índice se numeran las secciones de modo automático. Las cabeceras de las secciones no incluyen el número. The section headings themselves aren't numbered. Este comportamiento del índice se puede personalizar de varias formas:


 * Se pueden suprimir los números de sección generados automáticamente en el índice, si la clase adecuada existe localmente en MediaWiki:Common.css, definida como.


 * Para hacer esto de forma selectiva, coloque un elemento contenedor alrededor del índice, por ej. así:  en la página y con    en MediaWiki:Common.css.

It is also possible to add numbering to headings themselves using JavaScript, as explained at.

Internacionalización
Cada idioma tiene una forma propia de expresar los índices y de numerar en ellos las (sub)secciones. Además, los manuales de estilo de muchos idiomas difieren en cuanto al estilo del índice y al esquema de numeración que recomiendan a los escritores.

Cada manual de estilo de un idioma puede recomendar ciertos convenios tipográficos.

Es importante resaltar que la mayoría de idiomas no tienen un manual de estilo para la escritura (muchos idiomas no tienen siquiera una forma escrita), por lo que la gente usa el estilo más frecuente (no uno reglamentado, sino el que se ve más habitualmente); esto hace que la escritura en muchos idiomas adopte una forma que podríamos llamar 'flexible' en su puntuación, ortografía e incluso gramática. La occidentalización ha influido en los sistemas de escritura basados o no en alfabetos, de modo que muchos idiomas simplemente han copiado las convenciones tipográficas y de puntuación de estilo europeo, o se han convertido a ellas de modo artificial.

A continuación se ofrece un ejemplo de cómo modificar el estilo de un índice a una versión local:

Algunos idiomas colocan un punto tras el número de sección, es decir, no usan este estilo:

Contents 1 Section [1] 1.1 Subsection [1.1] 2 Section [2] 2.1 Subsection [2.1] 3 Section [3] 3.1 Subsection [3.1] 3.1.1 Subsubsection [3.1.1] 3.1.2 Subsubsection [3.1.2]

sino que usan uno como este:

Contents 1. Section [1.] 1.1. Subsection [1.1.] 2. Section [2.] 2.1. Subsection [2.1.] 3. Section [3.] 3.1. Subsection [3.1.] 3.1.1. Subsubsection [3.1.1.] 3.1.2. Subsubsection [3.1.2.]

(Nótese la adición de puntos tras los ordinales y antes del nombre de la sección)

Se puede conseguir este efecto usando CSS. Ponga el siguiente código en un archivo CSS compartido de su instalación de MediaWiki:

donde el símbolo entrecomillado es el que debe ir tras el número de sección.

Véanse también 43494 y 33450 con detalles sobre problemas de índice relacionados con la internacionalización (i18n).

Flujo del texto
Puede hacerse que el índice se muestre en la página como un cuadro, con el texto de la página fluyendo a su alrededor.

Para ello, encierre el índice en un elemento con estilo CSS  o   (en el primer caso, índice a la izquierda con texto que fluye por su derecha; en el segundo, al contrario).

Véase un ejemplo en.

Extensiones
El comportamiento del índice se puede ajustar aún más utilizando extensiones.

Véase una lista de ellas en.



Enlaces externos

 * w:Help:Section - Ayuda sobre índices en la Wikipedia en inglés
 * m:Help:Section - Ayuda sobre índices en la Meta-Wiki