Brontekst bekijken van Sjabloon:Inwonertal/doc

<!-- Deze pagina beschrijft de documentatie die hoort bij het hoofdsjabloon {{Inwonertal}} (https://nl.wikipedia.org/wiki/Sjabloon:Inwonertal)
Voor wijzigingen in de documentatie dient deze pagina aangepast te worden.--><noinclude>{{sjabdoc direct}}</noinclude> <!-- Hulpsjabloon gekoppeld aan hulpsjabloon {{sjabdoc}} in het hoofdsjabloon-->
{{Gebruikt Wikidata|P585|P1082|P2046}} <!-- Hulpsjabloon om aan te geven welke 'Wikidata properties' gebruikt zijn -->

==WikiData voorbeeld==
Als voorbeeld in deze uitleg gebruiken we de inwonertallen van Haarlemmermeer. Deze zijn in Wikidata [[https://www.wikidata.org/wiki/Q727#P1082 hier]] te vinden. 

==Toepassing==
Dit sjabloon kan toegepast worden om inwonertallen toe te voegen aan een artikel. Dit sjabloon haalt Wikidata-waarden op en plaatst dit in de tekst, op de positie van het sjabloon. 

==Vereisten==
De inwonertallen dienen in Wikidata aanwezig te zijn. Indien een waarde niet aanwezig is, dan wordt er niets getoond. Indien de waarden correct geregistreerd zijn dan is de voorkeurswaarde, deze wordt standaard gebruikt, in Wikidata met '''preferred rank''' geregistreerd. Indien dit niet het geval is en meerdere waarden met '''normal rank''' geregistreerd staan, dan wordt de eerst gevonden waarde gebruikt. Dit kan in bepaalde gevallen (afhankelijk van de volgorde van data-invoer) de verkeerde of ongewenste waarde zijn. Het algemene Wikipedia advies om altijd de bronnen te raadplegen geldt hier dus ook: controleer de informatie die vanuit Wikidata gebruikt gaat worden. Vereisten die een specifiek gebruik van dit sjabloon aangaan staan hier onder bij de opmerkingen van de voorbeelden vermeld.

==Gebruik==
De volgende optionele parameters kunnen meegegeven worden bij het gebruik van dit sjabloon:
# <code>id = [ Q... ]</code> Indien ''id'' niet meegegeven is, wordt gebruik gemaakt van de waarden van het aan de pagina gekoppelde Wikidata-item. Het ''id'' geeft de mogelijkheid om de waarden van een specifiek Wikidata-item op te vragen.
# <code>soort = [ datum | datumbron | dichtheid | dichtheidtxt | oppervlakte | oppervlakteraw | '''waarde''' | waardedatum | waardepuur | wdlink | zin ]</code> Indien ''soort'' niet als parameter meegegeven is, dan wordt ''soort=waarde'' gebruikt en wordt het inwonertal getoond.
# <code>locatie = [ departement | dorp | gemeente | kanton | land | '''plaats''' | regio | stad | ... ]</code> De ''locatie'' kan alleen gebruikt worden in indien er voor soort = ''zin'' gekozen is. Indien ''locatie'' niet als parameter wordt meegegeven, dan wordt ''locatie=plaats'' gebruikt en wordt de standaardzin getoond. Bij gebruik van de vaste waarden voor ''locatie'' hoeft geen lidwoord te worden meegegeven, voor andere locatieaanduidingen wordt de meegegeven waarde letterlijk gebruikt (zie hieronder voor voorbeelden).

{| class="wikitable sortable" 
|+ Sjabloon voorbeelden
|- 
! <div align="left">Variant:</div>
! <div align="left">Omschrijving:</div>
! <div align="left">Voorbeeld sjabloon syntax</div>
! <div align="left">Voorbeeld resultaat<ref>Deze broncode heeft afwijkingen. Om de documentatie goed leesbaar te maken is het specifieke ID van Haarlemmermeer in de broncode toegevoegd. De voorbeelden in de leeswaargave zijn te gebruiken in een artikel. Zie tevens de opmerking in het eerste voorbeeld.</ref></div>
! <div align="left">Opmerkingen</div>
|-
| Aantal inwoners
| Toont het aantal inwoners inclusief de bronvermelding
| <code><nowiki>{{Inwonertal}}</nowiki></code> 
| {{Inwonertal|id=Q9924}}
| rowspan=16 | Het artikel dient gekoppeld te zijn aan het Wikidata-item.
|-
| Datum behorend bij de waarde
| Toont de datum die behoort bij de waarde
| <code><nowiki>{{Inwonertal|soort=datum}}</nowiki></code> 
| {{Inwonertal|id=Q9924|soort=datum}}
<!-- rowcount skip row -->
|-
| Datum bron
| Toont de datum behorend bij de waarde inclusief de bronvermelding
| <code><nowiki>{{inwonertal|soort=datumbron}}</nowiki></code>
| {{inwonertal|id=Q9924|soort=datumbron}}
<!-- rowcount skip row -->
|-
| Datum en aantal
| Toont het aantal inwoners en de datum die daarbij hoort
| <code><nowiki>{{inwonertal|soort=waardedatum}}</nowiki></code>
| {{inwonertal|id=Q9924|soort=waardedatum}}
<!-- rowcount skip row -->
|-
| Dichtheid van de bevolking
| Toont het aantal inwoners per oppervlakte-eenheid (doorgaans vierkante km), afgerond op een decimaal
| <code><nowiki>{{inwonertal|soort=dichtheid}}</nowiki></code>
| {{inwonertal|id=Q9924|soort=dichtheid}}
<!-- rowcount skip row -->
|-
| Dichtheid van de bevolking met oppervlakte-eenheid
| Toont het aantal inwoners per oppervlakte-eenheid afgerond op een decimaal, en de betreffende eenheid (uitgeschreven)
| <code><nowiki>{{inwonertal|soort=dichtheidtekst}}</nowiki></code>
| {{inwonertal|id=Q9924|soort=dichtheidtekst}}
<!-- rowcount skip row -->
|-
| Oppervlakte van de geografische eenheid
| Toont de oppervlakte van de aangegeven plaats, gemeente,... en de betreffende eenheid (uitgeschreven)
| <code><nowiki>{{inwonertal|soort=oppervlakte}}</nowiki></code>
| {{inwonertal|id=Q9924|soort=oppervlakte}}
|-
| Oppervlakte van de geografische eenheid
| Toont de oppervlakte van de aangegeven plaats, gemeente,... zonder de betreffende eenheid
| <code><nowiki>{{inwonertal|soort=oppervlaktepuur}}</nowiki></code>
| {{inwonertal|id=Q9924|soort=oppervlaktepuur}}
<!-- rowcount skip row -->
|-
| Waardepuur
| Toont het aantal inwoners
| <code><nowiki>{{inwonertal|soort=waardepuur}}</nowiki></code>
| {{inwonertal|id=Q9924|soort=waardepuur}}
<!-- rowcount skip row -->
|-
| Wdlink 
| Toont de WikiData locatie
| <code><nowiki>{{Inwonertal|soort=wdlink}}</nowiki></code>
| {{Inwonertal|id=Q9924|soort=wdlink}}
<!-- rowcount skip row -->
|-
| Standaardzin
| Toont de standaardzin 
| <code><nowiki>{{Inwonertal|soort=zin}}</nowiki></code>
| {{Inwonertal|id=Q9924|soort=zin}}
<!-- rowcount skip row -->
|-
| Zin
| Toont de zin met als variant 'dorp'
| <code><nowiki>{{Inwonertal|soort=zin|locatie=dorp}}</nowiki></code>
| {{Inwonertal|id=Q9924|soort=zin|locatie=dorp}}
<!-- rowcount skip row -->
|-
| Zin
| Toont de zin met als variant 'gemeente'
| <code><nowiki>{{Inwonertal|soort=zin|locatie=gemeente}}</nowiki></code>
| {{Inwonertal|id=Q9924|soort=zin|locatie=gemeente}}
<!-- rowcount skip row -->
|-
| Zin
| Toont de zin met als variant 'stad'
| <code><nowiki>{{Inwonertal|soort=zin|locatie=stad}}</nowiki></code>
| {{Inwonertal|id=Q9924|soort=zin|locatie=stad}}
<!-- rowcount skip row -->
|-
| Zin
| Toont de zin met als variant 'De kermis'
| <code><nowiki>{{Inwonertal|soort=zin|locatie=De kermis}}</nowiki></code>
| {{Inwonertal|id=Q9924|soort=zin|locatie=De kermis}}
<!-- rowcount skip row -->
|-
| Zin
| Toont de zin met als variant 'Het gehucht'
| <code><nowiki>{{Inwonertal|soort=zin|locatie=Het gehucht}}</nowiki></code>
| {{Inwonertal|id=Q9924|soort=zin|locatie=Het gehucht}}
<!-- rowcount skip row -->
|-
| Aantal inwoners van een ander ID (Amstelveen)
| Toont het aantal inwoners inclusief de bronvermelding van Amstelveen
| <code><nowiki>{{Inwonertal|id=Q9898}}</nowiki></code> 
| {{Inwonertal|id=Q9898}}
| rowspan=3 | Opgegeven id vereist. De pagina waarop het sjabloon wordt gebruikt, hoeft niet gekoppeld te zijn aan het Wikidata-item.
|-
| Datum bron van een ander ID (Amstelveen)
| Toont de datum behorend bij de waarde inclusief de bronvermelding
| <code><nowiki>{{inwonertal|id=Q9898|soort=datumbron}}</nowiki></code>
| {{inwonertal|id=Q9898|soort=datumbron}}
<!-- rowcount skip row -->
|-
| Zin van een ander ID (Amstelveen)
| Toont de zin met als variant 'Amstelveen'
| <code><nowiki>{{Inwonertal|id=Q9898|soort=zin|locatie=Amstelveen}}</nowiki></code>
| {{Inwonertal|id=Q9898|soort=zin|locatie=Amstelveen}}
<!-- rowcount skip row -->
|}

{{Appendix|2=
{{References}}
}}

<templatedata>
{
	"params": {
		"soort": {
			"type": "line",
			"suggestedvalues": [
				"datum",
				"datumbron",
				"dichtheid",
				"dichtheidtxt",
				"oppervlakte",
				"oppervlakteraw",
				"waarde",
				"waardedatum",
				"waardepuur",
				"wdlink",
				"zin"
			],
			"suggested": true
		},
		"id": {
			"type": "line",
			"suggested": true
		},
		"locatie": {
			"type": "line",
			"suggested": true
		}
	},
	"format": "inline"
}
</templatedata>