Kennishub paginas opbouw
Visueel overzicht van de kennishub
| Ws-header | Vlaanderen\ VLOCA Kennishub | Account/ Log in & out | Hulp nodig? | ||||||||||
| Ws-navmenu | NAV1 | NAV2 | NAV3 | NAV4 | NAV5 | NAV6 | NAV7 | Conditionele nav | Zoeken | ||||
| Ws-sub-header | Titel | ||||||||||||
| Wiki buttons | Knop 1 | Knop 2 | Knop 3 | Knop 4 | Knop 5 | Sidebar | |||||||
| Body | Body | ||||||||||||
| Files | |||||||||||||
| Gegevens over de pagina | |||||||||||||
| Ws-footer | Tools | Footer 1 | Footer 2 | Footer 3 | Footer 4 | Footer 5 | |||||||
De verhouding Body vs sidebar/ panel zit in de settings page, meer informatie op deze pagina.
Alle andere instellingen zitten in de stylesheet
Overzicht van de velden
| Wat aanpassen? | Op welk niveau aanpassen? | Wat wordt er aangepast? | |||||||||||
| Ws-header | Kennishub | De gehele bovense lijn | |||||||||||
| Ws-navmenu | Kennishub | De gehele navigatiebalk met knoppen exclusief zoekknop | |||||||||||
| Ws-sub-header | Pagina | De titel volgens de page template van de pagina (bepaald volgens de settings page) | |||||||||||
| Wiki buttons | Kennishub | De knoppen boven elke body, beheerd door WikiBase | |||||||||||
| Body | Pagina | Per pagina aan te vullen via visual editor en of source editing | |||||||||||
| Ws-footer | Kennishub | De gehele onderste lijn met uitzondering van 'tools' | |||||||||||
| Sidebar | Page Template | De sidebar volgens de gekozen page template) | |||||||||||
| Files | Kennishub | In beheer van WikiBase | |||||||||||
| Gegevens over de pagina | Kennishub | De gegevens over de pagina's volgens de page template (bepaald volgens de settings page) | |||||||||||
| settings page | Kennishub | De instellingen van de page templates | |||||||||||
| stylesheet | Kennishub | De stylesheet: de algemene opmaak van de kennishub | |||||||||||
| page templates | Kennishub | Type pagina's (page templates) | |||||||||||
| Namespaces* | Kennishub | Voorzetsel voor een pagina (bv: Template:) | |||||||||||
*Namespaces zijn in beheer van WikiBase
Source editing
Elke pagina kan bewerkt worden aan de hand van de visual editor. Dit is een intuitieve en eenvoudige manier om inhoud aan pagina's toe te voegen. Wanneer meer complexe inhoud ingevoerd moet worden, kan gebruik worden gemaakt van source editing. Hoe pagina's opmaken en aanvullen vind je op deze pagina terug.
Source editing kan worden geselecteerd door: Via de visual editor (in modus bewerken) naast de save changes knop, de source editor te selecteren of; Achter elke url ?action=edit toe te voegen.
Linken gebruiken
Links kunnen vanuit de visual editor en de source editing toegevoegd worden. Onderstaande voorbeelden zijn opgesteld om voor de source editing.
| Links | Beschrijving | Syntax | ||||||||
| Link naar interne pagina | Wanneer de interne URL* en weer tegeven tekst dezelfde zijn | [[InterneURL]]
| ||||||||
| Link naar interne pagina met andere naam | Wanneer de URL en de pagina naamverschillend zijn | [[InterneURL|tekst weer te geven]]
| ||||||||
| Link naar intern bestand | Linken naar een intern bestand | [[File:InterneURL|tekst weer te geven]]
| ||||||||
| Linken naar een interne afbeelding met preview | Een foto linken zonder tekst, met afmetingen | [[File:InterneURLimage.jpg|1000x1000px]]
| ||||||||
| Link naar externe pagina of bestand | Linken naar Externe URL of bestand Opgelet: één spatie tussen de URL en tekst weer te geven | [ExterneURL SPATIE tekst weer te geven]
| ||||||||
| Mailto | Gestructureerde e-mail draften | {{#widget:link|type=a|href=mailto:e-mail adres?subject=Onderwerp&body=Body e-mail|text=tekst weer te geven}}
| ||||||||
| Templates en widgets | Sjablonen met tekst gebruiken op pagina's | {{InterneUrlTemplate}}
| ||||||||
*Interne URL (geen https://vloca-kennishub.vlaanderen.be/)
URL's zijn hoofdletter- en spatie gevoelig
Templates gebruiken
Een overzicht van alle beheerde templates vind je hier terug.
Properties
De velden die we in de sidebar rechts aanpassen noemen we properties. Deze properties (of attributen) geven ons de mogelijkheid pagina's verder te beschrijven en te categoriseren. Deze properties kunnen gebruikt worden in parser functions. Om deze properties goed te kunnen gebruiken, is het soms nodig deze anders in te stellen. Een aantal voorbeelden:
| Beschrijving | Syntax |
| Property 'datum veld' | [[Has type::Date]]
|
Inline queries/ parser functions
Een inline query gaat informatie ophalen uit de properties van de pagina's. Dit is de metadata gekoppeld aan een pagina: informatie ingegeven in de sidebar maar ook datum van aanmaak, wijziging, auteurs en meer.
Parser function #ask
Deze query laat toe een gerichte zoekopdracht uit te voeren en deze zoekopdracht gestructureerd weer te geven.
Voorbeelden van de #ask functie
Ter illustratie geven we een aantal voorbeelden.
Tabelformaat
| Naam deliverable | Traject | Deliverable | Versie |
|---|---|---|---|
| Aankondiging start publieke review | Andere | Beschrijving | |
| Aanmaak co-creatie pagina op de kennishub | Andere | Beschrijving | |
| Architectuurstandaard | Andere | Beschrijving | |
Meer resultaten ... | |||
Tekstformaat
3D referentie architectuur E-LSP, ANPR, APIMeer resultaten ...
Opbouw en instellingen van de #ask functie
De opbouw en instellingen van een #ask functie zijn hier opgelijst:
| Voorbeeld syntax | Beschrijving | Syntax | ||||||||||||||
| #ask:xxx | Opzoeken op één class (page type) | #ask:[[Class::xxx]]
| ||||||||||||||
| #ask:xxxxxx | Opzoeken op meerdere class (page type) | #ask:[[Class::xxx]][[Class::xxx]]
| ||||||||||||||
| #ask:!xxx | Een class uit de zoekopdracht filteren | #ask:[[Class::!xxx]]
| ||||||||||||||
| #ask: | Opzoeken op alle classes (page type) | #ask:
| ||||||||||||||
| Property:xxx | Filteren op één specifieke property | [[Property:xxx]]
| ||||||||||||||
| Property:xxxProperty:xxx | Filteren op verschillende properties (en) | [[Property:xxx]][[Property:xxx]]
| ||||||||||||||
| Property:xxxORProperty:xxx | Filteren op verschillende properties (of) | [[Property:xxx]]OR[[Property:xxx]]
| ||||||||||||||
| Property:+ | Filteren op alle geldige waarden van een property | [[Property:+]]
| ||||||||||||||
| Property:!xxx | Specifieke property uitsluiten | [[Property:!xxx]]
| ||||||||||||||
| Property:!+ | Filteren op lege waarden | [[Property:!+]]
| ||||||||||||||
| Property:~*xxx | Filteren op geldeeltelijke waarden van een property | [[Property:~*xxx]]
| ||||||||||||||
| mainlabel=xxx | De titel van de kolom met resultaten aanpassen | |mainlabel=xxx
| ||||||||||||||
| mainlabel=- | De titel van de kolom met resultaten verbergen met gebruik van het minteken | |mainlabel=-
| ||||||||||||||
| ?=Weer te geven titel | De hoofwaarde op een andere plaats weergeven | |?=Weer te geven titel
| ||||||||||||||
| ?Property | Een property weergeven in de resultaten | |?Property
| ||||||||||||||
| ?Property=Weer te geven titel | De titel van een property aanpassen | |?Property=Weer te geven titel
| ||||||||||||||
| ?Property # - | De link naar een property afzetten in de zoekresultaten | |?Property # -
| ||||||||||||||
| ?Property # - =Weer te geven titel | De titel van een property aanpassen en de link naar een property afzetten in de zoekresultaten | |?Property # - =Weer te geven titel
| ||||||||||||||
| sort=Property | Sorteren op een property | |sort=Property
| ||||||||||||||
| order=xxxx | Sorteervolgorde: asc of desc | |order=xxxx
| ||||||||||||||
| limit=xx | Aantal weer te geven resultaten | |limit=xx
| ||||||||||||||
| headers=plain | De links in de titelbalk afzetten | |headers=plain
| ||||||||||||||
| searchlabel=Meer resultaten ... | Tekst weer te geven als er te veel zoekresultaten zijn | |searchlabel=Meer resultaten ...
| ||||||||||||||
| default=Geen resultaten | Tekst weer te geven als er geen zoekresultaten zijn | |default=Geen resultaten
| ||||||||||||||
| class=table | Type weergave van de zoekresultaten, zie ook hier | |class=table
| ||||||||||||||
|
Voorbeeld van een volledige inline query | {{#ask:[[Class::VlocaSessie]]
[[SessieType::~*werkgroep]][[Datum::+]]
|mainlabel=Werkgroep
|?Datum # -
|sort=Datum
|order=desc
|limit=5
|headers=plain
|searchlabel=<br>Meer resultaten ...
|default=Geen resultaten
|class=sortable smwtable}}
| ||||||||||||||
Voor meer voorbeelden, zie MediaWiki Website.
Resultaten van de #ask functie opmaken
Resultaten van de #ask functie kunnen worden opgemaakt in verschillende formaten. Dit zijn een aantal voorbeelden die we op de kennishub gebruiken:
| Beschrijving | Syntax |
| Tabel: wikitable smwtable | |class=wikitable smwtable
|
| Tabel: datatable | |class=datatable
|
| Tabel: datatable compact | |class=datatable compact
|
| Tabel: sortable smwtable-clean | |class=sortable smwtable-clean
|
| Tabel: sortable wikitable smwtable | |class=sortable wikitable smwtable
|
| Tabel: sortable table | |class=sortable table
|
| Tabel: datatable compact cell-border | |class=datatable compact cell-border
|
| Tabel: table table-hover table-condensed | |class=table table-hover table-condensed
|
| Andere: tagcloud, enkel pagina naam zonder properties | |class=tagcloud
|
| Lijst met komma's, enkel pagina naam zonder properties | |class=list
|
| Genummerde lijst, enkel pagina naam zonder properties | |class=ol
|
| Bullet points lijst, enkel pagina naam zonder properties | |class=ul
|
| Category (per beginletter), enkel pagina naam zonder properties | |class=Category
|
| Tekst, enkel pagina naam zonder properties | Leeg |
Meer voorbeelden zijn terug te vinden op de MediaWiki Website.
Parser function #show
De #show functie laat toe om informatie uit pagina's op te halen, zoals bijvoorbeeld de titel van een pagina.
| Beschrijving | Syntax |
| Properties ophalen uit een pagina. In dit specifieke voorbeeld willen we voor de huidige pagina de versie nummer weergeven als niet klikbare tekst. | {{#show:{{FULLPAGENAME}}|?Versie # -|default=0}}
|
Voor meer voorbeelden, zie MediaWiki Website.
Extension:ParserFunctions
De Extensie ParserFunctions geeft de mogelijkheid om naast magic words, de #ask en #show functie gegevens op te halen en te vergelijken. Een aantal voorbeelden:
| Voorbeeld | Beschrijving | Syntax |
| ja | Als criteria niet leeg is | {{#if:testwaarde|ja|nee}}
|
| ja | Als criteria's gelijk zijn | {{#ifeq:testwaarde|testwaarde|ja|nee}}
|
| 2024-11-05 | De datum ophalen en weergeven | {{#time:Y-m-d}}
|
| Andere versie |
Aan de hand van een template bepalen wat de versienummer is | {{#switch: {{LoadVersie}}<BR>| V0 = <BR>Dit is versie 0<BR>| V0.1 =<BR>Dit is versie 0.1<BR>| Andere versie<BR>}}
|
Meer voorbeelden op de MediaWiki ParserFunctions pagina.
RSS feeds schrijven
De extensie om RSS en atom feeds te genereren is geinstalleerd. Een feed URL ziet er als volgt uit: https://vloca-kennishub.vlaanderen.be/Special:Ask/-5B-5BClass::!Wiki-5D-5D-20/mainlabel%3D/limit%3D25/order%3Ddescending/sort%3Dmodification-20date/format%3Dfeed/searchlabel%3D-20Geen-20resultaten/type%3Drss/title%3DKennishub/description%3DKennishub-20feed
Dezelfde keywords als inline queries worden gebruikt bij het schrijven van de feed URL. De RSS URL verschijnt enkel automatisch voor recente wijzigingen (op tools klikken, vervolgens op atom, in de URL kan atom vervangen worden door rss). Voor elke pagina kan de rss feed link manueel worden geschreven en getweaked.
Variabelen
Variabelen laten toe om een waarde te bewaren en later op de pagina op te roepen. Een aantal voorbeelden:
| Voorbeeld | Beschrijving | Syntax |
| Een variable waarde opslaan | {{#vardefine:testvar|Testwaarde}}
| |
| Test | Gebruik maken van een variabele waarde | {{#var:testvar}}
|
Iconen gebruiken
De FontAwesome extensie is geinstalleerd zodat het gebruik van iconen mogelijk is. Een template werd opgesteld om deze nog eenvoudiger te gebruiker op de kennishub. Hieronder een aantal voorbeelden en hoe deze op de kennishub kunnen toegegvoegd worden met de source editing.
| Icoon | ID | Syntax |
| plus | {{Fa|plus}}
| |
| lock | {{Fa|lock}}
| |
| envelope | {{Fa|envelope}}
| |
| user | {{Fa|user}}
| |
| arrow-right | {{Fa|arrow-right}}
|
Een uitgebreid overzicht van alle iconen vind je op de FontAwesome website terug.
Tabellen aanmaken
Eenvoudige tabellen toevoegen kan met de visual editor. Deze tabellen zijn verder niet op te maken met de visual editor. Source editing biedt heel wat mogelijkheden in opmaak. Hoe tabellen geprogrammeerd worden, zie je op de MediaWiki hulppagina.
De praktijk leert ons dat gebruikers tabellen vaak in Excel voorbereiden om die achteraf over te zetten op de kennishub. De tabel kopiëren en plakken is helaas geen mogelijkheid. Om die reden hebben wij OSWALD ontwikkeld, een tool die tabellen in Excel exact nabouwt in het juiste voormaat voor de kennishub of andere MediaWiki instanties.
Velden open- en toeklappen
| Voorbeeld | Beschrijving | Syntax |
Klik hier
Veld dat open en toegeklapt kan worden Extra open en toeklap knop
|
Velden open- en toeklappen | <div class="mw-customtoggle-xxx"><b>Klik hier</b></div>
<div class="mw-collapsible mw-collapsible-content mw-collapsed mw-xxx" id="mw-customcollapsible-xxx">
Veld dat open en toegeklapt kan worden
<div class="mw-customtoggle-xxx"><u>Extra open en toeklap knop</u></div>
</div>
|
| .mw-collvl2 { border-width: 2px; |
Opmaak herhaalde toeklapbare velden in [MediaWiki:Common.css] | .mw-collvl2 {
border-width: 2px;
border-style: solid;
border-color: rgb(255, 237, 0);
padding: 0.5em;
margin-bottom: 3px;
}
|
Open- en toeklappen
|
Actieknoppen herhaalde open- en toeklapbare velden | <div class="mw-customtoggle-2">Open- en toeklappen {{Fa|hand-pointer}}</div>
|
Veld dat open- en toegeklapt kan worden
|
Inhoud open- en toeklapbare velden | <div class="mw-collapsible mw-collapsible-content mw-collapsed mw-collvl2" id="mw-customcollapsible-2">
Veld dat open- en toegeklapt kan worden
</div>
|
| NiveauSelecteren | Template met actieknoppen 3 herhaalde niveaus | {{NiveauSelecteren}}
|
Magic words
Magic words zijn heel korte stukken tekst in de source editing die ons toelaten korte informatie weer te geven of pagina instellingen te beheren.
We onderscheiden 3 verschillende types:
Behavior switches
Deze zijn als het ware pagina instellingen die bepalen hoe er met informatie op de pagina wordt omgegaan. De syntax bevat altijd een dubbel laag liggende streep voor en na het sleutelwoord.
Een aantal voorbeelden:
| Beschrijving | Syntax |
| Geen inhoudsopgave weergeven | __NOTOC__
|
| Inoudsopgave op deze plaats weergeven | __TOC__
|
| Vanaf dit punt de pagina niet indexeren voor zoekopdrachten | __NOINDEX__
|
Variables
Dit zijn syntaxen die gebruikt worden om informatie en properties weer te geven van de algemene kennishub of de huidige pagina. Ze zijn op dezelfde manier opgemaakt als templates.
Een aantal voorbeelden:
| Beschrijving | Syntax |
| Huidige jaar weergeven | {{CURRENTYEAR}}
|
| Pagina ID weergeven | {{PAGEID}}
|
| Volledige naam van de pagina weergeven | {{FULLPAGENAME}}
|
| Titel(tabnaam) van de pagina anders weergeven | {{DISPLAYTITLE:title}}
|
Parser functions
Deze laten toe om properties uit andere pagina’s af te lezen en om opgehaalde informatie anders te formatteren (alternatief op parser function #show).
Een aantal voorbeelden:
| Beschrijving | Syntax |
| Pagina naam van een andere pagina weergeven | {{PAGEID: page name }}
|
| Een url in een ander formaat weergeven | {{urlencode:string|QUERY}}
|
Meer voorbeelden op de MediaWiki Magic words pagina.
Meer opmaakregels
Naast al het bovenstaande, is het soms nodig om een aantal opmaakregels te coderen om de inhoud beter weer te geven.
De extra opmaakregels zijn voornamelijk geschreven in HTML. Deze zijn niet hoofdletter gevoelig.
Hieronder een aantal vaak gebruikte regels:
| Beschrijving | Syntax |
| Tussentitels, van h1 tot en met h6 | <h1>xxx</h1>
|
| Tekst in het vet | <b>xxx</b>
|
| Tekst in het cursief | <i>xxx</i>
|
| Tekst onderstreept | <u>xxx</u>
|
| No breaking space |
|
| Break (nieuwe lijn) | <br>
|
Meer opmaakregels vind je op HTML tutorials.
Informatie volgens inlogstatus en gebruikersprofiel
Informatie kan volgens de inlogstatus, gebruiker of gebruikersprofiel gefilterd of weergegeven worden. Een aantal voorbeelden:
| Voorbeeld | Beschrijving | Syntax |
| Huidige bezoeker is niet ingelogd | Tekst weergeven volgens ingelogd of niet ingelogd | {{#ifanon:Huidige bezoeker is niet ingelogd|Huidige bezoeker is ingelogd}}
|
| Huidige bezoeker is geen admin | Tekst weergeven volgens admin of niet admin | {{#ifingroup:sysop|Huidige bezoeker is admin|Huidige bezoeker is geen admin}}
|
Meer voorbeelden op de MediaWiki Extension:UserFunctions pagina.