Predefinição:Âncora
- Esta documentação é transcluída de Predefinição:Âncora/doc.(editar | histórico | vigiar)
Descrição
editarA 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 w:Wikipedia: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:
- w:Wikipedia: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") - w:Wikipedia: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.
Como usar
editarA predefinição pode ser usada das seguintes formas:
1. {{â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.
2. =={{â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.
3. {{â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- 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.