Template:Metadata

From KeyToNature
Jump to: navigation, search
Documentation of this template
{{{Metadata Language}}}
{{{Title}}}
Description: {{{Description}}}
Caption: {{{Caption}}}
Content Modification: {{{Content Modification}}}
Creation Technique: {{{Creation Technique}}}

Creators: (Please consider adding this information)
Contributors: {{{Contributors}}}
Attribution: {{{Attribution Statement}}}
Attribution Logo URL: {{{Attribution Logo URL}}}
Attribution Link URL: {{{Attribution Link URL}}}
Copyright Owner: {{{Copyright Owner}}}
Copyright Statement: (Required information missing!)
License Statement: (Required information missing!)
License URL:
World Region: (Required information missing!)
Country Names: {{{Country Names}}}
Country Codes: (Required information missing!)
State or Province: {{{State or Province}}}
County or Subprovince: {{{County or Subprovince}}}
City or Place Name: {{{City or Place Name}}}
Locality: {{{Locality}}}
Subject Category: (Required information missing!)
General Keywords: {{{General Keywords}}}
Setting: {{{Setting}}}
Taxonomic Coverage: {{{Taxonomic Coverage}}}
Taxonomic Coverage: {{{Lowest Common Taxon}}}
Scientific Names: {{{Scientific Names}}}
Scientific Name Synonyms: {{{Scientific Name Synonyms}}}
Identified By: {{{Identified By}}}
Common Names: {{{Common Names}}}
Common Names: {{{Vernacular Names}}}
Associated Specimen ID: {{{Associated Specimen ID}}}
Associated Observation ID: {{{Associated Observation ID}}}
Association Info: {{{Association Info}}}
Published Source: {{{Published Source}}}
Peer Reviewer Name: {{{Peer Reviewer Name}}}
Peer Reviewer Comments: {{{Peer Reviewer Comments}}}
TypeType=‹empty›” is no recognized value. Valid values are for instance: “StillImage”, “Movie” or “IdentificationTool”. Details see documentation.
Subtype{{{Subtype}}}
Rating{{{Rating}}}
Language undetermined (und)
Original Creation Date{{{Original Creation Date}}}
Accession Date{{{Accession Date}}}
Digitization Date{{{Digitization Date}}}
Modified{{{Modified}}}
Resource ID(Resource IDs are urgently requested!)
Metadata Creator{{{Metadata Creator}}}
Metadata Manager{{{Metadata Manager}}}
Metadata Copyright Owner{{{Metadata Copyright Owner}}}
Metadata Modified{{{Metadata Modified}}}
Geocoordinates{{{Geocoordinates}}}
Elevation{{{Elevation}}}
Depth{{{Depth}}}
Compass Heading{{{Compass Heading}}}
Taxon Count{{{Taxon Count}}}
Subject Part{{{Subject Part}}}
Subject Sex{{{Subject Sex}}}
Subject Life Stage{{{Subject Life Stage}}}
Subject Orientation{{{Subject Orientation}}}
Derived From{{{Derived From}}}
Format{{{Format}}}
Offline Use{{{Offline Use}}}
Interactivity{{{Interactivity}}}
Host App.{{{Host Application}}}
Target System{{{Target System}}}
ID Tool Structure{{{ID Tool Structure}}}
Exchange Formats{{{Exchange Formats}}}
URIs: [{{{Homepage}}} Homepage] • [{{{Best Quality URI}}} Best Quality] ‹empty› is no recognized resource availability. Valid values are: “online (free)”, “online (portal)”, “online (login)”, “unpublished (digital)”, “published (digital)”, “unpublished”, “published”. • [{{{Good Quality URI}}} Good Quality] ‹empty› is no recognized resource availability. Valid values are: “online (free)”, “online (portal)”, “online (login)”, “unpublished (digital)”, “published (digital)”, “unpublished”, “published”. • [{{{Medium Quality URI}}} Medium Quality] ‹empty› is no recognized resource availability. Valid values are: “online (free)”, “online (portal)”, “online (login)”, “unpublished (digital)”, “published (digital)”, “unpublished”, “published”. • [{{{Lower Quality URI}}} Lower Quality] ‹empty› is no recognized resource availability. Valid values are: “online (free)”, “online (portal)”, “online (login)”, “unpublished (digital)”, “published (digital)”, “unpublished”, “published”. • [{{{Normal Preview URI}}} Normal Preview] ‹empty› is no recognized resource availability. Valid values are: “online (free)”, “online (portal)”, “online (login)”, “unpublished (digital)”, “published (digital)”, “unpublished”, “published”. • [{{{Tiny Preview URI}}} Tiny Preview] ‹empty› is no recognized resource availability. Valid values are: “online (free)”, “online (portal)”, “online (login)”, “unpublished (digital)”, “published (digital)”, “unpublished”, “published”. • [{{{Page Context URI}}} Page Context] ‹empty› is no recognized resource availability. Valid values are: “online (free)”, “online (portal)”, “online (login)”, “unpublished (digital)”, “published (digital)”, “unpublished”, “published”. • [{{{Exchange 1 URI}}} Exchange 1] ‹empty› is no recognized resource availability. Valid values are: “online (free)”, “online (portal)”, “online (login)”, “unpublished (digital)”, “published (digital)”, “unpublished”, “published”. • [{{{Exchange 2 URI}}} Exchange 2] ‹empty› is no recognized resource availability. Valid values are: “online (free)”, “online (portal)”, “online (login)”, “unpublished (digital)”, “published (digital)”, “unpublished”, “published”. • [{{{Exchange 3 URI}}} Exchange 3] ‹empty› is no recognized resource availability. Valid values are: “online (free)”, “online (portal)”, “online (login)”, “unpublished (digital)”, “published (digital)”, “unpublished”, “published”.
Error: attachments are valid only for Type = Collection!
[[{{{Wikitext Metadata Attachment}}} | Attached metadata records]] (Plain text file using Wiki metadata template syntax. Use Attachments only if records are too large to paste directly into the wiki page.)
[[{{{XML Metadata Attachment}}} | XML Metadata]] (Attached Metadata in an xml format ***TO BE DEFINED***; NOT YET ENABLED!)
— Collection: [[{{{Collection Page}}}]] — Provided by: [[{{{Provider Page}}}]]
[edit] [purge] Template-info.svg Template documentation

The metadata template[1] allows you to store metadata on external resources, especially identification tools or media resources, directly in a Wiki page. The template supports a number of metadata fields, some of which will only rarely be used. The set of metadata fields was decided upon in collaboration between Key to Nature, NBII, GBIF-MRTG, and Morphbank.

Resource collections are considered just another type of resources and can be described using the same template (using Type=Collection instead of Type=StillImage, IdentificationTool, etc.).

The importance of the metadata template is that it contains structured information that can be read by software agents. While it is possible to do some searches directly in the Wiki, software agents reading the information into a database can do more complex external queries. It is possible to design the system such that metadata editing is done directly in external databases, but we believe that the current solution has some advantages. For high value resources such as collections or identification tools, contributors are free to structure a special wiki page describing their resource in text and images, the structured metadata record being just a small part of that information. In other cases, where metadata are typically batch converted and submitted from another database, the Wiki-submission offers a simple low-tech and accessible method for batch submission, including some support for syntax checking on behalf of the submitter.

See How to add resource metadata on the Wiki for further information.

  1. A template is a Wiki page that, using a syntax of "{{pagename | parameter1=value1 | parameter2=value2 }}", can be called with parameters and thus reused many times.



Test records

Documentation of this template
Flag icon en.png
Ascochyta allii-cepae
This can be long text, describing the item in free-form text. This can be long text, describing the item in free-form text. This can be long text, describing the item in free-form text. This can be long text, describing the item in free-form text.

Creators: (Please consider adding this information)
Copyright Statement: (c) xyz xxx
License Statement: Creative commons cc-by-sa 3.0
World Region: (Required information missing!)
Country Codes: (Required information missing!)
Subject Category: (Required information missing!)
Scientific Names: Ascochyta allii-cepae Punith., Gladders & McKeown.
TypeStillImage
Language no linguistic content (zxx)
Resource ID768479362
Taxon Count1
Interactivityhyperlinked
ID Tool StructureDichotomous
URIs: Best Quality online (login)  • Medium Quality
Please add the “Collection Page”. Please add the “Provider Page”.
Documentation of this template
Example for erroneous resource type and missing URI
Creators: (Please consider adding this information)
Copyright Statement: (Required information missing!)
License Statement: (Required information missing!)
World Region: (Required information missing!)
Country Codes: (Required information missing!)
Subject Category: (Required information missing!)
TypeType=Image” is no recognized value. Did you mean “StillImage”?
Language undetermined (und)
Resource ID(Resource IDs are urgently requested!)
Interactivity'interactive' is no recognized value for interactivity; please use ‘n/a’, ‘static’, ‘hyperlinked’ or ‘dynamic’.
ID Tool Structure'dichtomous' is no recognized value for the structure of identification tools. Please specify something like ‘n/a’, ‘dichotomous’ or ‘multi-access’. For more values see documentation.
URIs:
Please add the “Collection Page”. Please add the “Provider Page”.

The first record as you would paste it into the wiki or edit (raw edit view):

{{Metadata
| Type=StillImage
| Title=Ascochyta allii-cepae 
| Description = This can be long text, describing the item in free-form text. This can be long text, describing the item in free-form text. This can be long text, describing the item in free-form text. This can be long text, describing the item in free-form text.
| Metadata Language=en 
| Language=zxx
| Resource ID=768479362 
| Copyright Statement= (c) xyz xxx 
| License Statement=Creative commons cc-by-sa 3.0
| Scientific Names=Ascochyta allii-cepae Punith., Gladders & McKeown.
| Taxon Count= 20 
| Taxon Count= 1
| Interactivity = hyperlinked  | ID Tool Structure = Dichotomous 
| Best Quality URI=http://160.45.63.11/Storage/Fungi/Coelos/AscochytaPunith/edt/AscP88-006.png
| Best Quality Availability=online (login)
| Medium Quality URI=http://160.45.63.11/Storage/Fungi/Coelos/AscochytaPunith/low/AscP88-006.png
| Medium Quality Availability=online (free)
}}

Note that blanks before or after the "=", and new lines between metadata fields do not matter. Also, the sequence of parameters does not matter. If parameters are repeated, only the last occurrence of the parameter will define the value (compare Taxon Count in the example above).


Additional temporary or technical documentation

This metadata infobox is full width, non-floating. It has two columns of fields (i.e. 3-4 table column) in the middle, plus some fields column spanning as a Header (Title, Logo, Descriptions) and Footer (URIs). Not all fields are labeled; those that are not are labeled with a tooltip (pop-up if mouse hovers).

FOOTER: Homepage, Best Quality URI + Best Quality Availability, Good Quality URI + Good Quality Availability, Medium Quality URI + Medium Quality Availability, Lower Quality URI + Lower Quality Availability, Normal Preview URI + Normal Preview Availability, Tiny Preview URI + Tiny Preview Availability,

(Only for Type=Collection:) Wikitext Metadata Attachment, XML Metadata Attachment (xml format needs to be defined)

Places where the Wiki differs from the general metadata agreement:

  • “Logo” is a Wiki image, not a URL
  • “Extent” and the various rank-specific taxon counts fields are not yet supported
  • “Secondary Service URIs” is not used
  • Agreement's “Service Attribution URI” is always a Wiki page, parameter name: “Provider Page”
  • Agreement's “Collection URI” is always a Wiki page, parameter name: “Collection Page”

TODO:

  • eval multiple languages to code like „it; en; de“ → Italiano • English • Deutsch (replace with File:… works but mot with language)