Predefinição:Âncora/doc
 | Esta é uma subpágina de documentação para a Predefinição:Âncora. Ela contém informações sobre o seu uso, categorias, bem como todo o conteúdo que não faz parte da predefinição original. |
 | Esta predefinição é usada em muitas páginas e as alterações em seu conteúdo serão amplamente notadas. Por favor, teste as alterações na subpágina de testes desta predefinição, em sua subpágina da predefinição de testes ou na subpágina de testes em seu espaço usuário. Considere discutir mudanças na página de discussão antes de implementá-las. |
Descrição
[editar código-fonte]A predefinição {{âncora}} insere uma âncora em HTML <a></a> numa página, permitindo que se criem ligações para essa parte da página.
Esta predefinição é útil, por exemplo, para casos em que é necessário mudar o nome de uma secção, principalmente em páginas do domínio Ajuda e Wikipedia, mas existem (ou podem existir) muitas ligações para a secção com o nome anterior. Isso foi feito por exemplo numa secção da página Wikipédia:Ligações externas que tinha como nome "Quais páginas linkar?" e foi mudado para "Tipos de ligações externas". Ao usar esta predefinição as seguintes ligações:
- Wikipédia:Ligações externas#Quais páginas linkar? (aponta para a localização onde está o código
{{Âncora|Quais páginas linkar?}}logo antes da secção "Tipos de ligações externas") - Wikipédia:Ligações externas#Tipos de ligações externas (aponta para a secção)
Apontam para a mesma secção, apesar da secção apenas ter um dos nomes.
Uso
[editar código-fonte]A predefinição pode ser usada das seguintes formas:
{{âncora|exemplo}}- isto permite fazer ligações internas com o código [[#exemplo|...]] se for na mesma página;
- ou com o código [[nome da página#exemplo|...]] se for em outra páginas, ou redirecionamentos.
=={{âncora|exemplo}}Nome da secção ==- Notar que neste caso se o código da predefinição for retirado do nome da secção, só funcionarão as ligações para o nome da secção.
{{âncora|exemplo|outro|e outro}}- Este exemplo demonstra múltiplos nomes para as âncoras (até o limite de 10 âncoras), permitindo usar os seguintes códigos para apontar para o mesmo local: [[#exemplo]], [[#outro]] e [[#e outro]].
- Caso se especifiquem mais de 10 nomes das âncoras, irá ser mostrada uma mensagem de erro.
Limitações
[editar código-fonte]- Os nomes de âncoras que contêm # (cerquilha), | (barra vertical), = (igual) não funcionarão como esperado. A maioria dos outros caracteres, incluindo o espaço em branco e sinais de pontuação não causam problemas.
- Caso se especifiquem mais de 10 nomes das âncoras, irá causar um erro.
- Colocar o nome de cada âncora em linhas separadas, como:
{{âncora|exemplo
|exemplo2}}- não funciona como esperado.
- Os nomes das âncoras devem ser únicos numa só página, e não deve conter o mesmo nome de uma secção existente na página. As âncoras com nomes duplicados não funcionam como esperado, pois caso estejam em duplicado, as ligações para essa âncora apontaram sempre para a primeira âncora (ou secção) com o nome duplicado. As âncoras com nomes duplicados também resultam em código HTML inválido.
Ver também
[editar código-fonte]