Hjelp:Transklusjon

Indeks over hjelpesider

Transklusjon

• En bok har en fysisk struktur (inndeling i sider) og en logisk struktur (inndeling i kapitler og avsnitt, osv.)
• Korrekturlesning av teksten foregår i Side- og Indeks-navnerommene; her følger man den fysiske inndelingen av boken.
• Presentasjonen av den ferdige teksten for leserne foregår i hovednavnerommet; her følger man den logisk inndelingen av boken.

Transklusjon er en operasjon som lar oss lime inn en tekstbit fra Side-navnerommet i hovednavnerommet.

Syntaks

En transklusjon foregår på samme måte som bruken av en mal: Det dreier seg om å inkludere et eller flere stykker tekst i siden som skal inneholde en logisk teksmengde (et dikt eller et kapittel).

Koden <pages /> lar en transkludere én eller flere sider etter hverandre. Den kan også utføre en rekke andre handlinger (se under).

Eksempel

<pages index="Garborg - Haugtussa.djvu" from=45 to=46 />

vil transkludere side 45 og 46 fra Indeks:Garborg - Haugtussa.djvu.

Delvis transklusjon

Hvis du bare vil ha med én seksjon (for eksempel «seksjon 2») fra side 20, kan du skrive

<pages index="Indeksnavn.djvu" from=20 fromsection="seksjon 2" />

Hvis du skriver

<pages index="Indeksnavn.djvu" from=20 to=23 fromsection="seksjon 2" />

får du med kun «seksjon 2» fra side 20, men hele side 21, 22 og 23.

Hvis du skriver

<pages index="Indeksnavn.djvu" from=20 to=22 fromsection="seksjon 1" tosection="seksjon 1" />

får du med kun «seksjon 1» fra side 20, hele side 21 og kun «seksjon 2» fra side 22.

Topp (header)

Ved transklusjonen er det mulig å opprette en «topp» (header) automatisk, ved hjelp av parameteren «header». Skriv for eksempel

<pages index="Indeksnavn.djvu" from=20 to=23 header=1 />

Det vil da automatisk opprettes en topp med opplysninger fra indekssiden «Indeksnavn.djvu». Dersom indekssiden har en innholdsfortegnelse, vil det også automatisk opprettes lenker til forrige og neste side. For at dette skal fungere må det være en lenke til den aktuelle siden fra innholdsfortegnelsen på indekssiden.