Mal:Sideindeks/Dokumentasjon

Fra Diskusjon.no WIKI

Viktig: Denne siden inneholder en demonstrasjon av malen som er korrigert for transklusjon. For at demonstrasjonen skal fungere riktig må dokumentasjonen leses fra Mal:Sideindeks

Mal:Sideindeks brukes til å lage en grafisk navigasjonsliste over sider og undersider som inngår i eksempelvis en artikkel. Mal:Sideindeks er modellert etter sideindeksen som benyttes på bl.a Hardware.no på artikler som inneholder flere enn én side.

Innhold

1 Slik bruker du malen
2 Begrensninger og anbefalt bruk
- 2.1 Anbefaling
3 Problemløsing
- 3.1 Vanlige feil
4 Demonstrasjon

Slik bruker du malen

Mal:Sideindeks bruker en liste over alle sider du vil innfatte i indeksen til å produsere en grafisk navigasjonsliste med navigasjonsknapper til de ulike sidene:

{{Sideindeks
| Eksempel side/Underside A
| Eksempel side/Underside B
| Eksempel side/Underside C
| Eksempel side/Underside D
| Eksempel side/Underside E
}}

Denne koden må du også kopiere inn på alle sidene som står oppført på lista.
Viktig: Man må oppgi sidens fullstendige bane. Dette inkluderer også eventuelle navnerom!

Merk: Man skal ikke tildele variablene navn (f.eks side 1 = Eksempel side/Underside A) da malen benytter automatisk nummerering av variablene.

Begrensninger og anbefalt bruk

Malen er begrenset til å kun bruke de 10 første sidene som oppgis i variabel-lista. Dette er for å unngå at man får alt for mange bilde-lenker, noe som vil gjøre den grafiske utføringer av malen mindre brukervennlig, samt vil kreve veldig bre oppløsning for å unngå at elementer slik som tekst og bilder kolliderer med hverandre.
Malen vil kreve korrigering av sidenavnene oppgitt i variabel-lista for å fungere ved transklusjon da den benytter systemvariabelen {{FULLPAGENAME}} til å sjekke siden man befinner seg på opp mot sidene i listen. Dette vil gi forskjellige resultater dersom malen blir transkluderert enn om man ser på en side hvor malen benyttes direkte. Se demonstrasjonen nedenfor for et eksempel på korrigering for transklusjon.

Anbefaling

Innfatt også modersiden i indeksen som første side i listen slik at man kan navigere seg helt tilbake til artikkelens start. Eksempel på innfatting av moderside og 3 undersider:

{{Sideindeks
| Mal:Sideindeks
| Mal:Sideindeks/Dokumentasjon/Demoside A
| Mal:Sideindeks/Dokumentasjon/Demoside B
| Mal:Sideindeks/Dokumentasjon/Demoside C
}}

Merk at koden ovenfor er korrigert for transklusjon da dokumentasjonen du leser nå transkluderes fra Mal:Sideindeks/Dokumentasjon til Mal:Sideindeks.

Problemløsing

Dersom man opplever trøbbel med bruk av malen anbefales det at man enten spør om assistanse eller forsøke å luke ut eventuelle feil man har gjort når man laget listen over sider som skal innfattes. Her er en liste over vanlige feil som begås:

Vanlige feil

Problem: "Forrige side" og/eller "Neste sider" mangler samt bildelenken for siden man ser på vises slik: istedet for slik:
- Løsning 1: Det er et mellomrom på slutten av sidenavnet du har deklarert i listen. Forsøk å viske ut mellomrommet ved å sette pekeren rett bak siste bokstav i sidenavnet og trykk "Delete" inntil linja under hopper opp og smelter sammen med linja du forsøker å reparere. Trykk enter slik at linjene skilles igjen og forhåndvis redigeringen.
- Løsning 2: (Ved transklusjon) Lista over sider du vil innfatte i sideindeksen er ikke korrigert for transklusjon. Sidenavnet deklarert i lista samsvarer ikke med navnet generert av systemvariabelen {{FULLPAGENAME}}. Korriger sidenavnene til navnet på siden hvor man faktisk leser det transkluderte innholdet. Sidenavnet er til enhver tid oppgitt som den grå overskrifta øverst på alle sider.