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-numeração
Por padrão, o TOC automaticamente numera as seções. Os próprios títulos das seções não são numerados. Este comportamento do índice pode ser personalizado de várias maneiras:


 * É possível suprimir os números de seção gerados automaticamente no TOC, se a classe adequada existe localmente em MediaWiki:Common.css, definido como . Para fazer isto seletivamente, um elemento de invólucro pode ser colocado em torno do TOC, como em   na página, e   em MediaWiki:Common.css.
 * Existe uma preferência de usuário para numeração automática dos títulos das seções, em Preferências > Aparência > Opções avançadas > Auto-numerar títulos. Este pode ser definido globalmente para todo o wiki, definindo  no arquivo LocalSettings.php
 * Esta configuração pode ser substituída individualmente pelos usuários, alterando as suas preferências, como descrito acima, ou através da criação da linha  em sua página Estilos de usuário. Os administradores que não têm acesso ao servidor também podem substituir a configuração para todos os usuários, se ele é ativado conforme mencionado acima. Isto é feito através da utilização do mesmo código CSS no arquivo global do site common.css.

Internationalização
Idiomas diferentes têm maneiras diferentes de expressar TOCs e como sua numeração subseção é feito. Além disso, os diferentes guias de estilo de muitos idioma diferem em qual estilo do esquema de numeração de TOC e subseção de TOC que é recomendado para os editores usarem.

Os diferentes guias de estilos de cada idioma, por vezes recomendam diferentes convenções tipográficas a seguir. É importante notar que a maioria dos idiomas não tem sequer qualquer guia de estilo para escrever nesse idioma (e muitos idiomas não têm uma forma escrita totalmente), então as pessoas geralmente usam o estilo mais comum, com base em convenção escrita existente (não prescrita, mas simplesmente 'standard' devido ao uso popular), o que causa ao uso escrito de inúmeras línguas uma espécie de pontuação, soletração ou ortografia fluida e até mesmo [mudanças pessoais] da própria gramática dessa [língua em particular]. A ocidentalização influenciou sistemas de escrita alfabeto e não-alfabeto, com muitos idiomas simplesmente copiando ou sendo convertidos artificialmente às convenções tipográficas e de pontuação do estilo europeu.

Um exemplo de como mudar o estilo de um TOC para um TOC qualquer localizado é dado abaixo.

Alguns idiomas colocam um ponto após um número ordinal de (sub)seção, por exemplo, eles não usam o seguinte estilo de TOC:

Conteúdo 1 Seção [1] 1.1 Subseção [1.1] 2 Seção [2] 2.1 Subseção [2.1] 3 Seção [3] 3.1 Subseção [3.1] 3.1.1 Subsubseção [3.1.1] 3.1.2 Subsubseção [3.1.2]

Mas use algo assim:

Conteúdo 1. Seção [1.] 1.1. Subseção [1.1.] 2. Seção [2.] 2.1. Subseção [2.1.] 3. Seção [3.] 3.1. Subseção [3.1.] 3.1.1. Subsubseção [3.1.1.] 3.1.2. Subsubseção [3.1.2.]

É possível produzir esse efeito usando CSS. Coloque o seguinte código CSS em um arquivo CSS compartilhado de sua instalação do MediaWiki e ele deve funcionar: onde o símbolo entre as aspas é o sinal após um número de (sub)seção.

Também, consulte 43494 e 33450 para obter detalhes sobre problemas relacionados ao i18n dos TOCs.

Flutuação
O TOC pode ser feito para mostrar como um elemento flutuante na página, com o texto flui em torno dele. Para isso, coloque o TOC em um elemento com o estilo CSS  ou. Veja Template:TOC para uma implementação de exemplo.

Extensões
O comportamento do índice pode ser ajustado ainda mais usando extensões. Consulte Category:TOC extensions para uma lista das opções.

Ligações externas

 * Ajuda sobre o TOC na Wikipédia
 * Ajuda sobre o TOC no Meta-Wiki