Manual:Table of contents/pt-br

Por padrão, uma tabela de conteúdo ou índice (por vezes abreviado para TOC) é gerada automaticamente em uma página quando mais de três títulos de seção são usados. Normalmente, a tabela reproduz e numera esses títulos.

Todo o código HTML nos títulos é removido do índice, exceto, , , , e.

Escondendo o TOC

 * Veja também Como esconder o TOC?


 * Para uma página
 * Coloque a palavra mágica  na marcação da página.


 * Para todas as páginas
 * Há três maneiras de faze-lo:
 * Instale a extensão Extension:NoTOC
 * Adicione a seguinte regra no Common.css:  (substituível por usuário através de suas páginas css)
 * Defina  no arquivo LocalSettings.php (substituível por usuário através de suas preferências)


 * Por usuário
 * Os usuários podem optar individualmente para ter o índice escondido. Esta é uma preferência do usuário, definida em Preferências (Preferências > Aparência > Opções avançadas > Mostrar TOC).

Posicionando o TOC
A posição padrão do TOC está diretamente acima do cabeçalho da primeira seção. Qualquer texto anterior é colocado antes do TOC. Para colocá-lo em outro lugar, use a palavra mágica  na posição preferível na página.

Adicionando o TOC
Se você tiver três cabeçalhos ou menos, mas quer ter um TOC, ou escreva a palavra mágica  em qualquer lugar da página para torná-lo visível no local padrão, ou escreva   na posição preferível.

Profundidade
O nível máximo de cabeçalhos exibidos no TOC é definido em. Se desejar personalizar isto para páginas individuais, o TOC pode ser incluído em um elemento com a classe, se as regras CSS apropriadas estiverem definidas no arquivo Common.css. Veja Template:TOC e as regras aplicáveis em MediaWiki:Common.css para uma implementação de exemplo.

Auto-numberação
By default, the TOC automatically numbers the sections. The section headings themselves aren't numbered. This behavior of the table of contents can be customised in several ways:


 * It is possible to suppress the auto-generated section numbers in the TOC, if the proper class exists locally at MediaWiki:Common.css, defined as . To do this selectively, a wrapper element can be placed around the TOC, as in   on the page, and   at MediaWiki:Common.css.
 * There is a user preference to also auto-number the section headings, at Preferences > Appearance > Advanced options > Auto-number headings. This can be set globally for the whole wiki by defining  in LocalSettings.php
 * This setting can be overridden individually by users, by changing their preferences as described above, or by setting  in their user style page. Administrators who lack server access can also override the setting for all users, if it is activated as mentioned above. This is done by using the same CSS code in the site's global common.css file.

Internationalization
Different languages have different ways of expressing TOCs and how its (sub)section numbering is done. Also, the different style guides of many languages differ in what style of TOC and TOC (sub)section numbering scheme they recommend for writers to use.

The different style guides of each language sometimes recommend different typographic conventions to follow. It's important to note that most languages don't even have any style guide for writing in that language (and many languages don't have a written form entirely), so people usually use the most common style based on existing written convention (not prescribed, but simply 'standard' due to popular usage), which makes the written use of many languages have a sort of 'fluid' punctuation, spelling/orthography and even [personal changes of the very] grammar [of that particular language]. Westernization has influenced alphabet and non-alphabet writing systems, with many languages simply copying or being artificially converted to European-style typographic and punctuational conventions.

An example on how to change the style of a TOC to a localized one is given below.

Some languages put a dot after a (sub)section ordinal number, e.g. they do not use the following TOC style:

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]

But use one like so:

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

(Notice the addition of dots after ordinal numerals before the section names!).

It's possible to produce that effect using CSS. Put the following CSS code in a shared CSS file of your MediaWiki installation and it should work: where the symbol between the single quotation marks is the sign after a (sub)section number.

Also, see 43494 and 33450 for details on related i18n problems of TOCs.

Floating
The TOC can be made to display as a floating element on the page, with text flowing around it. For this, enclose the TOC in an element with the CSS style  or. See Template:TOC for an example implementation.

Extensions
The behaviour of the table of contents can be further adjusted using extensions. See Category:TOC extensions for a list.