View source for Template:GRIN/doc

{{Documentation subpage}}
<!-- Please place categories where indicated at the bottom of this page and interwikis at Wikidata (see [[Wikipedia:Wikidata]]) -->
{{Underused external link template|http://www.ars-grin.gov/cgi-bin/npgs/}}

==Usage==
{{Uses Wikidata|P1421|P225}}

Use this template to add a reference to a species page on the web site [http://www.ars-grin.gov/npgs/aboutgrin.html GRIN]. At the moment, it cannot link to pages on other taxonomic ranks, such as genera and families.

{{Note:}} This template is designed to support WikipediaBioReferences and retrieves [[:Wikidata]]. Do not edit this template unless you are familiar with these functionalities or are copying updated code from commons.

==Syntax==
; Simple
Simply use the tag by itself or leave the id parameter blank to generate a citation/link of [[:Wikidata]]'s corresponding GRIN link for the current plant '''species'''. [[:Wikidata:]] has GRIN links for most of the Wikipedia species on the GRIN database.

: <code><nowiki>{{GRIN}}</nowiki></code>

;Example
:Adding <code><nowiki>{{GRIN}}</nowiki></code> to the [[:Maize]] page creates (in the beginning of 2020) the following:<br>&nbsp;&nbsp;&nbsp;[https://npgsweb.ars-grin.gov/gringlobal/taxonomydetail.aspx?id=42207 ''"Zea mays"'']. ''[[Germplasm Resources Information Network]] (GRIN)''. [[Agricultural Research Service]] (ARS), [[United States Department of Agriculture]] (USDA).


;Advanced formatting and parameter options
<code><nowiki>{{GRIN | id | description | validity | access-date = </nowiki>{{#time: j F Y}} <nowiki>}}</nowiki></code>

<code><nowiki>{{GRIN | name = | id = | access-date = </nowiki>{{#time: j F Y}}<nowiki> }}</nowiki></code>

<code><nowiki>{{GRIN | access-date = </nowiki>{{#time: j F Y}}<nowiki> }}</nowiki></code>

;Parameters
* {{para|mode}}
: By default [[Help:Citation Style 1|Citation Style 1]]; switch to [[Help:Citation Style 2|Citation Style 2]] with {{para|mode|cs2}}.
* {{para|id}}
: the id of the species on GRIN web site.
: '''How to retrieve the id''': use the [https://npgsweb.ars-grin.gov/gringlobal/taxon/taxonomysearch.aspx?language=en search page] to retrieve the correct page.<BR/>In the url <code><nowiki>https://npgsweb.ars-grin.gov/gringlobal/taxonomydetail.aspx?</nowiki>'''3074'''</code> the id is 3074
: '''Sample''' (for ananas): ''3074''
* {{para|name}} (optional)
: The name of the taxon
: '''Sample''' (for ananas): ''Ananas comosus''
* {{para|authors}} (optional)
: The taxon authors
: '''Sample''' (for ananas): ''(L.) Merr.''
* {{para|validity}} (optional) 
: If the genus is considered as unaccepted or synonym by GRIN, add <code>nv</code>.
: '''Sample''' (for searching example): ''nv''
* {{para|access-date|{{#time: j F Y}}}} (optional) 
: Specify the date the article was accessed.

==Samples==
: <code><nowiki>{{GRIN | name = ''Daucus glochidiatus'' (Labill.) Fisch. & C. A. Mey. | id = 102093 | access-date =</nowiki> {{#time: j F Y}} <nowiki>}}</nowiki></code>
: <code><nowiki>{{GRIN | mode = cs2 | name = ''Daucus glochidiatus'' (Labill.) Fisch. & C. A. Mey. | id = 102093 | access-date =</nowiki> {{#time: j F Y}} <nowiki>}}</nowiki></code>
: <code><nowiki>{{GRIN | ''Daucus glochidiatus'' (Labill.) Fisch. & C. A. Mey. | 102093 | access-date =</nowiki> {{#time: j F Y}} <nowiki>}}</nowiki></code>
: <code><nowiki>{{GRIN | 3074 | ''Ananas comosus'' (L.) Merr. | | | access-date =</nowiki> {{#time: j F Y}} <nowiki>}}</nowiki></code>
: <code><nowiki>{{GRIN | 3074 | ''Ananas comosus'' | | access-date =</nowiki> {{#time: j F Y}} <nowiki>}}</nowiki></code>
: <code><nowiki>{{GRIN | 3074 | ''Ananas comosus'' | nv }}</nowiki></code>
: <code><nowiki>{{GRIN | 3074 }}</nowiki></code>
: <code><nowiki>{{GRIN | ''Daucus glochidiatus''}}</nowiki></code>
: <code><nowiki>{{GRIN}}</nowiki></code>
;Results
: {{GRIN | name = ''Daucus glochidiatus'' (Labill.) Fisch. & C. A. Mey. | id = 102093 | access-date = {{#time: j F Y}} }}
: {{GRIN | mode = cs2 | name = ''Daucus glochidiatus'' (Labill.) Fisch. & C. A. Mey. | id = 102093 | access-date = {{#time: j F Y}} }}
: {{GRIN | ''Daucus glochidiatus'' (Labill.) Fisch. & C. A. Mey. | 102093 | access-date = {{#time: j F Y}} }}
: {{GRIN | 3074 | ''Ananas comosus'' (L.) Merr. | | | access-date = {{#time: j F Y}} }}
: {{GRIN | 3074 | ''Ananas comosus'' | | access-date = {{#time: j F Y}} }}
: {{GRIN | 3074 | ''Ananas comosus'' | nv }}
: {{GRIN | 3074 }}
: {{GRIN | ''Daucus glochidiatus''}}
: {{GRIN}}
(The last 2 examples would have working links if added to a species article with corresponding "GRIN URL" Wikidata.)

==See also==
:* [[:fr:Modèle:GRIN espèce]] - Inspiration for this template.
:* The other templates of [[:Category:Biology external link templates]]

<includeonly>{{Sandbox other||
<!-- Categories below this line, please; interwikis at Wikidata -->
[[Category:Templates using data from Wikidata]]
[[Category:Biology external link templates|{{PAGENAME}}]]
[[Category:Botany external link templates|{{PAGENAME}}]]
[[Category:External link templates using Wikidata]]
}}</includeonly>