Help:Magic header

De magic header zorgt ervoor dat informatie over een werk alleen op de Indexpagina hoeft te worden gedefinieerd. Kopteksten (headers) op de getranscludeerde pagina’s kunnen dan automatisch worden aangemaakt. Deze hulppagina geeft een overzicht van het gebruik.

Gebruik[bewerken]

Allereerst zorgt men dat de relevante informatie over het werk op de Indexpagina aanwezig is.
In de Index zijn de velden die momenteel worden overgenomen:

Titel
Auteur
Vertaler
Jaar
Uitgever
Plaats van uitgave

Verder is in de Index het veld “Inhoudsopgave” van belang. Hierin dienen alle pagina’s te worden getranscludeerd die op de hoofdpagina moeten verschijnen, en dit moet tenminste de inhoudsopgave van het werk omvatten. Gebruikelijk is om hier het titelblad gevolgd door de inhoudsopgave in te voegen.

De hoofdpagina: titelblad en inhoudsopgave[bewerken]

Zie bijvoorbeeld het boek Negen novellen. Op de hoofdpagina staat, behalve de categorisatie, alleen de volgende regel:

<pages index="Bosboom-Toussaint - Negen Novellen, 1883.djvu" header=overzicht/>

Hier worden dus geen pagina’s getranscludeerd met from=... to=.... Alleen de indexpagina is gegeven, en het commando header=overzicht. Dit heeft het volgende effect:

De koptekst wordt aangemaakt, met de velden uit de Indexpagina zoals hierboven beschreven.
Als er een subpagina “…/Gehele tekst” bestaat (in dit geval bestaat die: Negen novellen/Gehele tekst), wordt daarnaar een link “Doorlopende tekst op één pagina” gemaakt.
Hieronder wordt het veld “Inhoudsopgave” uit de indexpagina opgenomen. In dit veld moet dus alles worden getranscludeerd wat op de hoofdpagina dient te verschijnen. Zie Index:Bosboom-Toussaint - Negen Novellen, 1883.djvu, waar het veld Inhoudsopgave bestaat uit:
```
{{Pagina:Bosboom-Toussaint - Negen Novellen, 1883.djvu/9}}
{{Pagina:Bosboom-Toussaint - Negen Novellen, 1883.djvu/11}}
```
In dit geval worden dus het titelblad en de pagina met de inhoudsopgave getranscludeerd.

Resterende pagina’s, met de daadwerkelijke inhoud[bewerken]

Op de resterende pagina’s wordt getranscludeerd als normaal, plus de code header=1. Zie bijvoorbeeld de pagina Negen novellen/Twee doopzusters:

<pages index="Bosboom-Toussaint - Negen Novellen, 1883.djvu" from=13 to=37 header=1/>

Hier wordt dus wél de paginareeks gespecificeerd, en wordt de magic header aangeroepen met header=1. Er wordt in dit geval alleen de koptekst gemaakt, en geen link naar de gehele tekst.

Men ziet op de pagina Negen novellen/Twee doopzusters ook dat in de koptekst een sectienaam “TWEE DOOPZUSTERS” verschijnt, en een link naar het volgende hoofdstuk: “HET STERVEN VAN BURGEMEESTER HOOFT”. Deze namen en links zijn afkomstig uit het veld “Inhoudsopgave” op de indexpagina: daar staat een link naar deze pagina met de naam “TWEE DOOPZUSTERS”, en de eerstvolgende link daarna is die naar “HET STERVEN VAN BURGEMEESTER HOOFT”. Zo wordt dit dus ook automatisch overgenomen.

Velden handmatig aanpassen per pagina[bewerken]

Wanneer de koptekst gedeeltelijk aangepast moet worden (bijvoorbeeld omdat niet iedere sectie dezelfde auteur heeft), kan de magic header nog steeds gebruikt worden. Velden kunnen overschreven worden als volgt:

<pages index="…" from=… to=… header=1 auteur="<een andere auteur>" />

Dit kan met bijna alle velden, maar niet alle velden heten hetzelfde in <pages /> als in het {{Koptekst}}-sjabloon:

Veld in {{Koptekst}}	Veld in `<pages />`
`\| Titel =`	`titel="..."`
`\| Schrijver =`	`auteur="..."`
`\| Vertaler =`	`vertaler="..."`
`\| Sectie =`	`current="..."`
`\| Vorige =`	`prev="..."`
`\| Volgende =`	`next="..."`
`\| Jaar =`	`jaar="..."`
`\| Opmerkingen =`	De magic header vult het opmerkingenveld met de uitgever en de plaats van uitgave. Deze kunnen worden aangepast met: `uitgever="..."` `plaats="..."` Dit veld kan ook worden onderdrukt door het uitgeverveld expliciet leeg te maken: `uitgever=""` Voor belangrijke informatie die niet op een andere manier kan worden weergegeven, is er ook het veld: `extra_info="..."` Deze extra informatie verschijnt dan onder de regel over de uitgever.

Aanvullende opmerkingen[bewerken]

from=n to=n kan vervangen worden door include=n.
Geef zoveel mogelijk de benodigde informatie reeds in de Indexpagina, want dan wordt de informatie ook getranscludeerd. Wees zuinig met overschrijvingen, want die informatie wordt niet getranscludeerd en is gevoelig voor ongewenste veranderingen. Vermijd met name ook zoveel mogelijk het gebruik van de optie extra_info="...".

Zie ook[bewerken]

Sjabloon:Koptekst
MediaWiki:Proofreadpage header template: De brontekst van de magic header op deze wiki
mw:Help:Extension:ProofreadPage/Pages tag, over de werking van de <pages /> tag