Predefinição:Âncora

Documentação da predefinição

Esta documentação é incluída (transcluded) a partir de Predefinição:Âncora/doc. (editar | histórico)

Esta predefinição foi copiada do Template:Anchor, disponível na Wikipédia anglófona.

Uso

{{Âncora}} (ou seu redirecionamento no plural {{Âncoras}}, ou ainda {{\label}}) irá inserir uma ou mais âncoras na posição em que for colocada, permitindo que sejam feitos #links diretos para tal posição.

Código

Antes{{Âncora|Meu link|Minha seção|Outro nome}}Depois

Resultado

AntesDepois

A predefinição também serve para adicionar apelidos (nomes alternativos) diretamente dentro do cabeçalho de uma seção.

Código

==Notas {{Âncora|Notas|Detalhes}}==

Resultado

(veja o cabeçalho abaixo)

Notas

• A predefinição irá tratar até 10 nomes de âncoras, mas pode facilmente ser extendido para lidar funcionar com o dobro ou mais. Se você acidentalmente usar mais do que 10 âncoras, a predefinição irá exibir uma mensagem de erro em uma caixa amarela como esta: Isto permitirá que você perceba que exagerou na quantidade de âncoras, em vez de simplesmente ter as últimas âncoras ignoradas silenciosamente.
• Quando usado para acrescentar âncoras a um parágrafo de prosa, é preferível colocar a predefinição exatamente no início do parágrafo (grudado com a primeira palavra, sem espaço) de modo a garantir que um clique em um dos #Links afluentes resultará na exibição do parágrafo por inteiro na tela do leitor.
• Você pode acrescentar apelidos aos cabeçalhos usando uma sintaxe como a seguinte:

==Título do cabeçalho {{Âncoras|Meu link|Minha seção}}==

Isto resultará em "#Meu link" e "#Minha seção" sendo apelidos que apontam para o mesmo lugar que "#Título do cabeçalho". Esta sintaxe não altera o cabeçalho, que permanece tão funcional quanto estaria se não houvesse qualquer predefinição inserida (isto é, aparece na Tabela de Conteúdos da página, e a edição de seções continua funcionando normalmente). Este método é vantajoso na medida em que você sempre vê a lista de âncoras quando edita uma seção isoladamente, e elas funcionam exatamente como a âncora fornecida pelo próprio cabeçalho. Isso não acontece quando uma âncora é colocada uma linha acima ou abaixo do cabeçalho. Além disso, a adicão de ancoras depois do cabeçalho, na mesma linha, não funciona.

• Dentro de um cabeçalho, a inserção do código para a âncora antes ou depois do cabeçalho usual funciona quase da mesma maneira. Colocando ele antes do cabeçalho, faz com que ele funcione mais parecido com um cabeçalho verdadeiro em mais navegadores web, mas colocá-lo depois do cabeçalho torna mais legível o cabeçalho verdadeiro, e mais fácil de encontrar. Ter um espaço entre a predefinição e o título do cabeçalho não traz problemas, e deixa o código mais legível.

• Mesmo quando você usar nomes alternativos muito longos, será preciso manter o cabeçalho e suas âncoras em uma mesma linha (que poderá então ser muito longa e sofrer quebra de linha - wrap) em seu próprio parágrafo único. Tentar usar uma formatação vertical para a predefinição pode dar a impressão de que tudo funciona, incluindo a numeração de seções, mas na verdade uma tentativa de editar a seção irá resultar em uma edição da seção seguinte, por causa de um bug. Assim, em cabeçalhos, não use uma formatação vertical como:

==Caixa de areia {{Âncora
| Página para testes | Página de testes | Testes | Teste
}}==

Embora os nomes {{Âncora}} e {{Âncoras}} possam ser usados indiferentemente, é preferível usar o nome no singular para uma única âncora, e a versão no plural para âncoras multiplas. Isso irá permitir que se use Special:Whatlinkshere/Predefinição:Âncoras para saber sobre o uso de âncoras múltiplas, o que pode ajudar a converter o estilo antigo {{Âncora|Meu link}}{{Âncora|Minha seção}} para {{Âncoras|Meu link|Minha seção}}.

Veja também

• {{Âncoras}}