Brontekst bekijken van Sjabloon:Taxonbalk/doc

{{Gebruikt Lua|Module:Taxonbalk}}
{{Gebruikt Wikidata|sectie=Taxonidentificatiecodes}}

== Omschrijving ==
Dit metadata sjabloon linkt Wikipedia artikelen aan biologische en taxonomische databases. Taxonbalk laat die links zien als korte [[Tekenreeks|'strings']]: de zogenaamde ''identifiers'' of ''[[Help:Taxonidentificatiecodes|Taxonidentificatiecodes]]'' die iedere database aan het elk [[taxon]] heeft toegekend.

De identifiers voor een taxon zijn opgeslagen in wikidata onder het wikidata entry van dat taxon. Het kan in een artikel worden 'overruled' met daar ingebrachte data, maar het verdient in voorkomende gevallen de voorkeur om Wikidata te updaten.

Dit project is gebaseerd op het werk aan {{Tl|Bibliografische informatie}} en [[d:Wikidata:WikiProject Taxonomy|Wikidata:WikiProject Taxonomy]]. Als je sjabloon editor of Wikipedia administrator bent, dan kun je bijdragen aan '''[[Module:Taxonbalk]]'''. Breng je ideeën/gedachten voor verbetering of gebruik hier naar voren: [[Overleg_sjabloon:Taxonbalk]].
<!--
[[File:Taxonbar layout placement on English Wikipedia - Cuckoo wasp.png|thumb|Taxonbalk komt onder [[Wikipedia:Navigation template|navigation templates]], behalve [[Wikipedia:Authority control|Authority control]].]]
  -->
[[File:Taxonbar layout placement on English Wikipedia - Cuckoo wasp.png|thumb|Taxonbalk komt onder [[:Categorie:Wikipedia:Sjablonen_navigatie|navigatiesjablonen]] behalve [[Wikipedia:Authority control|Authority control]].]]

== Positie ==
'''Zet de Taxonbalk op de juiste plaats'''. Als metadata-sjabloon hoort Taxonbalk:
<!--
  {{kolommen-lijst|colwidth=60em|
  -->
* Onder alle [[Wikipedia:Referenties|referenties]], [[Wikipedia:Voetnoten|voetnoten]], en [[Wikipedia:Externe links|externe links]].
* Onder alle [[:Categorie:Wikipedia:Sjablonen navigatie|navigatiesjablonen]]—behalve Authority control
* Boven de [[Wikipedia:Bibliografische informatie|Bibliografische informatie]] sjabloon.
* Boven alle [[Help:Gebruik van categorieën|<nowiki>[[Categorie]]</nowiki>]] en beginnetje sjablooncodes in de editor.
<!--
}}
  -->

== Gebruik ==
Om Taxonbalk aan een artikel toe te voegen:
<nowiki>{{Block indent|left=0.1|1=</nowiki>
# In 'brontekst bewerken' mode: plaats <code><nowiki>{{Taxonbalk}}</nowiki></code> ''' onder alle andere navigatie sjablonen behalve Authority control'''.
# Klik "Toon bewerking ter controle" om de plaatsing te controleren, en om te zien welke identifiers er inderdaad van Wikidata opgehaald zijn.
# Als je meer identifiers wil toevoegen, overweeg dan ze aan het Wikidata item van het artikel toe te voegen, zodat alle versies van Wikipedia ervan profiteren. Wees voorzichtig met de struktuur of de namen van Wikidata taxa tot je goed bekend bent met [[d:Wikidata:WikiProject Taxonomy|Wikidata:WikiProject Taxonomy]] en [[d:Wikidata:WikiProject Taxonomy/Tutorial|Wikidata:WikiProject Taxonomy/Tutorial]].

Simpele code:
<syntaxhighlight lang="wikitext">{{Taxonbalk|van=}}</syntaxhighlight>
<!-- }} -->
== Taxon voorbeeld ==

[[File:PileatedWoodpeckerFeedingonTree,_crop.jpg|thumb|left|'''[[Noord-Amerikaanse helmspecht]] (''Dryocopus pileatus''), syn. ''Picus pileatus''''']]
{{clear|left}}

<code><nowiki>{{Taxonbalk}}</nowiki></code>, indien geplaatst in het [[Noord-Amerikaanse helmspecht]] artikel:
{{Taxonbalk|van=Q930712}}

<br>
Het is mogelijk de wikidata code (Q930712) expliciet mee te geven: <code><nowiki>{{Taxonbalk|van=Q930712}}</nowiki></code>
<br>
Maar meestal is de eenvoudige versie zonder code afdoende.<br>

== Voorbeelden ==
<!-- dunno...
{{Zie ook|Sjabloon:Taxonbalk/sandbox|Template:Taxonbalk/testcases}}
  -->
{{Horizontale lijst|
* [[Blauwe gaai]]
* [[Roodborst]]
* ''[[Agaricus bisporus]]''
* [[Amerikaanse kastanje]]
* ''[[Escherichia coli]]''
* ''[[Plasmodium falciparum]]''
* ''[[Bombus terrestris]]''
* ''[[Canis]]''
* [[Monarchvlinder]]
}}

=== Lijst van taxonidentificatiecodes ===
{{#invoke:Taxonbalk/confdoc|confdoc}}
<!--'''<nowiki>*</nowiki>'''(support for this parameter temporarily disabled)-->
<!-- If none of these is applicable, it can be forced with: <nowiki>{{Authority control |MBA={{#Property:P434}} }}</nowiki> which for [[The Beatles]] would produce:
{{Authority control |MBA=b10bbbfc-cf9e-42e0-be17-e2c3e1d2600d }}
Note that for The Beatles <nowiki>{{Authority control}}</nowiki> would work out of the box already. -->

===Manual identifiers===
Taxonidentificatiecodes die ontbreken in Wikidata, kunnen via de [[#Lijst van taxonidentificatiecodes|bovenstaande]] parameters worden gebruikt; maar het verdient de voorkeur ze toe te voegen aan Wikidata zodat automatisch alle Wikipedia versies er voordeel van hebben.

Voorbeeld:
<syntaxhighlight lang="wikitext">{{Taxonbalk | powo = urn:lsid:ipni.org:names:30009317-2 }}</syntaxhighlight>

Dat geeft voor ''[[Lilium]]'', met de toegevoegde  [[Plants of the World Online]] taxonidentificatiecode, 
het hieronder getoonde resultaat. De expliciet gegeven powo taxonidentificatiecode is zichtbaar naast de codes die zijn opgehaald van Wikidata:

{{Taxonbalk |van=Q5194627 | powo = urn:lsid:ipni.org:names:30009317-2 }}

Ook een [[Wikispecies]] pagina kan expliciet worden toegevoegd, maar weer heeft het de voorkeur om het aan Wikidata te linken. Dit kan binnen de  "''Multilingual sites''" sectie, met "''species''" als de "''wiki''".

{| class="wikitable sortable"
|-
!Parameter!!Database!!Property URL/Interwiki link
|-
|Wikispecies||[[Wikispecies]]||Wikispecies:$1
|}

=== Specifieke taxonidentificatiecodes verbergen (optional) ===
Specifieke taxonidentificatiecodes in de bovenstaande tabel kunnen uit de Taxonbalk onzichtbaar gemaakt worden door de betreffende  parameter op <code>no</code> te zetten. Dit kan nuttig zijn om minder nuttige links in de taxonbalk te vermijden; er is vaak veel redundantie in de gelinkte databases. Spaties zijn optional.  Het is niet nodig al te veel te verwijderen; bijvoorbeeld, plant of schimmel identifiers weghalen voor een diertaxon heeft geen effect want die zouden sowieso al niet verschijnen bij een diertaxon artikel.  Gebruik 'Toon bewerking ter controle' (preview) op de <code><nowiki>{{Taxonbalk}}</nowiki></code> en besluit op grond daarvan welke items te weinig informatie verschaffen.  Plantensoorten hebben de meeste entries en hebben het meeste baat bij het verbergen van enige items.

Voorbeeld:
Voor het weghalen van FOC, IPNI, en APDB:
<syntaxhighlight lang="wikitext">{{Taxonbalk | foc = no | ipni = no| apdb = no }}</syntaxhighlight>

Hetzelfde voor ''[[Coffea arabica]]'':

{{Taxonbalk |van=Q47685 | foc = no | ipni = no| apdb = no }}

===Displaying excluded databases (optional)===
Deze databases zijn beschikbaar als Wikidata, maar zijn by default uitgezet hier op nl.wiki omdat ze niet Engelstalig zijn. Men kan ze 'aanzetten' door in de {{tl|Taxonbalk}} de juste parameter op <code>yes</code> te zetten (bijvoorbeeld: {{para|CoL-Taiwan|yes}}), dat haalt dan de waarde van Wikidata; of door de parameter expliciet te geven (voorbeeld: {{para|CoL-Taiwan|395235}}).

{| class="wikitable sortable"
|-
! data-sort-type=number style="white-space: nowrap;"|Wikidata property name &nbsp;&nbsp;&nbsp;&nbsp; !! ID !! Authority !! Description !! Language
|-
|{{Taxonbalk/ExcludedProperty|3088}}||Taiwanese
|-
|{{Taxonbalk/ExcludedProperty|4902}}||Spanish
|-
|{{Taxonbalk/ExcludedProperty|5263}}||Czech
|-
|{{Taxonbalk/ExcludedProperty|6115}}||French
|-
|{{Taxonbalk/ExcludedProperty|4630}}||French
|-
|{{Taxonbalk/ExcludedProperty|1939}}||Swedish
|-
|{{Taxonbalk/ExcludedProperty|6043}}||French
|-
|{{Taxonbalk/ExcludedProperty|5179}}||Catalan
|-
|{{Taxonbalk/ExcludedProperty|6094}}||German
|-
|{{Taxonbalk/ExcludedProperty|4311}}||Dutch
|-
|{{Taxonbalk/ExcludedProperty|6054}}||French
|-
|{{Taxonbalk/ExcludedProperty|2794}}||French
|-
|{{Taxonbalk/ExcludedProperty|6025}}||French
|-
|{{Taxonbalk/ExcludedProperty|3102}}||Russian
|-
|{{Taxonbalk/ExcludedProperty|3186}}||French
|-
|{{Taxonbalk/ExcludedProperty|3105}}||French
|-
|{{Taxonbalk/ExcludedProperty|4125}}||French
|-
|{{Taxonbalk/ExcludedProperty|6142}}||Dutch
|-
|{{Taxonbalk/ExcludedProperty|3322}}||Dutch
|-
|{{Taxonbalk/ExcludedProperty|4664}}||Portuguese
|}

==Meer dan een Wikidata entry==

Sommige taxa hebben meer dan een naam (synoniemen) op Wikidata. Om synoniemen toe te voegen gebruik je {{para|from2}}, {{para|from3}}, etc. parameters om hun Wikidata IDs te specificeren. De parameter {{para|van}} / {{para|van1}} wordt ''impliciet'' bepaald door het Wikidata item dat aan het artikel gelinked is (vanuit wikidata).

Als er meer dan een regel is wordt de taxonnaam van Wikidata in de linkerkolom getoond — je kunt dit overrulen door {{para|title}} / {{para|title1}}, {{para|title2}}, {{para|title3}}, etc. parameters. Je kunt de identificatiecodes die afwezig zijn in Wikidata toevoegen door het juiste nummer aan het eind van de parameter te plakken — bijvoorbeeld, om emonocot aan de tweede regel toe te voegen: {{para|emonocot2}}.

Voorbeeld: {{tlx|Taxonbalk|2=van=Q26972265|3=van2=Q20717272}}, geplaatst op de [[Hond]] pagina, produceert:
{{Taxonbalk|van=Q26972265| van2=Q20717272}}

Dezelfde aanpak kan worden gehanteerd waar monotypische taxa een enkel artikel hebben, terwijl er meer dan een entry is in Wikidata. Bijvoorbeeld, voor pagina ''[[Haptanthus]]'', die het genus (geslacht) en de enige soort behandelt 
{{tlx|Taxonbalk|2=van1=Q15715555|3=van2=Q133951}}:
{{Taxonbalk| van1=Q15715555| van2=Q133951}}

===Basioniemen===

[[Basioniem|Basioniemen]] in Wikidata (via {{Wikidata property link|P566}}) worden automatisch toegevoegd. Het is mogelijk de locatie van het basioniem expliciet te geven via {{para|van#}} waar '#' is een [[cijfer]].

Bijvoorbeeld, 
:{{tlx|Taxonbalk|2=van1=Q43372357|3=van2=Q164254}} en
:{{tlx|Taxonbalk|2=van1=Q43372357|3=van2=Q164254|4=van3=Q21977691}}
produceren identieke Taxonbalken voor ''[[Ponerorchis cucullata]]'':
{{Taxonbalk|  van1=Q43372357|  van2=Q164254|  van3=Q21977691}}

of {{tlx|Taxonbalk|2=van1=Q43372357|3=van2=Q21977691|4=van3=Q164254}} voor een bepaalde positionering:
{{Taxonbalk|  van1=Q43372357|  van2=Q21977691|  van3=Q164254}}

==Meer taxon voorbeelden==
[[File:Coffee-230022.jpg|lthumb|50px]] ''[[Coffea arabica]]''
{{Taxonbalk|van=Q47685}}
[[File:Common_Milkweed_(Asclepias_syriaca)_(14911935302).jpg|lthumb|50px]] Zijdeplant, ''[[Asclepias syriaca]]''
{{Taxonbalk|van=Q158295}}
[[File:Newborn Monarch being released (15476827630).jpg|lthumb|50px]] [[Monarchvlinder]], ''Danaus plexippus''
{{Taxonbalk|van=Q212398}}
[[File:Bobcat-Texas-9110.jpg|lthumb|50px]] [[Rode lynx|Rode lynx (Bobcat)]], ''Lynx rufus''
{{Taxonbalk||van=Q131907}}
[[File:Eastern_Bluebird-27527-7.jpg|lthumb|50px]] [[Roodkeelsialia]], ''Sialia sialis''
{{Taxonbalk|van=Q600880}}
[[File:Firefly_%E3%83%9B%E3%82%BF%E3%83%AB_%E8%9B%8D_Hotaru.jpg|lthumb|50px]] [[Glimwormen]], ''Lampyridae''
{{Taxonbalk|van=Q25420}}
[[File:Amanita muscaria 3 vliegenzwammen op rij.jpg|lthumb|50px]] Vliegenzwam, ''[[Amanita muscaria]]''
{{Taxonbalk|van=Q131227}}
[[File:Saccharomyces_cerevisiae_SEM.jpg|lthumb|50px]] ''[[Saccharomyces cerevisiae]]''
{{Taxonbalk|van=Q719725}}
[[File:Lactobacillus_acidophilus_SEM.jpg|lthumb|50px]] ''[[Lactobacillus acidophilus]]''
{{Taxonbalk|van=Q132644}}
[[File:Plasmodium_falciparum_01.png|lthumb|50px]] ''[[Plasmodium falciparum]]''
{{Taxonbalk|van=Q311383}}

== Module editing — to-do list ==
* Continue to add support for new, useful parameters ([https://query.wikidata.org/#SELECT%20%3Fitem%20WHERE%0A%7B%0A%20%20%23%20all%20instance%20of%3A%20Wikidata%20property%20to%20identify%20taxa%20%28Q42396390%29%0A%20%20%3Fitem%20wdt%3AP31%20wd%3AQ42396390%20.%0A%7D search])

== Module editing — to-don't list ==
* Import synonym QIDs via {{Wikidata property link|P1420}} from Wikidata ([[Template talk:Taxonbalk/Archive 4#Basionyms and synonyms|talk]])

==Zie ook==
* [[Help:Taxonidentificatiecodes]]

==Overige links==
* {{tl|Bibliografische informatie}}
* {{tl|Taxobox}}

== TemplateData ==
<templatedata>
{
	"params": {
		"van": {
			"label": "Wikidata item",
			"example": "Q1",
			"type": "line"
		},
		"van2": {
			"label": "Tweede Wikidata item",
			"example": "Q2",
			"type": "line"
		},
		"van3": {
			"label": "Derde Wikidata item",
			"example": "Q3",
			"type": "line"
		}
	},
	"paramOrder": [
		"van",
		"van2",
		"van3"
	],
	"format": "inline"
}
</templatedata>

<includeonly>
[[Categorie:Wikipedia:Sjablonen biologie]][[Categorie:Wikipedia:Sjablonen externe link]][[Categorie:Wikipedia:Sjablonen Wikidata-informatie]]
</includeonly>