Jump to content

Module:Cite taxon/doc: Difference between revisions

Add links
From Wikipedia, the free encyclopedia
Browse history interactively
← Previous edit
Content deleted Content added
VisualWikitext
update for change to FishRef
 
(26 intermediate revisions by 5 users not shown)
Line 1: Line 1:
{{High-use}}
This module was created to generate {{tl|cite web}} references to the ''[[Catalog of Fishes]]'' database. The capabilities were extended to handle other fish-related references and the module renamed FishRef. Further extension to a more general Bioref system is the long-term goal.
This module was created to generate {{tl|cite web}} references to the ''[[Catalog of Fishes]]'' database. The capabilities were extended to handle other fish-related references and the module renamed [[Module:FishRef|FishRef]]. Further extension to cover taxonomy databases handling non-fish taxa led to creation of template {{tl|BioRef}}. and {{tl|Cite taxon}} templates and module name was changed to [[Module:Cite taxon|Cite taxon]] to better describe its function of handling citations for a wide variety taxonomy databases.


The module provides a wrapper to the citation template {{tl|cite web}}, which means that the references can also include other parameters supported by the CS1/CS2 citation system. These include {{para|access-date}}, which is recommended, reference style formating parameters such as {{para|mode|cs1{{!}}2}} or {{para|name-list-style|vanc}}, the archiving parameters {{para|url-status}}, {{para|archive-url}} and {{[para|archive-date}}, and other general parameter such as {{para|quote}}. The template supplies authors or editors for some databases, but for others these can be added using the cite web parameters {{para|author}}, {{para|last}}, {{para|first}} or the editor equivalents.
The module provides a wrapper to the cite web system, which means the the references can also include general cite web parameters (e.g. <code>|mode=cs1|2</code> or <code>|quote=TEXT</code>).

=== Templates using the module ===


The module is used with {{tl|Catalog of Fishes}}, which was designed to replace a series of templates that were originally written in the Wikipedia template language: {{tl|Cof genus}}, {{tl|Cof family}}, {{tl|Cof species}}, {{tl|Cof record}}.
The module is used with {{tl|Catalog of Fishes}}, which was designed to replace a series of templates that were originally written in the Wikipedia template language: {{tl|Cof genus}}, {{tl|Cof family}}, {{tl|Cof species}}, {{tl|Cof record}}.


Other templates using the module:
'''Usage of module:''' <nowiki>{{#invoke:FishRef|cof}}</nowiki>

=Examples of Lua module {{tl|Catalog of Fishes}}=

Use the templates as follows:
<pre>
{{Catalog of Fishes |family=Xiphiidae |list=species |access-date=7 June 2018}}
{{Catalog of Fishes |family=Cyprinidae |access-date=7 June 2018}}
{{Catalog of Fishes |family=Salmonidae |list=genus |access-date=7 June 2018}}

{{Catalog of Fishes |genus=Vinagarra |access-date=7 June 2018}}


* {{tl|Cite taxon}} (general purpose template handling many databases*)
{{Catalog of Fishes |genus=Vinagarra |species=elongata |access-date=7 June 2018}}
* {{tl|BioRef}} (general purpose template handling many databases.* Deprecated, use {{tl|Cite taxon}})
{{Catalog of Fishes |genus=Abbottina |species=rivularis |access-date=7 June 2018}}
* {{tl|FishRef}} (general purpose template handling many fish databases. Deprecated, use {{tl|Cite taxon}} or fishbase or CoF templates)
{{Catalog of Fishes |genus=Tylognathus |species=sinensis |access-date=7 June 2018}}
* {{tl|FishBase}}
* {{tl|Fossilworks}} (site defunct)
* {{tl|Catalogue of Life}}
* {{tl|Cite WFO}} (World Flora Online)
* {{tl|Cite mdd}} (Mammalian Diversity Database)
* {{tl|Cite BOW}} (Birds of the World)


:<code>*</code> The module currently handles ASW6, Amphibiaweb, Reptile Database, IOC, Avibase, TiF, WoRMS, POWO, GRIN, IPNI, World Plants, World Ferns, Tropicos, FNA, ATRF, Goffinet's Bryophyte classification, Algaebase, Paleobiology DB, ITIS
{{Catalog of Fishes |genid=150 |access-date=8 June 2018}}
{{Catalog of Fishes |genid=150 |title=Syngnathus |access-date=8 June 2018}}


=== Usage of module ===
{{Catalog of Fishes|spid=14756 |access-date=8 June 2018}}
{{Catalog of Fishes |spid=14756 |title=Syngnathus abaster |access-date=8 June 2018}}
</pre>
Results:


General form: <nowiki>{{#invoke:Cite taxon|main|</nowiki>''db''<nowiki>|</nowiki>''parameters''<nowiki>}}</nowiki>
*{{Catalog of Fishes |family=Xiphiidae |list=species |access-date=7 June 2018}}
*{{Catalog of Fishes |family=Cyprinidae |access-date=7 June 2018}}
*{{Catalog of Fishes |family=Cyprinidae |list=genus |access-date=7 June 2018}}


Examples: <nowiki>{{#invoke:Cite taxon|main|cof|</nowiki>''parameters''<nowiki>}}</nowiki>, <nowiki>{{#invoke:Cite taxon|main|fishbase|</nowiki>''parameters''<nowiki>}}</nowiki>, <nowiki>{{#invoke:Cite taxon|main|reptileDB|</nowiki>''parameters''<nowiki>}}</nowiki>, <nowiki>{{#invoke:Cite taxon|main|ASW6|</nowiki>''parameters''<nowiki>}}</nowiki>, <nowiki>{{#invoke:Cite taxon|main|POWO|</nowiki>''parameters''<nowiki>}}</nowiki>, etc.


The module stores information about each database in a data table (e.g. data.cof for Catalog of Fishes). The table has a CitationArgs table, for parameters to be passed to {{tl|cite web}}, a CustomArgs table for parameters used for internal workings to set other {{tl|cite web}} parameters, and one or more custom functions handling different types of citation parameter. Typical functions are id, species, genus, family, order, and taxon. Which functions are needed depend on the options provided by the external database, some use a common format with an id for all links, others have taxon-specific links.
*{{Catalog of Fishes |genus=Vinagarra |access-date=7 June 2018}}


=== General rules ===


Different databases provide different options so uniformity is not possible. Some provide links that allow handling of species, genera, families, orders and other taxon ranks using the taxon names. This allows specific function to handle different taxa. Other just provide an id which can be used to generate the url, but needs a title. The following are the general rules for what functions are available:
*{{Catalog of Fishes |genus=Vinagarra |species=elongata |access-date=7 June 2018}}
*{{Catalog of Fishes |genus=Abbottina |species=rivularis |access-date=7 June 2018}}
*{{Catalog of Fishes |genus=Tylognathus |species=sinensis |access-date=7 June 2018}}


# All databases can take a {{para|title}} and {{para|url}}. The templates then just add the general citation information about the website.
# Many take a {{para|id}}. The template will complete the url and add a default title, although adding a title is recommended.
# Some databases allow taxon names that can be used with {{para|genus}}, {{para|family}}, {{para|order}} or {{para|taxon}}
# Species can also often be handled when given {{para|genus}} and {{para|species}}, and in some cases also {{para|subspecies}}. These can usually be added as position parameters, but it is recommended that the parameter names are given




==Examples of templates using the [[Module:FishRef]]==
*{{Catalog of Fishes |genid=150 |access-date=8 June 2018}}
*{{Catalog of Fishes |genid=150 |title=Syngnathus |access-date=8 June 2018}}


*{{Catalog of Fishes |spid=14756 |access-date=8 June 2018}}
===Catalog of Fishes===
'''Examples using {{tl|Catalog of Fishes}}'''
*{{Catalog of Fishes |spid=14756 |title=Syngnathus abaster |access-date=8 June 2018}}
{| class="wikitable"
|-
! Template usage !! Results
|-
|<pre>{{Catalog of Fishes |family=Xiphiidae |list=species |access-date=7 June 2018}}</pre>
| {{Catalog of Fishes |family=Xiphiidae |list=species |access-date=7 June 2018}}
|-
|<pre>{{Catalog of Fishes |family=Cyprinidae |access-date=7 June 2018}}</pre>
| {{Catalog of Fishes |family=Cyprinidae |access-date=7 June 2018}}
|-
|<pre>{{Catalog of Fishes |family=Salmonidae |list=genus |access-date=7 June 2018}}</pre>
| {{Catalog of Fishes |family=Salmonidae |list=genus |access-date=7 June 2018}}
|-
|<pre>{{Catalog of Fishes |genus=Vinagarra |access-date=7 June 2018}}</pre>
| {{Catalog of Fishes |genus=Vinagarra |access-date=7 June 2018}}
|-
|<pre>{{Catalog of Fishes |genus=Vinagarra |species=elongata |access-date=7 June 2018}} </pre>
| {{Catalog of Fishes |genus=Vinagarra |species=elongata |access-date=7 June 2018}}
|-
|<pre>{{Catalog of Fishes |genus=Abbottina |species=rivularis |access-date=7 June 2018}}</pre>
| {{Catalog of Fishes |genus=Abbottina |species=rivularis |access-date=7 June 2018}}
|-
|<pre>{{Catalog of Fishes |genus=Tylognathus |species=sinensis |access-date=7 June 2018}}</pre>
| {{Catalog of Fishes |genus=Tylognathus |species=sinensis |access-date=7 June 2018}}
|-
|<pre>{{Catalog of Fishes |genid=150 |access-date=8 June 2018}} </pre>
| {{Catalog of Fishes |genid=150 |access-date=8 June 2018}}
|-
|<pre>{{Catalog of Fishes |genid=150 |title=Syngnathus |access-date=8 June 2018}} </pre>
| {{Catalog of Fishes |genid=150 |title=Syngnathus |access-date=8 June 2018}}
|-
|<pre>{{Catalog of Fishes|spid=14756 |access-date=8 June 2018}}</pre>
| {{Catalog of Fishes |spid=14756 |access-date=8 June 2018}}
|-
|<pre>{{Catalog of Fishes |spid=14756 |title=Syngnathus abaster |access-date=8 June 2018}}</pre>
| {{Catalog of Fishes |spid=14756 |title=Syngnathus abaster |access-date=8 June 2018}}
|}


=Examples of use of template language versions templates=
'''Examples using {{tl|Cof family}}, {{tl|Cof genus}}, {{tl|Cof species}} and {{tl|Cof record}} templates'''
Use the templates as follows:
<pre>
{{Cof family |Xiphiidae|7 June 2018}}
{{Cof family |family=Xiphiidae |list=species |access-date=7 June 2018}}
{{Cof family |family=Cyprinidae |access-date=7 June 2018}}
{{Cof family |family=Cyprinidae |list=genus |access-date=7 June 2018}}


{| class="wikitable"
{{Cof genus |Garra|7 June 2018}}
|-
{{Cof genus |genus=Vinagarra |access-date=7 June 2018}}
! Template usage !! Results
|-
|<pre>{{Cof family |Xiphiidae|access-date=7 June 2018}}</pre>
| {{Cof family |Xiphiidae|access-date=7 June 2018}}
|-
|<pre>{{Cof family |family=Xiphiidae |list=species |access-date=7 June 2018}}</pre>
| {{Cof family |family=Xiphiidae |list=species |access-date=7 June 2018}}
|-
|<pre>{{Cof family |family=Cyprinidae |access-date=7 June 2018}}</pre>
| {{Cof family |family=Cyprinidae |access-date=7 June 2018}}
|-
|<pre>{{Cof family |family=Salmonidae |list=genus |access-date=7 June 2018}}</pre>
| {{Cof family |family=Salmonidae |list=genus |access-date=7 June 2018}}
|-
|<pre>{{Cof genus |Garra|access-date=7 June 2018}}</pre>
| {{Cof genus |Garra|access-date=7 June 2018}}
|-
|<pre>{{Cof genus |genus=Vinagarra |access-date=7 June 2018}}</pre>
| {{Cof genus |genus=Vinagarra |access-date=7 June 2018}}
|-
|<pre>{{Cof species |genus=Vinagarra |species=elongata|access-date=7 June 2018}} </pre>
| {{Cof species |genus=Vinagarra |species=elongata|access-date=7 June 2018}}
|-
|<pre>{{Cof species |Abbottina|rivularis|access-date=7 June 2018}}</pre>
| {{Cof species |Abbottina|rivularis|access-date=7 June 2018}}
|-
|<pre>{{Cof species |Tylognathus|sinensis|access-date=7 June 2018}}</pre>
| {{Cof species |Tylognathus|sinensis|access-date=7 June 2018}}
|-
|<pre>{{Cof record |genid=150 |title=Syngnathus |access-date=8 June 2018}} </pre>
| {{Cof record |genid=150 |title=Syngnathus |access-date=8 June 2018}}
|-
|<pre>{{Cof record |spid=14756 |title=Syngnathus abaster |access-date=8 June 2018}}</pre>
| {{Cof record |spid=14756 |title=Syngnathus abaster |access-date=8 June 2018}}
|-
|<pre>{{Cof record |genid=150 |access-date=8 June 2018}} </pre>
| {{Cof record |genid=150 |access-date=8 June 2018}}
|-
|<pre>{{Cof record |spid=14756 |access-date=8 June 2018}}</pre>
| {{Cof record |spid=14756 |access-date=8 June 2018}}
|}


=== Using {{tl|FishBase/sandbox}} ===
{{Cof species |genus=Vinagarra |species=elongata|access-date=7 June 2018}}
{| class="wikitable"
{{Cof species |Abbottina|rivularis|7 June 2018}}
|-
{{Cof species |Tylognathus|sinensis|7 June 2018}}
! Template usage !! Results
|-
|Species with positional parameters]:
<pre>{{FishBase/sandbox|Danio|rerio|year=2018}} </pre>
| {{FishBase/sandbox|Danio|rerio|year=2018}}
|-
|Subspecies with position parameters:
<pre>{{FishBase/sandbox|Emmelichthys|nitidus|cyanescens}} </pre>
| {{FishBase/sandbox|Emmelichthys|nitidus|cyanescens}}
|-
|Species with named parameters:
<pre>{{FishBase/sandbox|genus=Danio|species=rerio}} </pre>
| {{FishBase/sandbox|genus=Danio|species=rerio}}
|-
|Subspecies with named parameters:
<pre>{{FishBase/sandbox|genus=Emmelichthys|species=nitidus|subspecies=cyanescens}} </pre>
| {{FishBase/sandbox|genus=Emmelichthys|species=nitidus|subspecies=cyanescens}}
|-
|Genus:
<pre>{{FishBase/sandbox|genus=Emmelichthys}}</pre>
| {{FishBase/sandbox|genus=Emmelichthys}}
|-
|Family:
<pre>{{FishBase/sandbox|family=Percidae}}</pre>
| {{FishBase/sandbox|family=Percidae}}
|-
|Order:
<pre>{{FishBase/sandbox|order=Perciformes|access-date=19 November 2018|mode=cs2}}</pre>
| {{FishBase/sandbox|order=Perciformes|access-date=19 November 2018|mode=cs2}}
|}


=== Using {{tl|BioRef}}===
{{Cof record |genid=150 |title=Syngnathus |access-date=8 June 2018}}
{{Cof record |spid=14756 |title=Syngnathus abaster |access-date=8 June 2018}}


'''Fishbase:'''
{{Cof record |genid=150 |access-date=8 June 2018}}
{{Cof record |spid=14756 |access-date=8 June 2018}}
</pre>
Results:


{| class="wikitable"
*{{Cof family |Xiphiidae|7 June 2018}}
|-
*{{Cof family |family=Xiphiidae |list=species |access-date=7 June 2018}}
! Template usage
*{{Cof family |family=Cyprinidae |access-date=7 June 2018}}
! Results
*{{Cof family |family=Cyprinidae |list=genus |access-date=7 June 2018}}
|-
|Species with positional parameters:
<pre>{{BioRef|fishbase|Danio|rerio}}</pre>
| {{BioRef|fishbase|Danio|rerio}}
|-
|Subspecies with positional parameters:
<pre>{{BioRef|fishbase|Emmelichthys|nitidus|cyanescens}}</pre>
| {{BioRef|fishbase|Emmelichthys|nitidus|cyanescens}}
|-
|Species with named parameters:
<pre>{{BioRef|fishbase|genus=Danio|species=rerio}}</pre>
| {{BioRef|fishbase|genus=Danio|species=rerio}}
|-
|Subspecies with named parameters:
<pre>{{BioRef|fishbase|genus=Emmelichthys|species=nitidus|subspecies=cyanescens}}</pre>
| {{BioRef|fishbase|genus=Emmelichthys|species=nitidus|subspecies=cyanescens}}
|-
|Genus:
<pre>{{BioRef|fishbase|genus=Emmelichthys}}</pre>
| {{BioRef|fishbase|genus=Emmelichthys}}
|-
|Family:
<pre>{{BioRef|fishbase|family=Percidae}}</pre>
| {{BioRef|fishbase|family=Percidae}}
|-
|Order:
<pre>{{BioRef|fishbase|order=Perciformes|access-date=19 November 2018|mode=cs2}}</pre>
| {{BioRef|fishbase|order=Perciformes|access-date=19 November 2018|mode=cs2}}
|}


<section begin=Herpetology />
<section begin=ASW6 />
'''Amphibian Species of the World (ASW6)'''
{| class="wikitable"
|-
! Template usage !! Results
|-
|Default page with family listing:
<pre>{{BioRef|ASW6 |access-date=27 September 2019}}</pre>
| {{BioRef|ASW6 |access-date=27 September 2019}}
|-
|Title + url:
<pre>{{BioRef|ASW6 |title=Hylidae Rafinesque, 1815|year=2019 |url=http://research.amnh.org/vz/herpetology/amphibia/Amphibia/Anura/Hylidae |access-date=27 September 2019}}</pre>
| {{BioRef|ASW6 |title=Hylidae Rafinesque, 1815|year=2019 |url=http://research.amnh.org/vz/herpetology/amphibia/Amphibia/Anura/Hylidae |access-date=27 September 2019}}
|-
|Family (currently only works for Anura):
<pre>{{BioRef|ASW6 |family=Hylidae |year=2019 |access-date=27 September 2019}}</pre>
| {{BioRef|ASW6 |family=Hylidae |year=2019 |access-date=27 September 2019}}
|-
|Genus + species (named parameters)::
<pre>{{BioRef|ASW6 |genus=Chiromantis |species=cherrapunjiae |year=2019 |access-date=27 September 2019}} </pre>
| {{BioRef|ASW6 |genus=Chiromantis |species=cherrapunjiae |year=2019 |access-date=27 September 2019}}
|-
|Genus + species (positional parameters)::
<pre>{{BioRef|ASW6 | Chiromantis| cherrapunjiae |year=2019 |access-date=27 September 2019}}</pre>
| {{BioRef|ASW6 | Chiromantis| cherrapunjiae |year=2019 |access-date=27 September 2019}}
<!--|-
|XXX:
<pre>XXX</pre>
| XXX-->
|-
|Note: the citation title can changed with {{para|title|My title}}
|}


<section end=ASW6 />
*{{Cof genus |Garra|7 June 2018}}
<section begin=AmphibiaWeb />
*{{Cof genus |genus=Vinagarra |access-date=7 June 2018}}
'''AmphibiaWeb'''
{| class="wikitable"
|-
! Template usage !! Results
|-
|Default page with for interactive family listing:
<pre>{{BioRef|amphibiaweb |access-date=27 September 2019}}</pre>
| {{BioRef|amphibiaweb |access-date=27 September 2019}}
|-
|Title with url:
<pre>{{BioRef|amphibiaweb |title=Ranidae |year=2019 |url=https://amphibiaweb.org/lists/Ranidae.shtml |access-date=27 September 2019}}</pre>
| {{BioRef|amphibiaweb |title=Ranidae |year=2019 |url=https://amphibiaweb.org/lists/Ranidae.shtml |access-date=27 September 2019}}
|-
|Family:
<pre>{{BioRef|amphibiaweb |family=Ranidae |year=2019 |access-date=27 September 2019}} </pre>
| {{BioRef|amphibiaweb |family=Ranidae |year=2019 |access-date=27 September 2019}}
|-
|Genus + species (named parameters):
<pre>{{BioRef|amphibiaweb |genus=Altiphrynoides |species=malcolmi |year=2019 |access-date=27 September 2019}}</pre>
| {{BioRef|amphibiaweb |genus=Altiphrynoides |species=malcolmi |year=2019 |access-date=27 September 2019}}
|-
|Genus + species (positional parameters):
<pre>{{BioRef|amphibiaweb | Altiphrynoides | malcolmi |year=2019 |access-date=27 September 2019}}</pre>
| {{BioRef|amphibiaweb | Altiphrynoides | malcolmi |year=2019 |access-date=27 September 2019}}
<!--|-
|XXX:
<pre>XXX</pre>
| XXX-->
|-
|Note: the citation title can changed with {{para|title|My title}}
|}


<section end=AmphibiaWeb />
<section begin=reptileDB />


'''Reptile database:'''
*{{Cof species |genus=Vinagarra |species=elongata|access-date=7 June 2018}}
{| class="wikitable"
*{{Cof species |Abbottina|rivularis|7 June 2018}}
|-
*{{Cof species |Tylognathus|sinensis|7 June 2018}}
! Template usage !! Results
|-
|Species:
<pre>{{BioRef|reptileDB |genus=Loxocemus |species=bicolor|access-date=22 November 2018}}</pre>
| {{BioRef|reptileDB |genus=Loxocemus |species=bicolor|access-date=22 November 2018}}
<!--|-
|Species (positional parameters):
<pre>{{BioRef|reptileDB |Loxocemus |bicolor|access-date=22 November 2018}}</pre>
| {{BioRef|reptileDB |Loxocemus |bicolor|access-date=22 November 2018}}-->
|-
|Species (positional parameters) with title:
<pre>{{BioRef|reptileDB |Python |natalensis |title=''Python natalensis'' SMITH, 1840|access-date=14 October 2019}}</pre>
| {{BioRef|reptileDB |Python |natalensis |title=''Python natalensis'' SMITH, 1840|access-date=14 October 2019}}
|-
|Genus:
<pre>{{BioRef|reptileDB |genus=Cylindrophis|access-date=22 November 2018}}</pre>
| {{BioRef|reptileDB |genus=Cylindrophis|access-date=22 November 2018}}
|-
|Use {{para|taxon}} parameter for higher taxa:
|-
|Family:
<pre>{{BioRef|reptileDB |taxon=Pythonidae|title=Species in Family Pythonidae|access-date=22 November 2018}}</pre>
| {{BioRef|reptileDB |taxon=Pythonidae|title=Species in Family Pythonidae|access-date=22 November 2018}}
|-
|Other taxon (e.g. infraorder):
<pre>{{BioRef|reptileDB |taxon=Alethinophidia|access-date=22 November 2018}}</pre>
| {{BioRef|reptileDB |taxon=Alethinophidia|access-date=22 November 2018}}
|}


<section end=reptileDB />
<section end=Herpetology />


'''ASM Mammal Diversity Database'''
*{{Cof record |genid=150 |title=Syngnathus |access-date=8 June 2018}}
* See also {{tl|cite mdd}}
*{{Cof record |spid=14756 |title=Syngnathus abaster |access-date=8 June 2018}}
{| class="wikitable"
|-
! Template usage !! Results
|-
|Family using {{para|taxon}} parameter:
<pre>{{BioRef|asm |order=Carnivora |access-date=28 February 2024 |mode=cs2}}</pre>
| {{BioRef|asm |order=Carnivora |access-date=28 February 2024 |mode=cs2}}
|-
|Family using {{para|family}} parameter:
<pre>{{BioRef|asm |family=Canidae |access-date=19 November 2018 |mode=cs2}}</pre>
| {{BioRef|asm |family=Canidae |access-date=19 November 2018 |mode=cs2}}
|-
|Genus using {{para|genus}} parameter:
<pre>{{BioRef|asm |genus=Ursus |access-date=19 November 2018}}</pre>
| {{BioRef|asm |genus=Ursus |access-date=19 November 2018}}
|-
|Species using {{para|id}} parameter:
<pre>{{BioRef|asm |id=8541 |title=Sand cat|access-date=19 November 2018}}</pre>
| {{BioRef|asm |id=8541 |title=Sand cat|access-date=19 November 2018}}
|-
|Species with {{para|genus}} and {{para|species}} parameters:
<pre>{{BioRef|asm |genus=Panthera|species=leo |access-date=19 November 2018}}</pre>
| {{BioRef|asm |genus=Panthera|species=leo |access-date=19 November 2018}}
|}


=== [[User:Jts1882/sandbox/template/asm]]===


*{{Cof record |genid=150 |access-date=8 June 2018}}
*{{User:Jts1882/sandbox/template/asm |order=Carnivora |access-date=19 November 2018 |mode=cs2}}
*{{Cof record |spid=14756 |access-date=8 June 2018}}
*{{User:Jts1882/sandbox/template/asm |family=Canidae |access-date=19 November 2018 |mode=cs2}}
*{{User:Jts1882/sandbox/template/asm |genus=Ursus |access-date=19 November 2018}}
*{{User:Jts1882/sandbox/template/asm |id=1005988 |title=Sand cat|access-date=19 November 2018}}
*{{User:Jts1882/sandbox/template/asm |genus=Panthera|species=leo |access-date=19 November 2018}}
<noinclude>
[[Category:Module documentation pages]]
</noinclude>

Latest revision as of 10:20, 19 September 2024

This module was created to generate {{cite web}} references to the Catalog of Fishes database. The capabilities were extended to handle other fish-related references and the module renamed FishRef. Further extension to cover taxonomy databases handling non-fish taxa led to creation of template {{BioRef}}. and {{Cite taxon}} templates and module name was changed to Cite taxon to better describe its function of handling citations for a wide variety taxonomy databases.

The module provides a wrapper to the citation template {{cite web}}, which means that the references can also include other parameters supported by the CS1/CS2 citation system. These include |access-date=, which is recommended, reference style formating parameters such as |mode=cs1|2 or |name-list-style=vanc, the archiving parameters |url-status=, |archive-url= and {{[para|archive-date}}, and other general parameter such as |quote=. The template supplies authors or editors for some databases, but for others these can be added using the cite web parameters |author=, |last=, |first= or the editor equivalents.

Templates using the module

[edit]

The module is used with {{Catalog of Fishes}}, which was designed to replace a series of templates that were originally written in the Wikipedia template language: {{Cof genus}}, {{Cof family}}, {{Cof species}}, {{Cof record}}.

Other templates using the module:

* The module currently handles ASW6, Amphibiaweb, Reptile Database, IOC, Avibase, TiF, WoRMS, POWO, GRIN, IPNI, World Plants, World Ferns, Tropicos, FNA, ATRF, Goffinet's Bryophyte classification, Algaebase, Paleobiology DB, ITIS

Usage of module

[edit]

General form: {{#invoke:Cite taxon|main|db|parameters}}

Examples: {{#invoke:Cite taxon|main|cof|parameters}}, {{#invoke:Cite taxon|main|fishbase|parameters}}, {{#invoke:Cite taxon|main|reptileDB|parameters}}, {{#invoke:Cite taxon|main|ASW6|parameters}}, {{#invoke:Cite taxon|main|POWO|parameters}}, etc.

The module stores information about each database in a data table (e.g. data.cof for Catalog of Fishes). The table has a CitationArgs table, for parameters to be passed to {{cite web}}, a CustomArgs table for parameters used for internal workings to set other {{cite web}} parameters, and one or more custom functions handling different types of citation parameter. Typical functions are id, species, genus, family, order, and taxon. Which functions are needed depend on the options provided by the external database, some use a common format with an id for all links, others have taxon-specific links.

General rules

[edit]

Different databases provide different options so uniformity is not possible. Some provide links that allow handling of species, genera, families, orders and other taxon ranks using the taxon names. This allows specific function to handle different taxa. Other just provide an id which can be used to generate the url, but needs a title. The following are the general rules for what functions are available:

  1. All databases can take a |title= and |url=. The templates then just add the general citation information about the website.
  2. Many take a |id=. The template will complete the url and add a default title, although adding a title is recommended.
  3. Some databases allow taxon names that can be used with |genus=, |family=, |order= or |taxon=
  4. Species can also often be handled when given |genus= and |species=, and in some cases also |subspecies=. These can usually be added as position parameters, but it is recommended that the parameter names are given


Examples of templates using the Module:FishRef

[edit]

Catalog of Fishes

[edit]

Examples using {{Catalog of Fishes}}

Template usage Results 
{{Catalog of Fishes |family=Xiphiidae |list=species |access-date=7 June 2018}}
 Eschmeyer, William N.; Fricke, Ron & van der Laan, Richard (eds.). "Species in the family Xiphiidae". Catalog of Fishes. California Academy of Sciences. Retrieved 7 June 2018. 
{{Catalog of Fishes |family=Cyprinidae |access-date=7 June 2018}}
 Eschmeyer, William N.; Fricke, Ron & van der Laan, Richard (eds.). "Genera in the family Cyprinidae". Catalog of Fishes. California Academy of Sciences. Retrieved 7 June 2018. 
{{Catalog of Fishes |family=Salmonidae |list=genus |access-date=7 June 2018}}
 Eschmeyer, William N.; Fricke, Ron & van der Laan, Richard (eds.). "Genera in the family Salmonidae". Catalog of Fishes. California Academy of Sciences. Retrieved 7 June 2018. 
{{Catalog of Fishes |genus=Vinagarra |access-date=7 June 2018}}
 Eschmeyer, William N.; Fricke, Ron & van der Laan, Richard (eds.). "Species in the genus Vinagarra". Catalog of Fishes. California Academy of Sciences. Retrieved 7 June 2018. 
{{Catalog of Fishes |genus=Vinagarra |species=elongata |access-date=7 June 2018}}
Eschmeyer, William N.; Fricke, Ron & van der Laan, Richard (eds.). "Species related to Vinagarra elongata". Catalog of Fishes. California Academy of Sciences. Retrieved 7 June 2018. 
{{Catalog of Fishes |genus=Abbottina |species=rivularis |access-date=7 June 2018}}
 Eschmeyer, William N.; Fricke, Ron & van der Laan, Richard (eds.). "Species related to Abbottina rivularis". Catalog of Fishes. California Academy of Sciences. Retrieved 7 June 2018. 
{{Catalog of Fishes |genus=Tylognathus |species=sinensis |access-date=7 June 2018}}
 Eschmeyer, William N.; Fricke, Ron & van der Laan, Richard (eds.). "Species related to Tylognathus sinensis". Catalog of Fishes. California Academy of Sciences. Retrieved 7 June 2018. 
{{Catalog of Fishes |genid=150  |access-date=8 June 2018}}
Eschmeyer, William N.; Fricke, Ron & van der Laan, Richard (eds.). "genid=150". Catalog of Fishes. California Academy of Sciences. Retrieved 8 June 2018. 
{{Catalog of Fishes |genid=150 |title=Syngnathus |access-date=8 June 2018}}
Eschmeyer, William N.; Fricke, Ron & van der Laan, Richard (eds.). "Syngnathus". Catalog of Fishes. California Academy of Sciences. Retrieved 8 June 2018. 
{{Catalog of Fishes|spid=14756  |access-date=8 June 2018}}
 Eschmeyer, William N.; Fricke, Ron & van der Laan, Richard (eds.). "spid=14756". Catalog of Fishes. California Academy of Sciences. Retrieved 8 June 2018. 
{{Catalog of Fishes |spid=14756 |title=Syngnathus abaster |access-date=8 June 2018}}
 Eschmeyer, William N.; Fricke, Ron & van der Laan, Richard (eds.). "Syngnathus abaster". Catalog of Fishes. California Academy of Sciences. Retrieved 8 June 2018.

Examples using {{Cof family}}, {{Cof genus}}, {{Cof species}} and {{Cof record}} templates

Template usage Results 
{{Cof family |Xiphiidae|access-date=7 June 2018}}
 Eschmeyer, William N.; Fricke, Ron & van der Laan, Richard (eds.). "Species in the genus Xiphiidae". Catalog of Fishes. California Academy of Sciences. Retrieved 7 June 2018. 
{{Cof family |family=Xiphiidae |list=species |access-date=7 June 2018}}
 Eschmeyer, William N.; Fricke, Ron & van der Laan, Richard (eds.). "Species in the family Xiphiidae". Catalog of Fishes. California Academy of Sciences. Retrieved 7 June 2018. 
{{Cof family |family=Cyprinidae |access-date=7 June 2018}}
 Eschmeyer, William N.; Fricke, Ron & van der Laan, Richard (eds.). "Genera in the family Cyprinidae". Catalog of Fishes. California Academy of Sciences. Retrieved 7 June 2018. 
{{Cof family |family=Salmonidae |list=genus |access-date=7 June 2018}}
 Eschmeyer, William N.; Fricke, Ron & van der Laan, Richard (eds.). "Genera in the family Salmonidae". Catalog of Fishes. California Academy of Sciences. Retrieved 7 June 2018. 
{{Cof genus |Garra|access-date=7 June 2018}}
 Eschmeyer, William N.; Fricke, Ron & van der Laan, Richard (eds.). "Species in the genus Garra". Catalog of Fishes. California Academy of Sciences. Retrieved 7 June 2018. 
{{Cof genus |genus=Vinagarra |access-date=7 June 2018}}
 Eschmeyer, William N.; Fricke, Ron & van der Laan, Richard (eds.). "Species in the genus Vinagarra". Catalog of Fishes. California Academy of Sciences. Retrieved 7 June 2018. 
{{Cof species |genus=Vinagarra |species=elongata|access-date=7 June 2018}}
Eschmeyer, William N.; Fricke, Ron & van der Laan, Richard (eds.). "Species related to Vinagarra elongata". Catalog of Fishes. California Academy of Sciences. Retrieved 7 June 2018. 
{{Cof species |Abbottina|rivularis|access-date=7 June 2018}}
 Eschmeyer, William N.; Fricke, Ron & van der Laan, Richard (eds.). "Species related to Abbottina rivularis". Catalog of Fishes. California Academy of Sciences. Retrieved 7 June 2018. 
{{Cof species |Tylognathus|sinensis|access-date=7 June 2018}}
 Eschmeyer, William N.; Fricke, Ron & van der Laan, Richard (eds.). "Species related to Tylognathus sinensis". Catalog of Fishes. California Academy of Sciences. Retrieved 7 June 2018. 
{{Cof record |genid=150 |title=Syngnathus |access-date=8 June 2018}}
Eschmeyer, William N.; Fricke, Ron & van der Laan, Richard (eds.). "Syngnathus". Catalog of Fishes. California Academy of Sciences. Retrieved 8 June 2018. 
{{Cof record |spid=14756 |title=Syngnathus abaster |access-date=8 June 2018}}
 Eschmeyer, William N.; Fricke, Ron & van der Laan, Richard (eds.). "Syngnathus abaster". Catalog of Fishes. California Academy of Sciences. Retrieved 8 June 2018. 
{{Cof record |genid=150  |access-date=8 June 2018}}
Eschmeyer, William N.; Fricke, Ron & van der Laan, Richard (eds.). "genid=150". Catalog of Fishes. California Academy of Sciences. Retrieved 8 June 2018. 
{{Cof record |spid=14756  |access-date=8 June 2018}}
 Eschmeyer, William N.; Fricke, Ron & van der Laan, Richard (eds.). "spid=14756". Catalog of Fishes. California Academy of Sciences. Retrieved 8 June 2018.

Using {{FishBase/sandbox}}

[edit]
Template usage Results
Species with positional parameters]: 
{{FishBase/sandbox|Danio|rerio|year=2018}}
Froese, Rainer; Pauly, Daniel, eds. (2018). "Danio rerio". FishBase.
Subspecies with position parameters: 
{{FishBase/sandbox|Emmelichthys|nitidus|cyanescens}}
Froese, Rainer; Pauly, Daniel (eds.). "Emmelichthys nitidus cyanescens". FishBase.
Species with named parameters: 
{{FishBase/sandbox|genus=Danio|species=rerio}}
Froese, Rainer; Pauly, Daniel (eds.). "Danio rerio". FishBase.
Subspecies with named parameters: 
{{FishBase/sandbox|genus=Emmelichthys|species=nitidus|subspecies=cyanescens}}
Froese, Rainer; Pauly, Daniel (eds.). "Emmelichthys nitidus cyanescens". FishBase.
Genus: 
{{FishBase/sandbox|genus=Emmelichthys}}
 Froese, Rainer; Pauly, Daniel (eds.). "Species in genus Emmelichthys". FishBase.
Family: 
{{FishBase/sandbox|family=Percidae}}
 Froese, Rainer; Pauly, Daniel (eds.). "Family Percidae". FishBase.
Order: 
{{FishBase/sandbox|order=Perciformes|access-date=19 November 2018|mode=cs2}}
 Froese, Rainer; Pauly, Daniel (eds.), "Order Perciformes", FishBase, retrieved 19 November 2018

Using {{BioRef}}

[edit]

Fishbase:

Template usage Results
Species with positional parameters: 
{{BioRef|fishbase|Danio|rerio}}
 Froese, Rainer; Pauly, Daniel (eds.). "Danio rerio". FishBase.
Subspecies with positional parameters: 
{{BioRef|fishbase|Emmelichthys|nitidus|cyanescens}}
 Froese, Rainer; Pauly, Daniel (eds.). "Emmelichthys nitidus cyanescens". FishBase.
Species with named parameters: 
{{BioRef|fishbase|genus=Danio|species=rerio}}
 Froese, Rainer; Pauly, Daniel (eds.). "Danio rerio". FishBase.
Subspecies with named parameters: 
{{BioRef|fishbase|genus=Emmelichthys|species=nitidus|subspecies=cyanescens}}
 Froese, Rainer; Pauly, Daniel (eds.). "Emmelichthys nitidus cyanescens". FishBase.
Genus: 
{{BioRef|fishbase|genus=Emmelichthys}}
 Froese, Rainer; Pauly, Daniel (eds.). "Species in genus Emmelichthys". FishBase.
Family: 
{{BioRef|fishbase|family=Percidae}}
 Froese, Rainer; Pauly, Daniel (eds.). "Family Percidae". FishBase.
Order: 
{{BioRef|fishbase|order=Perciformes|access-date=19 November 2018|mode=cs2}}
 Froese, Rainer; Pauly, Daniel (eds.), "Order Perciformes", FishBase, retrieved 19 November 2018


Amphibian Species of the World (ASW6)

Template usage Results
Default page with family listing: 
{{BioRef|ASW6 |access-date=27 September 2019}}
 Frost, Darrel R. "ASW Home". Amphibian Species of the World, an Online Reference. Version 6.0. American Museum of Natural History, New York. Retrieved 27 September 2019.
Title + url: 
{{BioRef|ASW6 |title=Hylidae Rafinesque, 1815|year=2019 |url=http://research.amnh.org/vz/herpetology/amphibia/Amphibia/Anura/Hylidae |access-date=27 September 2019}}
 Frost, Darrel R. (2019). "Hylidae Rafinesque, 1815". Amphibian Species of the World, an Online Reference. Version 6.0. American Museum of Natural History, New York. Retrieved 27 September 2019.
Family (currently only works for Anura): 
{{BioRef|ASW6 |family=Hylidae |year=2019  |access-date=27 September 2019}}
 Frost, Darrel R. (2019). "Hylidae". Amphibian Species of the World, an Online Reference. Version 6.0. American Museum of Natural History, New York. Retrieved 27 September 2019.
Genus + species (named parameters):: 
{{BioRef|ASW6 |genus=Chiromantis |species=cherrapunjiae |year=2019  |access-date=27 September 2019}}
Frost, Darrel R. (2019). "Search for taxon: Chiromantis cherrapunjiae". Amphibian Species of the World, an Online Reference. Version 6.0. American Museum of Natural History, New York. Retrieved 27 September 2019.
Genus + species (positional parameters):: 
{{BioRef|ASW6 | Chiromantis| cherrapunjiae |year=2019  |access-date=27 September 2019}}
 Frost, Darrel R. (2019). "Search for taxon: Chiromantis cherrapunjiae". Amphibian Species of the World, an Online Reference. Version 6.0. American Museum of Natural History, New York. Retrieved 27 September 2019.
Note: the citation title can changed with |title=My title


AmphibiaWeb

Template usage Results
Default page with for interactive family listing: 
{{BioRef|amphibiaweb |access-date=27 September 2019}}
 "AmphibiaWeb Family Taxonomy". AmphibiaWeb. University of California, Berkeley. Retrieved 27 September 2019.
Title with url: 
{{BioRef|amphibiaweb |title=Ranidae |year=2019 |url=https://amphibiaweb.org/lists/Ranidae.shtml |access-date=27 September 2019}}
 "Ranidae". AmphibiaWeb. University of California, Berkeley. 2019. Retrieved 27 September 2019.
Family: 
{{BioRef|amphibiaweb |family=Ranidae |year=2019 |access-date=27 September 2019}}
"Ranidae". AmphibiaWeb. University of California, Berkeley. 2019. Retrieved 27 September 2019.
Genus + species (named parameters): 
{{BioRef|amphibiaweb |genus=Altiphrynoides |species=malcolmi |year=2019 |access-date=27 September 2019}}
 "Altiphrynoides malcolmi". AmphibiaWeb. University of California, Berkeley. 2019. Retrieved 27 September 2019.
Genus + species (positional parameters): 
{{BioRef|amphibiaweb | Altiphrynoides | malcolmi |year=2019 |access-date=27 September 2019}}
 "Altiphrynoides malcolmi". AmphibiaWeb. University of California, Berkeley. 2019. Retrieved 27 September 2019.
Note: the citation title can changed with |title=My title



Reptile database:

Template usage Results
Species: 
{{BioRef|reptileDB |genus=Loxocemus |species=bicolor|access-date=22 November 2018}}
 Uetz, P.; et al. (eds.). "Loxocemus bicolor". The Reptile Database. Retrieved 22 November 2018.
Species (positional parameters) with title: 
{{BioRef|reptileDB |Python |natalensis |title=''Python natalensis'' SMITH, 1840|access-date=14 October 2019}}
 Uetz, P.; et al. (eds.). "Python natalensis SMITH, 1840". The Reptile Database. Retrieved 14 October 2019.
Genus: 
{{BioRef|reptileDB |genus=Cylindrophis|access-date=22 November 2018}}
 Uetz, P.; et al. (eds.). "Cylindrophis". The Reptile Database. Retrieved 22 November 2018.
Use |taxon= parameter for higher taxa:
Family: 
{{BioRef|reptileDB |taxon=Pythonidae|title=Species in Family Pythonidae|access-date=22 November 2018}}
 Uetz, P.; et al. (eds.). "Species in Family Pythonidae". The Reptile Database. Retrieved 22 November 2018.
Other taxon (e.g. infraorder): 
{{BioRef|reptileDB |taxon=Alethinophidia|access-date=22 November 2018}}
 Uetz, P.; et al. (eds.). "Alethinophidia". The Reptile Database. Retrieved 22 November 2018.



ASM Mammal Diversity Database

Template usage Results
Family using |taxon= parameter: 
{{BioRef|asm |order=Carnivora |access-date=28 February 2024 |mode=cs2}}
 "Carnivora", ASM Mammal Diversity Database, American Society of Mammalogists, retrieved 28 February 2024
Family using |family= parameter: 
{{BioRef|asm |family=Canidae |access-date=19 November 2018 |mode=cs2}}
 "Canidae", ASM Mammal Diversity Database, American Society of Mammalogists, retrieved 19 November 2018
Genus using |genus= parameter: 
{{BioRef|asm |genus=Ursus |access-date=19 November 2018}}
 "Ursus". ASM Mammal Diversity Database. American Society of Mammalogists. Retrieved 19 November 2018.
Species using |id= parameter: 
{{BioRef|asm |id=8541 |title=Sand cat|access-date=19 November 2018}}
 "Sand cat". ASM Mammal Diversity Database. American Society of Mammalogists. Retrieved 19 November 2018.
Species with |genus= and |species= parameters: 
{{BioRef|asm |genus=Panthera|species=leo |access-date=19 November 2018}}
 "Panthera leo". ASM Mammal Diversity Database. American Society of Mammalogists. Retrieved 19 November 2018.

User:Jts1882/sandbox/template/asm

[edit]
Retrieved from "https://en.wikipedia.org/w/index.php?title=Module:Cite_taxon/doc&oldid=1246504723"