Sjabloon:Broodkruimel/doc

Uit Minecraft Wiki
Ga naar: navigatie, zoeken
Dit is de documentatiepagina, het zou moeten worden getranscludeerd op de bijbehorende pagina. Zie Sjabloon:Documentatie voor meer informatie.
Lualogo.svg
Dit sjabloon gebruikt Module:Broodkruimel. Het script hiervan is geschreven in Lua.
Zie ook WP:Lua en mw:Extension:Scribunto voor meer informatie.

Dit sjabloon produceert een broodkruimelnavigatie voor categorieën (of pagina's).


Het sjabloon en de documentatie ervan is ontleend aan Sjabloon:Broodkruimel op de Nederlandstalige Wikipedia.

Gebruik

Plaats {{Broodkruimel}} op de plaats waar een broodkruimelnavigatie moet komen. Dit sjabloon is in principe bedoeld voor categorieën, maar kan ook op normale pagina's gebruikt worden.

Een broodkruimel voor pagina's anders dan de huidige pagina, kan geproduceerd worden op de volgende manieren:

  1. {{Broodkruimel|1.12}}
  2. {{Broodkruimel|pagina=1.12}}

De categorieboom van bovenliggende sjablonen is in sommige gevallen best ingewikkeld. Daarom wordt er niet een boom geproduceerd tussen de pagina en Categorie:Minecraft Wiki, maar van enkel de bovenliggende categorieën. Voor pagina's geldt dat dit sjabloon alleen gebruikt mag worden wanneer dit een toegevoegde waarde heeft. Onderstaande parameters kunnen gebruikt worden om het broodkruimelspoor aan te passen.

Wanneer de pagina vaak in dezelfde categorie voorkomt, wordt een dubbele categorieboom niet weergegeven, maar vervangen door (...).

Verborgen categorieën worden weergegeven, maar categorieën die via een sjabloon worden toegevoegd (wat bij de meeste van deze categorieën het geval is), niet.

Op nieuwe categorie (of pagina)

Als bij het aanmaken van een nieuwe categorie of pagina het sjabloon meteen wordt toegevoegd, kan het voorkomen dat het sjabloon aangeeft dat er geen categorieën zijn. Dit komt door een probleem met timing. Mogelijke oplossingen zijn:

  • negeren. Binnen een aantal minuten of uren verschijnt de broodkruimel alsnog.
  • {{Broodkruimel}} toevoegen ná het aanmaken van de categorie of pagina.
  • (geavanceerd) verversen van de pagina door middel van een purge. Dit kan door in de URL de naam van de pagina te vervangen door index.php?title=<paginanaam>&action=purge en vervolgens op 'gaan' te klikken of ↵ Enter in te drukken.

Opties

Een broodkruimel wordt weergegeven tot deze vier of meer parallelle vertakkingen heeft of tot een lengte van vijf niveaus is bereikt.

lengte=<cijfer>
Wordt gebruikt om de maximale lengte van de broodkruimel aan te geven. lengte=1 geeft alleen de direct bovenliggende categorieën weer, lengte=2 de categorieën die daarboven weer liggen, enzovoort. Standaard is deze waarde 5.
maxbranch=<cijfer>
Wordt gebruikt om het maximale aantal parallelle takken te bepalen in de broodkruimel. Is standaard 4.
forceer=ja (booleaanse expressie)
Wordt gebruikt om alle categorieën boven de pagina weer te geven tot de opgegeven lengte is bereikt. Het aantal parallelle takken maakt niet uit. Wordt standaard niet gebruikt.
lettergrootte=<cijfer>
Wordt gebruikt om de lettergrootte te bepalen van de broodkruimel. Is standaard 8.
afbeelding=<afbeelding>
Wordt gebruikt om een afbeelding weer te geven. Is standaard Bookshelf.png ([[Bestand:Bookshelf.png|35px]]). Een aangepaste afbeelding kan gegeven worden door <bestandsnaam>.<extensie>.
startgrootte=<cijfer>
Deze parameter bepaalt de startgrootte van de broodkruimel. Vervolgens wordt de lettergrootte kleiner naarmate er meer bovenliggende categorieën getoond worden (meer naar links in de broodkruimel). Wordt standaard niet gebruikt.
negeer=<categorienamen>
Een door komma's gescheiden lijst van te negeren categorieën. Deze categorieën (en alles dat daarboven zit) worden niet weergegeven. Wordt standaard niet gebruikt.

Voorbeelden

  1. {{Broodkruimel|1.12}} of {{Broodkruimel|pagina=1.12}}
    Bookshelf.png
    (...) → Minecraft
     → Edities
    (...) → Minecraft
     → Gameplay
    } → PC Editie
    Minecraft Wiki
     → Minecraft
     → Versie
    } → PC Editie Vanilla
     → 1.12
  2. {{Broodkruimel|lengte=1}}
    Bookshelf.png
     Categorieën: Geen
  3. {{Broodkruimel|Categorie:1.0.0 pre-releases|maxbranch=2}}
    Bookshelf.png
  4. {{Broodkruimel|Categorie:Wii U Editie|startgrootte=10|afbeelding=WiiU.png}}
    WiiU.png