Help:Semantische sjablonen

{{SMW user TOC (nl)}}

'''Semantische sjablonen''' zijn een methode om (delen van) de toegevoegde opmaak die [[Semantic MediaWiki]] introduceert, mee te nemen in [[meta:Help:Template|MediaWiki-sjablonen]]. Dit heeft een aantal voordelen:

* gebruikers specificeren annotaties zonder nieuwe syntax te hoeven leren,
* annotaties worden consistent gebruikt, dus gebruikers hoeven niet et zoeken naar de juiste eigenschappen of categorie&euml;n bij het bewerken van een pagina,
* omdat sjablonen ook andere functies hebben, zoals het weergeven van flitsende infoboxjes in een artikel, zijn gebruikers gemotiveerd om ze te gebruiken.

Om deze redenen raden we aan dat u semantische sjablonen gebruikt bij het introduceren van semantiek in een wiki.

== Eenvoudige semantische sjablonen &ndash; een voorbeeld ==

Sjablonen, met of zonder semantiek, kunnen een erg eenvoudige vorm hebben. Bijvoorbeeld bij het geven van de waarde van de oppervlakte van een astronomisch object in een wikipagina, wilt u dat misschien weergeven als

: 6.088&nbsp;×&nbsp;10<sup>18</sup>&nbsp;m²
hetgeen u kunt bereiken door te schrijven
  <nowiki>6.088&nbsp;×&nbsp;10<sup>18</sup>&nbsp;m²</nowiki>

Dit is omslachtig om te schrijven, dus u zou een sjabloon Template:Oppervlakte kunnen ontwikkelen voor oppervlaktes zodat redacteuren simpelweg dit kunnen schrijven:
  
  <nowiki>{{surface area|6.088|18}}</nowiki>
en het sjabloon springt om naar uw gewenste opmaak.

MediaWiki-sjablonen hebben dus een immense waarde voor het normaliseren en simplificeren van de weergave in elke wiki (zodra gebruikers de sjabloon-syntax begrijpen).

Met de introductie van Semantic MediaWiki wilt u waarschijnlijk dat waardes voor 'oppervlakte' semantische annotaties worden zodat ze verschijnen in de factbox en dat u erop kunt zoeken. 
U zou dus een semantische [[Help:Eigenschappen en types|eigenschap]] kunnen maken met de naam [[Property:Oppervlakte]] die een aangepast datatype [[Type:Oppervlakte]] (her)gebruikt.
Natuurlijk wenst u zowel de annotatie te hebben als de visuele representatie.
U zou het volgende kunnen schrijven:

  <nowiki>[[Oppervlakte::6.088e18 m²|6.088&nbsp;×&nbsp;10<sup>18</sup>&nbsp;m²]]</nowiki>

de semantische annotatie gebruikt het wetenschappelijke formaat voor een [[Type:Number|getal]] waar Semantic MediaWiki mee om kan gaan en de alternatieve tekst na het pijplijnsymbool '|' is de complexe weergave die u wilt.

Maar dit is nog minder gebruiksvriendelijk en zeer vatbaar voor fouten. Met gebruikmaking van semantische sjablonen kunt u het Oppervlakte-sjabloon schrijven of aanpassen zodat de gecompliceerde opmaak verborgen wordt ''en'' de semantische annotatie tot stand brengen.
Dan kunnen redacteuren, net als eerst, schrijven:

 <nowiki>{{oppervlakte|6.088|18}}</nowiki>

wat veel leesbaarder is. Om dit voor elkaar te krijgen, is [[Template:Oppervlakte]] als volgt gecodeerd:
  <nowiki>[[Oppervlakte::{{{1}}}e{{{2}}} m²|{{{1}}}&nbsp;×&nbsp;10<sup>{{{2}}}</sup>&nbsp;m²]]</nowiki>
  
Zie de voorbeeldpagina [[Sol]] en bekijk de bron om dit semantische sjabloon in werking te zien.

Merk op dat de eigenschap "oppervlakte::" in het sjabloon niet het sjabloonartikel zelf annoteert; het treedt pas in werking wanneer het ingevoegd wordt. Dit is omdat de standaardinstelling bij het installeren van Semantic MediaWiki is dat SMW de pagina's in de Template:-naamruimte niet analyseert op semantische annotaties. Mocht deze instelling gewijzigd zijn (door de site-beheerder) dan dient u om de sjablooncode heen <tt><nowiki><includeonly></nowiki></tt>-tags te zetten om te voorkomen dat het sjabloonartikel zelf geannoteerd wordt. Zoals bij een gewoon MediaWiki-sjabloon kunt u tekst toevoegen binnen <tt><nowiki><noinclude></nowiki></tt>-tags om gebruikersdocumentatie aan te bieden op de sjabloonpagina.

== Ingewikkeldere semantische sjablonen ==

Veel MediaWiki-sites maken gebruik van gecompliceerdere sjablonen om standaardinformatie te tonen. Wikipedia-artikelen over steden en dorpen gebruiken bijvoorbeeld standaardsjablonen waarin redacteuren algemene informatie-items invullen, zoals deze (van [[wikipedia:San Diego, California]]):

<pre><nowiki>{{Infobox Settlement
|image_skyline            = Sandiego_skyline_at_night.JPG‎
|imagesize                = 
|image_caption            = San Diego Skyline | March 31, 2007
|official_name            = City of San Diego
|settlement_type          = [[City]]
|nickname                 = America's Finest City
|motto                    = Semper Vigilans ([[Latin]]: Ever Vigilant)
|image_flag               = Flag of San Diego, California.png
...</nowiki></pre>

Normaal gesproken geeft het sjabloon (in dit geval [[wikipedia:Template:Infobox Settlement]]) deze informatie weer in een netjes opgemaakte tabel. Natuurlijk zijn zulke volgens vaste patronen ingedeelde stukjes informatie ideaal om getransformeerd te worden naar eigenschappen in Semantic MediaWiki zodat artikelen die het sjabloon gebruiken semantische annotaties verkrijgen zonder enige wijzigingen in hun pagina's.

De voorbeeldpagnia [[California]] toont een [[Template:Infobox U.S. state|eenvoudig "infobox"-weergavesjabloon]] dat is aangepast om semantische annotaties te maken.

== Correct gebruik van semantische sjablonen ==

Hoewel het patroon hierboven u in staat stelt om alle soorten semantische sjablonen te maken van willekeurige complexiteit, zijn er nog wat punten om rekening mee te houden.

=== Automatische annotatie vereist strikte formaten ===

U kunt sjabloonvelden automatisch annoteren, maar in dit geval moeten de aangeboden waarden voldoen aan het verwachte formaat. Het is bijvoorbeeld een goed idee om het [[Property:population|aantal inwoners]] van een stad te annoteren met een eigenschap van type 'number'. Echter, in een infobox-sjabloon als die op [[wikipedia:France]], is de opgegeven waarde voor aantal inwoners geen enkel getal, of zelfs maar een set van getallen! In plaats daarvan zijn er meerdere getallen en tekstuele toelichting van wat ze betekenen. Zulke speciale gevallen moeten in gedachten gehouden worden bij het ontwerpen van semantische sjablonen.

Er is daarnaast een belangrijke reden waarom semantische sjablonen geen passende vervanging zijn voor annotaties in Semantic MediaWiki. Er zijn gevallen waar bestaande sjablonen ge&euml;valueerd kunnen worden op een behoorlijk semantische wijze, maar vaak moet de gebruiker nog semantische opmaak toevoegen om de gegevens machine-verwerkbaar te maken. In het geval van Frankrijk, zou men kunnen beslissen om "aantal inwoners" een normaal tekstveld te laten zijn en het aan de gebruiker over te laten om <nowiki>[[aantal inwoners::...]]</nowiki> te specificeren waar dat van toepassing is in deze tekst.

=== Optionele invoer en voorwaardelijken ===

In het algemeen is het bij sjablonen erg nuttig om optionele parameters toe te staan. Bij veel artikelen willen of kunnen gebruikers niet alle mogelijke waarden van een gegeven infobox invullen, en het zou vreemd zijn om lege regels te laten zien in zulke gevallen. Erger nog, semantische sjablonen zouden waarschuwingsberichten genereren vanwege het feit dat een lege waarde is geannoteerd. Om dit te voorkomen is het nuttig om "voorwaardelijken" te introduceren in de sjablooncode, die een regel (en de annotatie ervan) alleen meenemen als een niet-lege waarde werd ingevoerd.

Dit kan worden bereikt met hulp van de [[meta:Help:ParserFunctions|ParserFunctions]]-uitbreiding op MediaWiki. Het gebruik van deze uitbreiding is volledig onafhankelijk van Semantic MediaWiki, en u kunt de originele documentatie van deze uitbreiding raadplegen voor meer informatie. Wikipedia bevat vele voorbeelden van parser-functies in sjablonen, zoals bijvoorbeeld in [[wikipedia:Template:Taxobox]]. Het gebruik van parserfuncties resulteert meestal in lastig-te-lezen sjablooncode, maar de versimpeling voor gebruikers is substantieel.

== Annotatie in een sjabloon ==

Ondersteuning voor het gebruik van annotaties dient ingeschakeld te worden door de sitebeheerder.

Wanneer een annotatietag is toegevoegd aan een sjabloon dan wordt op een pagina die het sjabloon reeds bevatte, de factbox bijgewerkt, maar zoekopdrachten houden nog geen rekening met de nieuwe annotatie. Om dat te bereiken, moet voor de pagina die het sjabloon bevat, eerst een bewerken- en opslaan-actie worden uitgevoerd (purge werkt niet). Daarna moet ook op de pagina met de zoekopdracht bewerken en opslaan worden uitgevoerd.

== Een zoekopdracht in een sjabloon ==
Een [[Help:Inline queries|zoekopdracht]] in een sjabloon is mogelijk, en het kan <nowiki>{{PAGENAME}}</nowiki> bevatten, zie bijv. [[ow:Template:Ask]]. Echter, een zoekopdracht met een template-parameter werkt alleen met substitutie en kan niet gebruikt worden in berekeningen. Zie [[ow:Property:Weekday_number]] &mdash; ''deze beperking is misschien niet langer van toepassing met SMW 1.0 wanneer men de <nowiki>{{#ask:}}</nowiki> functiesyntax gebruikt''.

{{docu|master page=Help:Semantic_templates|language=nl|minversion=1.0}}