Jump to content

Module:Cite taxon/doc: Difference between revisions

From Wikipedia, the free encyclopedia
Content deleted Content added
general rules on use of module to support different databases and update on CS1/CS2 parameters
 
(One intermediate revision by the same user not shown)
Line 4: Line 4:
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 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.


; Templates using the module
=== 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}}.
Line 22: Line 22:
:<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
:<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


; Usage of module
=== Usage of module ===


General form: <nowiki>{{#invoke:Cite taxon|main|</nowiki>''db''<nowiki>|</nowiki>''parameters''<nowiki>}}</nowiki>
General form: <nowiki>{{#invoke:Cite taxon|main|</nowiki>''db''<nowiki>|</nowiki>''parameters''<nowiki>}}</nowiki>
Line 28: Line 28:
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.
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.
; General rules

=== 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:
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:

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.
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.