Sjabloon:Onderwerp-kader: verschil tussen versies
(Hele toelichting herschreven op basis van ervaringen tot nu toe) |
(als geen Contactpersoon als semantische eigenschap, dan setten) |
||
Regel 155: | Regel 155: | ||
{{{Onder inhoudsopgave|}}} | {{{Onder inhoudsopgave|}}} | ||
</div> | </div> | ||
{{#if:{{{Contactpersoon|}}}| |{{#set:Contactpersoon={{{contactpersoon|}}}}} }} | |||
</includeonly> | </includeonly> |
Huidige versie van 27 nov 2024 om 10:11
Deze sjabloon zorgt dat pagina's binnen een onderwerp/thema een uniform navigatiemenu krijgen, rechts in beeld. Het sjabloon is bedoeld om bepaalde aspecten herkenbaar en uniform te houden, terwijl er wel genoeg flexibiliteit is om voor een onderwerp unieke eigenschappen te tonen.
Sjabloon gebruiken[bewerken]
Maak een sjabloon voor het onderwerp zelf om op alle pagina's te gebruiken, en roep daarin deze sjabloon op door de volgende code toe te voegen en in te vullen:
{{Onderwerp-kader |Onderwerp= |Is onderdeel van= |Categorie= |Status actualiteit={{{Status actualiteit|}}} |Status toelichting={{{Status toelichting|}}} |Afbeelding={{{Afbeelding|voorbeeldplaatje.png}}} |Afbeelding-link= |Afbeelding-onderschrift= |contactpersoon= |contactpersoon-link= |contact= |cc= |Boven inhoudsopgave= ;Voorbeeld extra eigenschap :Extra eigenschap ;Voorbeeld derde eigenschap :{{{Eigenschap|}}} |Onder inhoudsopgave= }}
Uitleg bij de variabelen[bewerken]
Om de nodige flexibiliteit te leveren kent dit sjabloon veel variabelen, oftewel zaken die je invult na het rechtopstaande pijpje. Alles wat verplicht is, staat hieronder in bold aangegeven, wat optioneel is staat in cursief. Optionele variabelen kun je leeg laten als je ze niet gebruikt, of zelfs helemaal weglaten (inclusief pijpje en =teken).
De eerste groep variabelen gaan over het onderwerp waar het navigatiemenu voor bedoeld is:
- Onderwerp=Naam van onderwerp
- Is onderdeel van= Het bovenliggende hoofdonderwerp waar dit onderwerp binnen valt, zoals bijv. Lijsten & Verwijzingen boven het onderwerp Standaarden. (optioneel)
- Categorie=Naam van de categorie voor het onderwerp, als die niet gelijk is aan de naam van het onderwerp (optioneel).
De volgende variabelen gaan over de pagina waaraan het sjabloon is toegevoegd en kunnen dus verschillen per pagina waarop je het navigatiemenu toont. Dat doe je door een eigenschap op te nemen, waarvan de waarde getoond wordt van de pagina zelf. Je herkent een eigenschap binnen een sjabloon aan de drie accolades voor en na de naam. Voeg ook een opstaand pijpje (|) toe zodat er geen foutmelding ontstaat als de eigenschap geen waarde heeft. Waar zinnig kun je na het pijpje een default-waarde invullen, die getoond wordt als de eigenschap niet in ingevuld op de pagina. Als de eigenschap voor dit onderwerp nooit relevant gaat zijn kun je ook de eigenschap helemaal weglaten en de variabele op sjabloonniveau invullen of leeg laten. Als de eigenschap wel relevant is, maar niet als semantische eigenschap geset is, dan kun je het ook als invoer-variabele opnemen in het sjabloon voor je navigatiemenu.
Onder het kopje Status worden getoond:
- Status actualiteit= Toont de Eigenschap:Status actualiteit als je de code {{{Status actualiteit|}}} invult. NB: deze eigenschap heeft maar vier toegestane waarden en geeft een foutmelding bij andere input.
- Status toelichting= Toont de Eigenschap:Status toelichting als je de code {{{Status toelichting|}}} invult. NB: als binnen dit onderwerp geen pagina's met een ingevulde status actualiteit verwacht worden kun je die leeglaten en in deze eigenschap een alternatieve tekst plaatsen, of zelfs een andere eigenschap.
De afbeelding in het navigatiemenu komt uit de volgende variabelen:
- Afbeelding= Toont een afbeelding uit de Eigenschap:Afbeelding of handmatig gezet als format afbeelding.png (of.jpg et cetera). Als er geen afbeelding wordt ingevuld ontstaat een dode link, omdat een afbeelding essentieel is voor de gebruikerservaring.
- Afbeelding-link=Pagina waarheen de afbeelding linkt. (Optioneel: standaard is dit gelijk aan 'Onderwerp'.)
- Afbeelding-onderschrift=Tekst die onder de afbeelding wordt getoond, als dat nodig is. (Optioneel)
Onder het kopje Contact worden de volgende variabelen getoond, die optioneel zijn zodat je degene(n) kunt kiezen die beschikbaar is:
- contactpersoon= Voornaam Achternaam of de Eigenschap:Contactpersoon met de code {{{Contactpersoon| }}}(NB: je kunt hier ook een link naar een gremium invoeren, of een
- contactpersoon-link=Gebruiker:gebruikersnaam (optioneel; maak leeg als je het niet gebruikt!)
- contact=naam@organisatie.nl (NB: hier kan alleen een correct mailadres staan in dit format. Alle andere opties, inclusief nette mail-links met mailto of sjabloon maillink, levert een gebroken code op die niet netjes staat. Heb je een mailadres in een ander format, of andere contactgegevens zoals telefoonnummers en twitteraccounts, zet ze dan achter de = van contactpersoon, desnoods na het oproepen van de eigenschap contactpersoon. Dat geldt ook voor het oproepen van eigenschappen waarvan het format wisselt, zoals Eigenschap:Contactgegevens.)
- cc=Mailadres dat in de cc toegevoegd moet worden bij de maillink. Standaard is dit nora@ictu.nl.
Tenslotte is er ook nog plaats voor andere eigenschappen of meldingen, die je op twee plaatsen neer kunt zetten: Boven de inhoudsopgave of er onder. Als je een kopje wilt toevoegen gebruik dan een puntkomma voor de naam van de kop, zet de waarde onder het kopje in de regel er onder met een dubbele punt er voor om in te springen:
- Boven inhoudsopgave= Alles wat je boven de inhoudsopgave wilt plaatsen.
- Onder inhoudsopgave= Alles wat je onder de inhoudsopgave wilt plaatsen.
Inhoudsopgave[bewerken]
Er hoort een inhoudsopgave aan de onderkant van het navigatiemenu. Dat heeft ook netjes de 'navigation' rol voor toegankelijkheid. Het sjabloon toont ofwel een op maat gemaakte inhoudsopgave van het onderwerp, ofwel de inhoudsopgave van het bovenliggende onderwerp. Het sjabloon zoekt eerst of er een inhoudsdopgave is van dit onderwerp, ontbreekt die dan pakt hij het bovenliggende onderwerp (is onderdeel van=).
Een inhoudsopgave zoeken, maken of aanpassen:
- Ga naar de pagina met dezelfde naam als je onderwerp.
- Kopieer de titel en vul dit in het zoekveld in, vul direct er achter aan /inhoudsopgave. Bijvoorbeeld: Lijsten & Verwijzingen/inhoudsopgave).
- Maak de pagina aan of bewerk deze. Check het voorbeeld (Lijsten & Verwijzingen/inhoudsopgave) voor het format van de inhoudsopgave en het sjabloon Navigatiepagina.
- Voor meer voorbeelden kun je de categorie:Inhoudsopgaves bekijken.
CSS die gebruikt is in Mediawiki:Common.css om dit sjabloon mogelijk te maken[bewerken]
.onderwerp-toc { border-top: gray 1px solid; } .onderwerp-toc ul { margin-top: 0; margin-left: 10px; list-style-type: none; list-style-image: none; }
Voorbeeld[bewerken]
- Onderdeel van
- Naam bovenliggend onderwerp
- Contact
- Voornaam Achternaam
- naam@organisatie.nl
- Status
- Voorbeeld extra eigenschap
Extra eigenschap
- Voorbeeld derde eigenschap
Bij voorbeeld een submenu.
Hieronder zie je het resultaat wanneer je de volgende code invoert:
{{Onderwerp-kader |Onderwerp=Naam van onderwerp |Is onderdeel van=Naam bovenliggend onderwerp |Categorie=Naam van de categorie voor het onderwerp |Status actualiteit={{{Status actualiteit|}}} |Status toelichting={{{Status toelichting|}}} |Afbeelding=foobar.png |contactpersoon=Voornaam Achternaam |contactpersoon-link= |contact=naam@organisatie.nl |cc=nora@ictu.nl |Boven inhoudsopgave= ;Voorbeeld extra eigenschap: Extra eigenschap ;Voorbeeld derde eigenschap: {{{Eigenschap|}}} |Onder inhoudsopgave=Bij voorbeeld een submenu. }}