"Parsed text" is een vooraf gedefinieerde eigenschap. Deze eigenschap is van te voren gedefinieerd (ook bekend als een speciale eigenschap) en komt met extra beheersprivileges, maar kan worden gebruikt net als elk andere door de gebruiker gedefinieerde eigenschap.
K
<style>
/* #vloca_all { opacity: 0.7 } */
.vloca-frame:hover #vloca_all { filter: grayscale(100%); }
.vloca-layer > img {
width: 700px;
}
.vloca-layer { position: absolute; }
</style>
<script src=" https://code.jquery.com/jquery-3.6.0.min.js "
integrity="sha256-/xUj+3OJU5yExlq6GSYGSHk7tPXikynS7ogEvDej/m4="
crossorigin="anonymous"></script>
<img src="/imec_files/kh_nav/vlocanavmap.png" id="vloca_all" >
<img class="vloca-image" src="/imec_files/kh_nav/bouwlaag.png" id="vloca_bouwlaag">
<img class="vloca-image" src="/imec_files/kh_nav/architectuur.png" id="vloca_architectuur">
<img class="vloca-image" src="/imec_files/kh_nav/component.png" id="vloca_component">
<img class="vloca-image" src="/imec_files/kh_nav/capaciteit.png" id="vloca_capaciteit">
<img class="vloca-image" src="/imec_files/kh_nav/vereisten.png" id="vloca_vereisten">
<img class="vloca-image" src="/imec_files/kh_nav/randvoorwaarden.png" id="vloca_randvoorwaarden">
<img class="vloca-image" src="/imec_files/kh_nav/standaard.png" id="vloca_standaard">
<img class="vloca-image" src="/imec_files/kh_nav/organisatie.png" id="vloca_organisatie">
<img class="vloca-image" src="/imec_files/kh_nav/systeemeigenschappen.png" id="vloca_systeemeigenschappen">
<img class="vloca-image" src="/imec_files/kh_nav/principes.png" id="vloca_principes">
<img class="vloca-image" src="/imec_files/kh_nav/vlocausecase.png" id="vloca_vlocausecase">
<img src="/imec_files/kh_nav/emptynav.png" usemap="#image-map">
<map name="image-map" id="image-map">
<area
href="VLOCA_Trajecten"
class="vloca_area" id="vlocausecase"
coords="1081,193,1423,390"
shape="rect">
<area
class="vloca_area" id="principes"
href="VLOCA_Charter"
coords="2514,227,2862,390"
shape="rect">
<area
class="vloca_area" id="organisatie"
href="Organisaties"
coords="135,562,476,755"
shape="rect">
<area
class="vloca_area" id="randvoorwaarden"
href="Randvoorwaarden"
coords="797,559,1138,746"
shape="rect">
<area
class="vloca_area" id="vereisten"
href="Vereisten"
coords="1356,559,1698,752"
shape="rect">
<area
class="vloca_area" id="capaciteit"
href="Capaciteiten"
coords="2012,556,2357,755"
shape="rect">
<area
class="vloca_area" id="standaard"
href="Standaarden"
coords="138,1073,482,1272"
shape="rect">
<area
class="vloca_area" id="component"
href="Componenten"
coords="1045,1076,1383,1266"
shape="rect">
<area
class="vloca_area" id="bouwlaag"
href="Bouwlagen"
coords="1668,1076,2006,1269"
shape="rect">
<area
class="vloca_area" id="architectuur"
href="Open_Smart_City_Architectuur"
coords="2285,1079,2626,1275"
shape="rect">
<area
class="vloca_area" id="systeemeigenschappen"
href="Systeemeigenschappen"
coords="2923,1073,3273,1275"
shape="rect">
</map>
<script type="text/javascript">
class ResponsiveImageMap {
constructor(map, oldWidth, newWidth) {
this.originalWidth = oldWidth;
this.newWidth = newWidth
this.areas = [];
for (const area of map.getElementsByTagName('area')) {
this.areas.push({
element: area,
originalCoords: area.coords.split(',')
});
}
window.addEventListener('resize', e => this.resize(e));
this.resize();
}
resize() {
const ratio = this.newWidth / this.originalWidth;
for (const area of this.areas) {
const newCoords = [];
for (const originalCoord of area.originalCoords) {
newCoords.push(Math.round(originalCoord * ratio));
}
area.element.coords = newCoords.join(',');
}
return true;
};
}
$(document).ready(function(){
$('.vloca-image').hide();
var map = document.getElementById('image-map');
new ResponsiveImageMap(map, 3432, 700);
$('.vloca_area').mouseover(function() {
$('#vloca_' + $(this)[0].id).fadeIn(200);
}).mouseout(function(){
$('#vloca_' + $(this)[0].id).fadeOut(100);
});
});
</script>
Kandidaatstandaarden
VLOCA zal vanaf 2023 open city architectuurstandaarden opleveren.
Deze pagina wordt verder aangevuld. +
Kennishub Page types
Inhoud
1 Page types pagina
2 Settings page instellingen
3 Page properties template
4 Sidebar template
5 Overzicht van de classes en properties
6 Sidebars aanpassen via de Javagen tool
Page types pagina
De page types pagina geeft een overzicht van alle page types op de kennishub.
Op deze pagina kan je nieuwe page types aanmaken en aanpassen.
Veld
Beschrijving
New page type
Voeg een nieuwe page type toe, settings page, Page properties en Sidebar template worden aangemaakt
Settings page
Op deze pagina vind je de algemene instellingen terug voor de nieuwe template
Defines class
Elke page type is gelinkt aan een class. Een class zorgt voor de categorising van de pagina's. Zo kan informatie gequieried worden
Base properties template
De algemene properties voor alle classes
Page properties template
Op deze pagina wordt ingesteld welke properties opgeslagen worden en op welke manier
Sidebar template
De sidebar template bepaalt alle velden aan de rechterkant van het scherm (=de sidebar)
Settings page instellingen
Deze tabel geeft een overzicht van de mogelijke instellingen voor een settings page. Deze vullen we manueel aan.
Beschrijving
Syntax
De class waar naar vernoemd wordt, deze class halen we op om properties te laden
Defines class=
Bij aanmaak van een nieuwe pagina wordt een titel gekozen. Deze resulteert in een pagina titel en een URL. Opties zijn: Pagetitle format=next_available --> Wanneer er een nieuwe pagina, wordt de volgende beschikbare nummer gekozen in de URL Pagetitle format=title --> De gekozen titel verschijnt in de URL, kan niet meer worden aangepast!
Pagetitle format=
Namespace gebruiken voor een uniforme structuur in URL's: Geen namespace: Allowed namespaces=(Main) --> vloca-kennishub.vlaanderen.be/Pagina NamespaceX: Allowed namespaces=NamespaceX --> vloca-kennishub.vlaanderen.be/NamespaceX/Pagina
Allowed namespaces=
Bepaalt de display naam (voor de leesbaarheid, bijvoorbeeld de lijst met classes uit te kiezen bij aanmaak nieuwe pagina)
Displays as=
Bepaalt de structuur van de pagina: willen we een sidebar zien?
Layout areas='sub-header sidebar' 'main sidebar'
Verhouding van de body en de sidebar
Layout columns=3fr 1fr
Verhouding van de body en de sidebar
Layout rows=auto 1fr
Voorbeeld
{{Class definition
|showonselect=1
|Defines class=VlocaSessie
|Pagetitle format=next_available
|Allowed namespaces=VlocaSessie
|Displays as=VLOCA-Sessie
|Layout areas='sub-header sidebar' 'main sidebar'
|Layout columns=3fr 1fr
|Layout rows=auto 1fr
}}
Page properties template
De page properties worden manueel aangevuld.
De sleutelwoorden (csv) en +sep=, worden gebruikt wanneer verschillende properties in de sidebar gekozen mogen worden op pagina niveau.
Voorbeeld
<noinclude>
{{Managed
|Version=1.0
|Version notes=1.0 - First managed version
|Short description=
}}
<pre>
{{VlocaSessie properties
|Actoren= <text> (csv)
}}
</pre>
</noinclude>
<includeonly>
{{#set:
|Actoren={{{Actoren|}}}|+sep=,
}}
{{DISPLAYTITLE:{{{Title|}}}|noreplace}}
</includeonly>
Sidebar template
De code in de sidebar template is complexer en langer dan de page properties template.
Om de leesbaarheid van de pagina te bewaken en omdat er een geautomatiseerd proces is voor het opstellen van deze sidebar templates, wordt de sidebar template niet volledig beschreven.
Overzicht van de classes en properties
De onderstaande matrix geeft een overzicht van alle page types/ classes die op de kennishub zijn aangemaakt en welke properties eraan gekoppeld zijn.
Class-props en Base-props
Class props omvat alle props welke in de class definition zijn vastgelegd. De base props gaan om de inherente props van een pagina, zoals de titel en de class waar deze toe behoort, welke dus - in turn - de class props bepaald.
Base props zijn zodoende props welke voor iedere pagina bestaan en class props niet.
Sidebars aanpassen via de Javagen tool
Om sidebars eenvoudig te kunnen aanpassen, werd de Sidebar generator ontwikkeld.
De Sidebar generator is een matrix met instellingen. Die instellingen worden samengebracht in een code die in een bronbestand samenkomen.
Dit bronbestand kan integraal worden gekopiëerd in de respectievelijke Sidebar templates.
Een meer gedetailleerd overzicht is terug te vinden op de VLOCA SharePoint (vloca@vlaanderen.be voor toegang).
Kennishub paginas aanpassen
Inhoud
1 Voeg een pagina toe
2 Aanpassen van de essentiële metadata/ parameters
3 Structuur van de pagina’s
4 Opmaak van de pagina’s
4.1 Kies je opmaakstijl
4.2 Verfijn je opmaak
4.3 Voeg een koppeling toe
4.3.1 Voeg een VLOCA kennishub koppeling toe
4.3.2 Voeg een koppeling toe als uitwendige pagina
4.4 Voeg een referentie toe
4.5 Voeg andere gegevens of media toe
4.6 Voeg speciale tekens in
5 Wijzigingen opslaan
Voeg een pagina toe
1) Druk op: Nieuwe pagina
2) Geef een titel mee ( pas op, deze wordt gebruikt in de hyperlink! )
3) Kies je type pagina ( goed kiezen! ) en geef het de juiste naam
4) Bevestigen
Pagina type
Titel (zonder komma's)
Termen en Concepten
Vrij te bepalen
Organisatie
Vrij te bepalen
Standaard
Officiële benaming
Externe initiatieven
Officiële benaming
Aanpassen van de essentiële metadata/ parameters
Eens de nieuwe pagina aangemaakt, kan je rechts de knop bewerken terugvinden. Daar kan je de velden met metadata aanvullen. Elke type pagina heeft andere metadata dat aan te vullen is. Een aantal voorbeelden van velden:
Onder je type pagina (bv organisatie) kan je de paginatitel aanpassen (niet de hyperlink)
Checkbox ‘is tag’: kan je vanuit andere pagina’s navigeren naar deze pagina en kan ik de naam van deze pagina gebruiken als tag in de metadata van andere pagina’s?
Tags: welke andere pagina’s wil ik in deze pagina ‘taggen’?
Files (upload): wil ik bestanden op deze pagina (naast afbeeldingen) opladen?
Structuur van de pagina’s
Trajecten
Volgende regels zorgen ervoor dat alle trajectpagina’s uniform worden opgesteld:
Content op de pagina: Algemene intro, maximum 2 paragrafen
Links naar de workshops (voor benaming: kijk bij aanmaken nieuwe pagina)
Links naar de draaiboeken (voor benaming: kijk bij aanmaken nieuwe pagina)
Link naar de trajectpagina (parameter: website) op de sidebar rechts
Aanvullen van alle andere parameters indien gekend
Opmaak van de pagina’s
De titel van de pagina wordt aangeduid met de opmaalstijl “Titelpagina”.
De headers (van kop (h1) tot onderkop 4 (h5) wordt gebruikt om structuur in de pagina’s te geven en verschijnt automatisch in de inhoudsopgave (die tevoorschijn komt bij gebruik van minstens 2 koppen).
Andere opmaakregels worden hieronder toegelicht.
Je kan heel eenvoudig tekst, opmaak, links en afbeeldingen toevoegen eens je op de knop bewerken hebt gedrukt (let op, je kan niet zomaar elke pagina bewerken).
Kies je opmaakstijl
Verfijn je opmaak
Voeg een koppeling toe
Voeg een VLOCA kennishub koppeling toe
Deze link verwijst naar een andere pagina op de kennishub. Koppelingen of links kunnen zowel blauw als rood kleuren:
De link kleurt blauw: de pagina bestaat al als tag
De link kleurt rood: de pagina bestaat nog niet op de kennishub, deze kan worden toegevoegd.
Voeg een koppeling toe als uitwendige pagina
Je kan een koppeling toevoegen die verwijst naar een externe pagina.
Voeg een referentie toe
Je kan referenties toevoegen. Opgepast, je zal ook een referentielijst moeten toevoegen (onder de knop invoegen/ referentielijst).
Voeg andere gegevens of media toe
Afbeelding en media
Een reeds opgeladen mediabestand invoegen of een nieuw mediabestand opladen en invoegen, opmaak kan aangepast worden na selectie van afbeelding
Sjabloon
Een sjabloon kan een stuk herbruikbare tekst zijn of extra informatie weergeven (zoals een Youtube video) {{Video|Url=https://www.youtube.com/embed/yZTfyZCaSLY}}
Opmerking
Een visuele opmerking invoegen aan je tekst
Tabel
Voeg een tabel in
Snippet
Voeg een stukje code toe om extra functionaliteiten toe te voegen
Galerij
Voeg een afbeelding of verschillende afbeeldingen in met opmaak en afspeelmogelijkheden
Codeblok
Voeg een blok code in (bijvoorbeeld embedding van een video)
Uw handtekening
Voeg automatisch je naam en datum en uur in
Referentielijst
Voeg een automatische referentielijst in
Voeg speciale tekens in
Wijzigingen opslaan
Door twee keer op wijzigingen opslaan te drukken, kan je je pagina opslaan en visualiseren.
Om je wijzigingen te controleren (als je dus een bestaande pagina bewerkt), kan je op wijzigingen controleren drukken voor je de tweede keer op wijzigingen opslaan drukt.
Kennishub paginas opbouw
Inhoud
1 Visueel overzicht van de kennishub
2 Overzicht van de velden
3 Source editing
4 Linken gebruiken
5 Templates gebruiken
6 Properties
7 Inline queries/ parser functions
7.1 Parser function #ask
7.1.1 Voorbeelden van de #ask functie
7.1.2 Opbouw en instellingen van de #ask functie
7.1.3 Resultaten van de #ask functie opmaken
7.2 Parser function #show
7.3 Extension:ParserFunctions
7.4 RSS feeds schrijven
8 Variabelen
9 Iconen gebruiken
10 Tabellen aanmaken
11 Velden open- en toeklappen
12 Magic words
13 Meer opmaakregels
14 Informatie volgens inlogstatus en gebruikersprofiel
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 , API Meer 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:xxx Property:xxx
Filteren op verschillende properties (en)
[[Property:xxx]][[Property:xxx]]
Property:xxx OR Property: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
Werkgroep Datum Thematische werkgroep 3 2024-12-19 Thematische werkgroep 3 2024-12-10 Thematische werkgroep 3 2024-12-03 Thematische werkgroep 2 2024-11-21 Thematische werkgroep 2 2024-11-12 Meer resultaten ...
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-05-03
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;
border-style: solid;
border-color: rgb(255, 237, 0);
padding: 0.5em;
margin-bottom: 3px;
}
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 .
Kennishubgovernance
Op de kennishub onderscheiden we 2 verschillende rollen voor geregistreerde gebruikers. Anonieme gebruikers hebben enkel leesrechten op de kennishub. Geregistreerder gebruikers zijn ofwel reviewer, of contributor :
contributor: Contributors leveren een bijdrage aan het platform door het registreren van aanvragen, het editeren en toevoegen van pagina's en het deelnemen aan de discussies. Contributors verkrijgen een account en toegang tot de kennishub door via het VLOCA portaal te registreren.
reviewer: Reviewers zijn verantwoordelijk voor het nakijken en goedkeuren van page edits en het begeleiden van contributors in het aanleveren van kwalitatieve content. Reviewers worden geselecteerd op basis van neutraliteit en bevestigde expertise.
Bijdragen aan de kennishub werkt via het systeem van approved revisions. Bij het registreren van een aanvraag tot co-creatie rond een initiatief via het aanvraag formulier, wordt op basis van de ingevulde velden en secties een Mediawiki pagina aangemaakt.
Contributors zorgen voor de content, die na een goedkeuring door een reviewer als "approved revision" geldt. De revisies die gemarkeerd zijn als "approved revision" zijn voor iedereen leesbaar.
Consensus m.b.t. welke pagina geldt als goedgekeurde versie, wordt verkregen op de discussiepagina, waaraan contributors en reviewer kunnen bijdragen. In essentie is deze discussie vrij.
Deze pagina wordt herzien en verder aangevuld. +
Deze richtlijnen worden momenteel opgemaakt in een co-creatie proces. Aanbeveling dus onder voorbehoud. Deze worden momenteel geregeld geüpdatet. Naar het einde van 2021 toe worden deze richtlijnen gefinaliseerd.
Binnen VLOCA Water in de stad wordt een belangrijk onderscheid gemaakt tussen historische data en real-time data.
Historische data
In de meeste gevallen volstaat voor historische data een postgres database of gelijkwaardig. Indien er veel gebruikt gemaakt wordt van GIS data, kan het nuttig zijn om gebruik te maken van een PostGIS extentie. GIS data is ook data, en ergens heeft het geen speciale behandeling nodig. Doch, ervaring leert dat bepaalde queries of berekeningen veel efficiënter gebeuren door gespecialiseerde database structuren. Vandaar deze aanbeveling.
Voor een geschikt database model kan er in eerste instantie gekeken worden naar de vereiste VLOCA metadata die aangeraden worden, om een eerste lijst te hebben van belangrijke velden om bij te houden.
Real-time data
Als er over real-time data gesproken wordt, zijn databases die efficiënt om kunnen met tijdsreeksen een pluspunt. Databases zoals InfluxDB , Timescale Postgres of Apache Druid of gelijkwaardig kunnen dienst doen. +
Wat is een Knowledge Graph
Een knowledge graph vertegenwoordigt een verzameling onderling verbonden beschrijvingen van entiteiten - real-world objecten, gebeurtenissen, situaties of abstracte concepten. Om deze abstracte definitie te illusteren hier een diagram van een knowledge graph [1] van boeken en hun auteurs.
© Enterprise Knowledge LLC
In een dergelijk model hebben de beschrijvingen een formele structuur, waardoor zowel mensen als computers ze op een efficiënte en ondubbelzinnige manier kunnen verwerken.
De Entiteitsbeschrijvingen dragen bij aan elkaar en vormen een netwerk, waarbij elke entiteit een deel vertegenwoordigt van de beschrijving van de entiteiten die daarmee verband houden. b.v. Oscar Wilde was geboren in Ierland .
In de context van Smart Cities, deze knowledge graph is geordend volgens naar de relevante domeinen (bv. luchtkwaliteit), en specifieke relevante entiteiten (bv. locatie, PM10 waarde)
Sleuteleigenschappen
Een knowledge graph combineert kenmerken van verschillende gegevens paradigma's en kunnen worden begrepen als een:
Database , omdat de gegevens kunnen worden opgevraagd via gestructureerde zoekopdrachten;
Graaf [2] , omdat het kan worden geanalyseerd als elke andere netwerkgegevensstructuur;
Kennisbank , omdat de gegevens erin een formele betekenis(semantiek) hebben, die kan worden gebruikt om de gegevens te interpreteren en nieuwe feiten af te leiden.
Wanneer formele semantiek wordt gebruikt om de gegevens van een knowledge graph uit te drukken en te interpreteren, zijn er een aantal representatie- en modelleerinstrumenten:
Klassen
Meestal bevat een entiteitsbeschrijving een classificatie van de entiteit met betrekking tot een klassehiërarchie. Bij algemene nieuws- of bedrijfsinformatie kunnen er bijvoorbeeld klassen Persoon, Organisatie en Locatie zijn. Personen en Organisaties kunnen een gemeenschappelijke superklasse Agent hebben. Locatie heeft meestal tal van subklassen, b.v. Land, bevolkte plaats, stad, enz. Het begrip klasse wordt ontleend aan het objectgeoriënteerde ontwerp, waarbij elke entiteit tot precies één klasse behoort te behoren.
Relaties
De relaties tussen entiteiten zijn meestal gekenmerkt met typen, die informatie geven over de aard van de relatie, b.v. vriend, familielid, concurrent, etc. Relatietypen kunnen ook formele definities hebben, b.v. dat ouder-van een omgekeerde relatie is van kind-van, het zijn beide speciale gevallen van familielid van, wat een symmetrische relatie is.
Categorieën
Een entiteit kan worden geassocieerd met categorieën, die een bepaald aspect van zijn semantiek beschrijven, b.v. “Openbaar Vervoer” of “19e eeuwse componisten”. Een boek kan tegelijkertijd tot al deze categorieën behoren: "Boeken over Afrika", "Bestseller", "Boeken van Italiaanse auteurs", "Boeken voor kinderen", enz. Vaak worden de categorieën beschreven en gerangschikt in een hierarchische ordening(taxonomie)
Vrije tekst
Het is mogelijk ‘mensvriendelijke tekst’ toe te voegen om de intenties voor de entiteit verder te verduidelijken en het zoeken te verbeteren.
Ontologieën
Een Ontologie kan beschouwd worden als de abstracte definitie van een knowledge graph, op basis van dewelke nieuwe knowledge graphs kunnen aangemaakt worden. Het dient als een formele definitie tussen de ontwikkelaars van de knowledge graph en zijn gebruikers. Een gebruiker kan een ander mens zijn of een softwaretoepassing die de gegevens op een betrouwbare en nauwkeurige manier wil gebruiken. Het zorgt voor een gedeeld begrip van de gegevens en de betekenis ervan. In het bovenstaande voorbeeld kan de ontologie als volgt worden gedefinieerd
© Enterprise Knowledge LLC
↑ http://enterprise-knowledge.com/whats-the-difference-between-an-ontology-and-a-knowledge-graph
↑ https://nl.wikipedia.org/wiki/Grafentheorie
A knowledge describing books and their relationships +