Kruimelpad

Wat is het kruimelpad en waar vind je het?bewerken

In het kruimelpad kun je zien waar de pagina die je leest hangt binnen de bredere structuur van noraonline: het geeft je de mogelijkheid om door te klikken en als het ware uit te zoomen van detail naar groter onderwerp. Je vindt het kruimelpad direct onder de blauwe menubalk, aan de linkerkant onder het NORA logo. Hieronder een voorbeeld van de pagina Volglijst aanmaken:

screenshot van een kruimelpad

Het kruimelpad is op elke pagina anders en loopt vanaf de homepage NORA via een of meerdere stappen naar de titel van de huidige pagina. Op elke stap er tussen kun je klikken om die pagina te openen. Voor deze pagina is het kruimelpad bijvoorbeeld: NORA / Help / Kruimelpad, maar een kruimelpad kan ook een stuk langer zijn.

Het kruimelpad volgt de inhoudelijke indeling van de website, als je daar meer over wilt lezen kan dat in het achtergrondartikel Navigatiestructuur van NORA online.

Hoe weet de pagina wat het juiste kruimelpad is?bewerken

De website maakt het kruimelpad op basis van zogenaamde categorieën: een label of tag dat markeert dat de pagina in een bepaalde groep valt. Categorieën voeg je handmatig toe aan een pagina of met een sjabloon en elke pagina kan in meerdere categorieën vallen. Maar het kan maar één kruimelpad krijgen. We hebben daarom een lijst met categorieën die gebruikt worden voor het kruimelpad, met voor elke categorie het kruimelpad dat er bij hoort. De lijst (MediaWiki:Breadcrumbs) wordt van bovenaf doorgelopen door de extensie die het kruimelpad regelt, dus bij meerdere categorieën op een pagina bepaalt de plek van de categorie in die lijst welk kruimelpad het meekrijgt.

Samen zorgen voor dat de kruimelpaden goed werkenbewerken

Kruimelpaden zijn belangrijk voor wie kennis zoekt, maar ook voor wie kennis deelt: hoe beter begaanbaar de website is, hoe beter mensen relevante kennis kunnen vinden en toepassen en hoe groter de kans dat ze mee willen werken aan de doorontwikkeling.

We hopen dan ook dat jullie mee willen werken om op elke pagina het juiste kruimelpad te tonen. Dat doe je door:

  1. Bij bestaande pagina's te checken of er een kruimelpad is (dus niet alleen NORA / paginatitel, dat is in de meeste gevallen te weinig) en of dat ook een logisch kruimelpad is. Zo nee kun je dat melden via nora@ictu.nl, wij pakken het dan op. Of je kijkt bij troubleshooting lager in deze pagina en kijkt of je het zelf op kunt lossen.
  2. Bij het aanmaken van pagina's zelf de juiste categorie toe te voegen of een mailtje te sturen naar nora@ictu.nl met daarin welk kruimelpad je zou willen. NB: je hangt een pagina aan een landingspagina, de eigenaar van die pagina moet daar wel mee akkoord gaan. NORA Beheer zal dat bij twijfel navragen voordat de categorie geplaatst wordt.
  3. Bij het verplaatsen van een pagina binnen de structuur te checken of het kruimelpad ook is aangepast. Als een onderwerp bijvoorbeeld verschuift van Kennisdeling naar Referentiearchitectuur moet het kruimelpad ook veranderen. Meestal betekent dat een wijziging in de categorie op de pagina, soms is dat niet nodig maar moeten we de lijst voor het kruimelpad aanpassen. Meldt het bij nora@ictu.nl, of kijk eerst bij Troubleshooting hieronder als je het eerst zelf wilt proberen.
  4. Zelf geen wijzigingen aan te brengen in de lijst voor het kruimelpad. Een fout in de inhoud of volgorde van die lijst kan behoorlijk wat impact hebben en door het beheer in eigen hand te houden wil NORA Beheer wildgroei en chaos voorkomen. Wijzigingen door derden zullen direct worden overschreven of teruggedraaid.

Checklist klopt het kruimelpad?bewerken

Waar moet ik op letten:

  • Staat er alleen de naam van de pagina met daarvoor NORA? Dan is er geen categorie die voorkomt in de pagina Breadcrumbs
  • Staat er tussen de naam van de pagina en NORA één woord? Check dan of dat inderdaad de juiste landingspagina is door er op te klikken.
  • Staan er meerdere stappen? Dan is dat als het goed is een hiërarchie van landingspagina's, met eventueel een inhoudelijke pagina als laatste stap voor de paginatitel zelf. Zijn alle stappen logisch en correct?
  • Is de laatste stap een inhoudelijke pagina? Check of de pagina waar je op staat ook echt via die inhoudelijke pagina ontsloten wordt.

Kan ik het zelf fixen?bewerken

De pagina MediaWiki Breadcrumbs blijft voorlopig alleen onder beheer van Marieke, om het overzicht te kunnen behouden. Maar de meeste kruimelpad-fouten zijn te verhelpen in de pagina zelf door de gebruikte categorieën aan te passen. Ook als dat niet lukt, helpt het bij het oplossen als je helder aan weet te geven wat het probleem is in een mail aan marieke.vos@ictu.nl.

Troubleshoot: kruimelpad ontbreektbewerken

  • Kijk welke categorieën de pagina heeft. Dat doe je in het Tools-menu in de werkbalk, Eigenschappen bekijken. De categorieën staan bijna onderaan vermeld als eigenschap. Is er geen categorie? Dan moet je er sowieso een toevoegen om een kruimelpad te tonen.
  • Kijk of er andere pagina's zijn die logischerwijs hetzelfde kruimelpad moeten hebben: klopt het daar wel? Kijk weer met Eigenschappen bekijken welke categorieën de pagina heeft en kopieer die voor zover ze ook logisch zijn voor jouw pagina.
  • Mist het kruimelpad ook bij andere pagina's en/of heb je al wel een categorie toegevoegd die volgens jou zou moeten werken? Ga naar de pagina MediaWiki:Breadcrumbs, gebruik control-f om te zoeken binnen de pagina en type of kopieer de naam van de categorie die volgens jou een kruimelpad zou moeten opleveren. Check eventueel een andere spelling en enkelvoud/meervoud nog een keer extra. Heb je ook dan nog geen resultaten? Vraag Marieke dan de categorie toe te voegen en zet er het gewenste kruimelpad bij.
  • Heb je wel een resultaat, maar zie je toch geen kruimelpad voor de pagina waar de categorie is toegevoegd? Dan is er iets anders aan de hand, laat het NORA Beheer even weten en zet er een link bij van de pagina in kwestie.

Troubleshoot: verkeerd kruimelpadbewerken

Als je een ander kruimelpad ziet dan je verwacht, dan zijn er twee mogelijkheden:

1. De pagina valt in meerdere categorieën en het kruimelpad van de andere categorie krijgt voorrang.bewerken

  • Check met Eigenschappen bekijken in het Tools-menu in de werkbalk welke categorieën de pagina precies heeft. Check vervolgens op de pagina MediaWiki:Breadcrumbs met control-f elk van die categorieën. Heb je meerdere hits? Dan is er een voorrangsprobleem. Heb je maar één hit? Dan geldt 2.

Check of de pagina terecht in beide categorieën valt - zo nee kun je de niet-kloppende verwijderen.

Als beide categorieën logisch zijn, meldt het dan even bij NORA Beheer met een link naar de pagina, de beide categorieën en idealiter een cc naar de inhoudelijk eigenaren van de twee landingspagina's die beide logischerwijs claim kunnen leggen op de pagina.

Dan vogelen we samen uit wat de voorrang hier moet zijn en hoe we dat implementeren zonder dat andere pagina's er last van hebben.

2. Het kruimelpad dat opgegeven is voor de categorie klopt niet en moet worden aangepast.bewerken

Check welk kruimelpad er nu voor de gegeven categorie staat op MediaWiki:Breadcrumbs. We kunnen de volgende situaties tegenkomen:

  • Het kruimelpad op Breadcrumbs is het kruimelpad wat ook op de pagina stond en je vind dat het niet klopt. Meldt dat dan aan NORA Beheer, met vermelding van de categorie, het correcte kruimelpad en de pagina waar je het kruimelpad goed wilt hebben.
  • Op Breadcrumbs staat het goede kruimelpad. Meldt dit ook aan NORA Beheer, waarschijnlijk is er een cache-probleem.
  • Er staat geen kruimelpad. Dan wordt het onjuiste kruimelpad dat je zag door een andere categorie getriggerd.

Waarom mag ik zelf de pagina 'Breadcrumbs' niet aanpassen?bewerken

De pagina Breadcrumbs heeft een vast format, waar je niet van af moet wijken. Niet alleen de formulering van de losse kruimelpaden luisteren nauw, maar ook de volgorde: de wiki geeft de pagina het kruimelpad mee van de eerste categorie die hij in de lijst tegen komt en leest niet verder. De 'diepste' categorie van het kruimelpad moet dus vóór de laag er boven vallen, anders krijgt alles alleen de bovenste laag mee. Er kunnen ook kruimelpad-issues ontstaan wanneer een pagina meerdere categorieën heeft die niet aan elkaar gerelateerd zijn: iets is bijvoorbeeld zowel een standaard als deel van de categorie gegevensmanagement. Dat moet per geval uitgedokterd worden.

Voor de redesign hadden we ook een lijst Breadcrumbs, waar meerdere mensen wijzigingen in aan brachten. Door de jaren heen werd dat een chaos zonder enige structuur, waarin het extreem veel tijd kostte om uit te zoeken waarom het verkeerde kruimelpad werd getoond of zelf of een categorie al was toegevoegd of niet. We willen dat met deze lijst voorkomen en hebben het beheer daarom in één hand gelegd (met een backup die genoeg kennis in huis heeft in het geval van calamiteiten).