Mall:Ankare

Dokumentation

Användning

{{ankare}} används till att skapa ankare med specifika namn.

Eftersom Wikipedia automatiskt skapar ankare för alla rubriker, så skall den här mallen som regel INTE användas. Men det finns undantag, t.ex. (1) när det ankarnamn som Wikipedia skapar är olämpligt/otympligt och (2) när ett ankarnamn automatiskt ändras i samband med att den anknutna rubriken ändras, vilket bryter alla eventuella länkar till ankaret (eftersom de länkar till det gamla ankarnamnet).

Obs: {{ankare}} skapar ankare som är dolda på sidan. Inga länkar eller andra typer av markeringar, som visar att det finns ett ankare på platsen, skapas av den här mallen.

Ankare

Ett ankare är rent tekniskt ett HTML-element med formatet <a name="ankarnamn"></a>. Elementet definierar en namngiven position/plats på en HTML-sida eller i en Wikipediaartikel, vilket gör det möjligt att skapa länkar till positionen ifråga.

Förutom att skapa vanliga länkar till artiklar kan man även skapa direktlänkar till specifika ankare på en sida eller i en artikel. I Wikipedia får till exempel varje rubrik som skapas genom att använda likhetstecken (==Rubriktext==) automatiskt ett ankare. De innehållsförteckningar som skapas av Wikipedia, länkar automatiskt till rubrikernas ankare, så att när du klickar på en rubrik i innehållsförteckningen, hoppar du automatiskt till respektive ankare.

För att skapa en länk till ett visst ankare på en viss sida använder man nummertecken (#). Länken skrivs enligt formatet artikelnamn#ankarnamn (det gäller både för HTML-kod och wikikod). Nummertecknet behöver inte finnas i länktexten, bara i själva länken.

Exempel

Wikilänk till ankaret/underrubriken "Parametrar" på den här dokumentationssidan:
- [[#Parametrar]] ger #Parametrar
- [[#Parametrar|Parametrar]] ger Parametrar
Wikilänk till ankaret/underrubriken "Kritik" i artikeln om Microsoft:
- [[Microsoft#Kritik]] ger Microsoft#Kritik
- [[Microsoft#Kritik|Kritik mot Microsoft]] ger Kritik mot Microsoft

Parametrar

Det finns bara en typ av parameter: namnet på det/de ankare som du vill skapa. Du kan som mest ange 10 ankarnamn i mallen, 1 huvudankarnamn och 9 alternativa ankarnamn. Det första ankaret är obligatoriskt, de andra kan utelämnas.

Mallens syntax är

{{ankare |Ankare1 |Ankare2 |Ankare3 |Ankare4 |Ankare5 |Ankare6 |Ankare7 |Ankare8 |Ankare9 |Ankare10 }}

Exempel

1. {{ankare|Exempelankare}}

kan länkas till genom att lägga till [[#Exempelankare|…]] i samma artikel,

eller länkas till genom att lägga till [[Artikelnamn#Exempelankare|…]] i andra artiklar och omdirigeringar.

2. Ankare kan passa bättre för länkning inom en artikel än avsnittsrubriker. Exempel:

== {{ankare|Exempelankare}} Avsnittsrubrik ==

Här kommer länkar av typen [[Artikelnamn#Exempelankare]] fortsätta att vara giltiga även om avsnittet får ett nytt namn. (Observera att ankaret är placerat före avsnittets namn; i annat fall kan webbläsare komma att dölja avsnittsrubriken.) Emellertid, som anges under Begränsningar nedan, kan det vara bättre att använda HTML direkt istället för att använda mallen inom avsnittsrubriker:

== Avsnittsrubrik ==

3. Mallen kan användas för att skapa flera ankare i ett enda anrop. Exempel:

{{ankare|Exempelankare|Ankarexempel|exa}}

kommer att skapa tre ankare, som kan länkas till med [[#Exempelankare]], [[#Ankarexempel]] och [[#exa]].

Demonstrationslänk

Klicka på den här länken för att hoppa till ankaret test1, någonstans på dokumentationssidan: Testlänk 1

Begränsningar

Ankarnamn i HTML- och URL-kod visas i vissa fall med koder för å, ä, ö , ü m.fl. (beroende på vilken teckenkodning som används). [[Sillgrissla#Föda]] Sillgrissla#Föda, kan visas som …/Sillgrissla#F%C3%B6da. Trots detta fungerar det dock utmärkt att använda dessa bokstäver i ankaret.

Däremot kan inte mellanslag användas, utan dessa måste ersättas med _ (understreck), annars blir ankaret endast det första ordet.

Tecken	Teckenentitet	Wiki-kod	Betydelse
"	`"` `"`	i.u.	Citattecken
#	`#`	i.u.	Nummertecken
=	`=`	`{{=}}`	Likhetstecken
`\|`	`\|`	`{{!}}`	Lodstreck

Tecknen i tabellen fungerar inte i ett ankarnamn, men kan ersättas med sina respektive teckenentiteter ("&"-koderna i tabellen). Vissa har dessutom en särskild wiki-kod, där likhetstecken kan ersättas med mallen {{=}}, och lodrätt streck med det magiska ordet {{!}}.

Kod som  och  (exponentläge resp. indexläge) kan inte användas. De flesta andra tecken kan användas utan problem.

I övrigt gäller följande:

Ankarnamn skall vara unika på den sida där de finns och aldrig vara namndubbletter till rubriker på sidan, eftersom rubriker automatiskt blir ankare. Dubblettankare kommer inte att fungera som förväntat, eftersom ankarlänkar endast går till det första ankaret på sidan med det namnet. Resultatet blir dessutom ogiltig HTML-kod, så dubblettankare kan hittas genom att köra sidan genom W3C Markup Validation Service.
Använd ibland HTML istället för mallen. Om mallen läggs till i en rubrik till ett avsnitt kommer koden att visas i sammanfattningsrutan när avsnittet redigeras: "/* {{ankare|Ärende}}Begränsningar */ Nytt ärende". Dessutom är det inte säkert att webbläsaren återvänder till avsnittets position på sidan när redigeringen sparas. Använd hellre  än {{ankare}} i avsnittsrubriker.
Ankarlänkar är skiftlägeskänsliga i vissa webbläsare, så var noga med versaler och gemener när du hanterar ankarlänkar.

TemplateData

Det här är TemplateData-dokumentation för den här mallen. Det används av VisualEditor och andra verktyg.

TemplateData för Ankare

Mallen {{ankare}} infogar ett eller fler HTML-ankare på en sida. Dessa platser kan sedan länkas till genom att använda länkformatet [[#ankarnamn|…]]. Parametrarna nedan visas för enkelhets skull; inga parameternamn behöver anges i själva mallen.

Mallparametrar[Redigera TemplateData]
Parameter		Beskrivning	Typ	Status
Första ankaret	`1`	Första ankaret; Endast det första ankaret är obligatoriskt.	Sträng	obligatorisk
Andra ankaret	`2`	Andra ankaret.	Sträng	valfri
Tredje ankaret	`3`	Tredje ankaret. För att lägga till fler ankare, skriv helt enkelt 4 som parameternamn för nästa ankare, 5 för det därpå följande, och så vidare.	Sträng	valfri

Hit går testlänken
Klicka på den här länken för att komma tillbaka till ankaret, som Wikipedia automatiskt har skapat till rubriken "Demonstrationslänk": Testlänk 2

Ankaret du landade på när du klickade dig hit skrevs in så här: {{ankare|test1}}'''Hit går testlänken'''

Ovanstående dokumentation transkluderas från sidan ”Mall:Ankare/dok”. Kategorier ska placeras på den dokumentationssidan.