mirror of https://github.com/tdwg/dwc.git
Merged examples to simplified version.
This commit is contained in:
tucotuco
commit
978a4a1712
|
|
@ -1 +1,2 @@
|
|||
.idea
|
||||
.DS_Store
|
||||
|
|
|
|||
|
|
@ -1,4 +1,5 @@
|
|||
# Guidelines for contributing
|
||||
TITLE: Guidelines for contributing
|
||||
DESCRIPTION: This document describes how you can contribute to Darwin Core.
|
||||
|
||||
Changes to the standard are subject to the [change policy](change_policy.html). Here's how you can contribute:
|
||||
|
||||
|
|
|
|||
|
|
@ -24,6 +24,17 @@ body {
|
|||
padding-top: 20px;
|
||||
}
|
||||
|
||||
.anchor {
|
||||
display: block;
|
||||
position: relative;
|
||||
top: -70px;
|
||||
visibility: hidden;
|
||||
}
|
||||
|
||||
section .well h2 {
|
||||
margin-top: 10px; /* On terms page */
|
||||
}
|
||||
|
||||
.terms-sidebar {
|
||||
margin-top: 40px;
|
||||
}
|
||||
|
|
@ -52,16 +63,12 @@ body {
|
|||
text-decoration: none;
|
||||
}
|
||||
|
||||
.anchor {
|
||||
display: block;
|
||||
position: relative;
|
||||
top: -70px;
|
||||
visibility: hidden;
|
||||
}
|
||||
|
||||
.class-group .well h2 {
|
||||
margin-top: 10px;
|
||||
}
|
||||
.table {
|
||||
table-layout: fixed;
|
||||
}
|
||||
.table th {
|
||||
background-color: #e7e7e7;
|
||||
}
|
||||
|
||||
.dwc-table {
|
||||
table-layout: fixed;
|
||||
|
|
|
|||
|
|
@ -0,0 +1,128 @@
|
|||
<!DOCTYPE html>
|
||||
<html lang="en">
|
||||
<head>
|
||||
<meta charset="utf-8">
|
||||
<title>Darwin Core XML Guide</title>
|
||||
<link href="http://rs.tdwg.org/dwc/" rel="schema.DwC">
|
||||
<meta content="my title" name="DC.title">
|
||||
<meta content="" name="DC.description">
|
||||
<meta name="DC.modified" content="2015-01-15">
|
||||
|
||||
<meta name="dcterms.subject" content="biodiversity, standards">
|
||||
<meta name="dcterms.creator" content="Darwin Core Task Group">
|
||||
<meta name="dcterms.contributor" content="John Wieczorek (MVZ)">
|
||||
<meta name="dcterms.contributor" content="Markus Döring (GBIF)">
|
||||
<meta name="dcterms.contributor" content="Renato De Giovanni (CRIA)">
|
||||
<meta name="dcterms.contributor" content="Tim Robertson (GBIF)">
|
||||
<meta name="dcterms.contributor" content="Dave Vieglais (KUNHM)">
|
||||
<meta name="dcterms.contributor" content="Peter Desmet (INBO)">
|
||||
<meta name="dcterms.publisher" content="Biodiversity Information Standards (TDWG)">
|
||||
<meta name="dcterms.license" content="http://creativecommons.org/licenses/by/4.0/legalcode">
|
||||
<meta name="dcterms.language" content="en">
|
||||
<meta name="viewport" content="width=device-width, initial-scale=1">
|
||||
<link rel="stylesheet" type="text/css" href="../assets/bootstrap.min.css">
|
||||
<link rel="stylesheet" type="text/css" href="../assets/main.css">
|
||||
<link href="http://www.tdwg.org/" rel="meta">
|
||||
</head>
|
||||
|
||||
<body>
|
||||
<nav class="navbar navbar-default navbar-fixed-top">
|
||||
<div class="container">
|
||||
<div class="navbar-header">
|
||||
<button type="button" class="navbar-toggle collapsed" data-toggle="collapse" data-target=".navbar-collapse">
|
||||
<span class="sr-only">Toggle navigation</span>
|
||||
<span class="icon-bar"></span><span class="icon-bar"></span><span class="icon-bar"></span>
|
||||
</button>
|
||||
<a class="navbar-brand" href="../index.html">Darwin Core</a>
|
||||
</div>
|
||||
<div class="collapse navbar-collapse">
|
||||
<ul class="nav navbar-nav">
|
||||
<li><a href="../terms/index.html">Terms</a></li>
|
||||
<li><a href="../examples/index.html">Examples</a></li>
|
||||
<li class="dropdown">
|
||||
<a href="#" class="dropdown-toggle" data-toggle="dropdown" role="button" aria-expanded="false">Reference <span class="caret"></span></a>
|
||||
<ul class="dropdown-menu" role="menu">
|
||||
<li><a href="../change_policy.html">Change policy</a></li>
|
||||
<li class="divider"></li>
|
||||
<li><a href="../simple_dwc.html">Simple Darwin Core</a></li>
|
||||
<li class="divider"></li>
|
||||
<li><a href="../text/index.html">Text guide</a></li>
|
||||
<li class="active"><a href="../xml/index.html">XML guide</a></li>
|
||||
<li class="disabled"><a href="../rdf/index.html">RDF guide</a></li>
|
||||
<li class="divider"></li>
|
||||
<li><a href="../terms/history.html">Term history</a></li>
|
||||
<li><a href="../terms/decisions.html">Term decisions</a></li>
|
||||
<li><a href="../terms/mappings.html">Term mappings</a></li>
|
||||
</ul>
|
||||
</li>
|
||||
</ul>
|
||||
<ul class="nav navbar-nav navbar-right">
|
||||
<li><a href="../resources/index.html">Resources</a></li>
|
||||
<li><a href="http://github.com/tdwg/dwc">Source</a></li>
|
||||
</ul>
|
||||
</div>
|
||||
</div>
|
||||
</nav>
|
||||
|
||||
<div class="content">
|
||||
<div class="container">
|
||||
<div class="page-header">
|
||||
<h1>my title</h1>
|
||||
</div>
|
||||
<p>The build folder contains a python script to rebuild the terms index page and all resources.
|
||||
It will use the current terms/dwc_normaltive.rdf and some yaml configurations inside this build folder for term definitions and order.</p>
|
||||
<h2>Run the script</h2>
|
||||
<p>Install the required libraries for this script with PIP once:
|
||||
$ easy_install pip
|
||||
$ sudo pip install -r requirements.txt</p>
|
||||
<p>To run the script just run it from inside the build folder:
|
||||
$ ./update_terms.py</p>
|
||||
<h2>Adding new terms</h2>
|
||||
<p>Simple changes for definitions should just be done in the RDF file.
|
||||
In case a DwC term has been renamed, removed or added this also needs to be reflected in the following files:</p>
|
||||
<h3>dc.yaml</h3>
|
||||
<p>This file contains the Dublin Core terms to be used in the record level group in the right order and their DwC definitions.</p>
|
||||
<h3>term_order.yaml</h3>
|
||||
<p>This file contains a nested list of all DwC terms to be shown in the terms index.
|
||||
The order and grouping of terms is defined here, but the definitions and other metadata is taken from the dwc_normative.rdf</p>
|
||||
<h3>term_type.yaml</h3>
|
||||
<p>In order to generate the postgres sql table definition the script needs to know all data types different from the default <em>text</em>.
|
||||
This file contains a list of those terms with the exact data type as used in postgres.</p>
|
||||
<h2>TODO</h2>
|
||||
<ul>
|
||||
<li>add DOI explanations</li>
|
||||
</ul>
|
||||
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<footer class="footer">
|
||||
<div class="container">
|
||||
<div class="row">
|
||||
<div class="col-xs-4">
|
||||
<p><a rel="license" href="http://creativecommons.org/licenses/by/4.0/"><img alt="Creative Commons License" style="border-width:0" src="https://i.creativecommons.org/l/by/4.0/88x31.png"/></a></p>
|
||||
</div>
|
||||
<div class="col-xs-8">
|
||||
<ul class="list-inline pull-right">
|
||||
<li>Page last modified on 2015-01-15</li>
|
||||
<li><a href="https://github.com/tdwg/dwc/blob/gh-pages/resources.html">Edit on GitHub</a></li>
|
||||
</ul>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</footer>
|
||||
|
||||
<!-- Scripts -->
|
||||
<script type="text/javascript" src="../assets/jquery.min.js"></script>
|
||||
<script type="text/javascript" src="../assets/bootstrap.min.js"></script>
|
||||
<script>
|
||||
(function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
|
||||
(i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
|
||||
m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)
|
||||
})(window,document,'script','//www.google-analytics.com/analytics.js','ga');
|
||||
|
||||
ga('create', 'UA-386033-4', 'auto');
|
||||
ga('send', 'pageview');
|
||||
</script>
|
||||
</body>
|
||||
</html>
|
||||
|
|
@ -1,2 +1,31 @@
|
|||
add DOI explanations
|
||||
The build folder contains a python script to rebuild the terms index page and all resources.
|
||||
It will use the current terms/dwc_normaltive.rdf and some yaml configurations inside this build folder for term definitions and order.
|
||||
|
||||
## Run the script
|
||||
Install the required libraries for this script with PIP once:
|
||||
$ easy_install pip
|
||||
$ sudo pip install -r requirements.txt
|
||||
|
||||
To run the script just run it from inside the build folder:
|
||||
$ ./update_terms.py
|
||||
|
||||
|
||||
## Adding new terms
|
||||
Simple changes for definitions should just be done in the RDF file.
|
||||
In case a DwC term has been renamed, removed or added this also needs to be reflected in the following files:
|
||||
|
||||
### dc.yaml
|
||||
This file contains the Dublin Core terms to be used in the record level group in the right order and their DwC definitions.
|
||||
|
||||
### term_order.yaml
|
||||
This file contains a nested list of all DwC terms to be shown in the terms index.
|
||||
The order and grouping of terms is defined here, but the definitions and other metadata is taken from the dwc_normative.rdf
|
||||
|
||||
### term_type.yaml
|
||||
In order to generate the postgres sql table definition the script needs to know all data types different from the default _text_.
|
||||
This file contains a list of those terms with the exact data type as used in postgres.
|
||||
|
||||
|
||||
|
||||
## TODO
|
||||
- add DOI explanations
|
||||
|
|
|
|||
|
|
@ -0,0 +1,82 @@
|
|||
#!/usr/bin/env python
|
||||
|
||||
'''
|
||||
Install the required libraries for this script with PIP:
|
||||
$ easy_install pip
|
||||
$ sudo pip install -r requirements.txt
|
||||
|
||||
To run the script just run it from inside the build folder:
|
||||
$ ./buildsite.py
|
||||
'''
|
||||
|
||||
import re, codecs, os, mistune
|
||||
from os.path import isdir, join, isfile, abspath, splitext, basename
|
||||
import datetime as dt
|
||||
|
||||
|
||||
BASE="http://rs.gbif.org"
|
||||
|
||||
ROOT = abspath(join(os.curdir, os.pardir))
|
||||
PARAMS_MD = re.compile("^([A-Z0-9_]+)\s*\:\s*(.*)$", re.MULTILINE)
|
||||
MENU_PARAMS_HTML = re.compile("\$MENU[A-Z0-9_/]+", re.MULTILINE)
|
||||
|
||||
def traverse():
|
||||
print """building site starting at %s""" % ROOT
|
||||
with codecs.open(join(os.curdir, "header.inc"), 'r', 'utf-8') as f:
|
||||
header = f.read()
|
||||
with codecs.open(join(os.curdir, "footer.inc"), 'r', 'utf-8') as f:
|
||||
footer = f.read()
|
||||
startinglevel = ROOT.count(os.sep)
|
||||
for top, dirs, files in os.walk(ROOT):
|
||||
level = top.count(os.sep) - startinglevel
|
||||
print "traverse lvl %s" % level, top
|
||||
# skip hidden folders
|
||||
dirs[:] = [d for d in dirs if not d[0] == '.']
|
||||
for file in [f for f in files if not f[0] == '.']:
|
||||
(name, extension) = splitext(file)
|
||||
if extension == ".md":
|
||||
parse(level, join(top, name), header, footer)
|
||||
|
||||
def parse(level, fn, header, footer):
|
||||
mdFile = fn + ".md"
|
||||
htmlFile = fn + ".html"
|
||||
print """PARSE %s -> %s""" % (mdFile,htmlFile)
|
||||
(md, metadata)=parseMetadata(mdFile)
|
||||
print metadata
|
||||
body = mistune.markdown(md)
|
||||
path=fn[len(ROOT):]
|
||||
with codecs.open(htmlFile, 'w', 'utf-8') as f:
|
||||
f.write(processMetadata(header, level, path, metadata))
|
||||
f.write(processMetadata(body, level, path, metadata))
|
||||
f.write(processMetadata(footer, level, path, metadata))
|
||||
|
||||
def parseMetadata(mdFile):
|
||||
metadata={}
|
||||
with codecs.open(mdFile, 'r', 'utf-8') as f:
|
||||
md = f.read().strip()
|
||||
metadata["LAST_MODIFIED"]=str(dt.date.today())
|
||||
metadata["TITLE"]=""
|
||||
metadata["DESCRIPTION"]=""
|
||||
for m in PARAMS_MD.finditer(md):
|
||||
metadata[m.group(1)]=m.group(2).strip()
|
||||
md=PARAMS_MD.sub("", md)
|
||||
return (md, metadata)
|
||||
|
||||
def processMetadata(html, level, path, metadata):
|
||||
html=html.replace("$BASE", "../"*level)
|
||||
# replace menu vars
|
||||
html=html.replace("$MENU"+path.upper(), "active")
|
||||
html=MENU_PARAMS_HTML.sub("", html)
|
||||
for k, v in metadata.iteritems():
|
||||
html=html.replace("$"+k, v)
|
||||
return html
|
||||
|
||||
def anchorLinks(x):
|
||||
if x is None:
|
||||
return x
|
||||
return re.sub('(https?://\S+[a-zA-Z0-9/_-])', "<a href='\\1'>\\1</a>", x)
|
||||
|
||||
|
||||
|
||||
if __name__ == "__main__":
|
||||
traverse()
|
||||
|
|
@ -0,0 +1,34 @@
|
|||
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<footer class="footer">
|
||||
<div class="container">
|
||||
<div class="row">
|
||||
<div class="col-xs-4">
|
||||
<p><a rel="license" href="http://creativecommons.org/licenses/by/4.0/"><img alt="Creative Commons License" style="border-width:0" src="https://i.creativecommons.org/l/by/4.0/88x31.png"/></a></p>
|
||||
</div>
|
||||
<div class="col-xs-8">
|
||||
<ul class="list-inline pull-right">
|
||||
<li>Page last modified on $LAST_MODIFIED</li>
|
||||
<li><a href="https://github.com/tdwg/dwc/blob/gh-pages/resources.html">Edit on GitHub</a></li>
|
||||
</ul>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</footer>
|
||||
|
||||
<!-- Scripts -->
|
||||
<script type="text/javascript" src="../assets/jquery.min.js"></script>
|
||||
<script type="text/javascript" src="../assets/bootstrap.min.js"></script>
|
||||
<script>
|
||||
(function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
|
||||
(i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
|
||||
m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)
|
||||
})(window,document,'script','//www.google-analytics.com/analytics.js','ga');
|
||||
|
||||
ga('create', 'UA-386033-4', 'auto');
|
||||
ga('send', 'pageview');
|
||||
</script>
|
||||
</body>
|
||||
</html>
|
||||
|
|
@ -0,0 +1,71 @@
|
|||
<!DOCTYPE html>
|
||||
<html lang="en">
|
||||
<head>
|
||||
<meta charset="utf-8">
|
||||
<title>Darwin Core XML Guide</title>
|
||||
<link href="http://rs.tdwg.org/dwc/" rel="schema.DwC">
|
||||
<meta name="DC.title" content="$TITLE">
|
||||
<meta name="DC.description" content="$DESCRIPTION">
|
||||
<meta name="DC.modified" content="$LAST_MODIFIED">
|
||||
|
||||
<meta name="dcterms.subject" content="biodiversity, standards">
|
||||
<meta name="dcterms.creator" content="Darwin Core Task Group">
|
||||
<meta name="dcterms.contributor" content="John Wieczorek (MVZ)">
|
||||
<meta name="dcterms.contributor" content="Markus Döring (GBIF)">
|
||||
<meta name="dcterms.contributor" content="Renato De Giovanni (CRIA)">
|
||||
<meta name="dcterms.contributor" content="Tim Robertson (GBIF)">
|
||||
<meta name="dcterms.contributor" content="Dave Vieglais (KUNHM)">
|
||||
<meta name="dcterms.contributor" content="Peter Desmet (INBO)">
|
||||
<meta name="dcterms.publisher" content="Biodiversity Information Standards (TDWG)">
|
||||
<meta name="dcterms.license" content="http://creativecommons.org/licenses/by/4.0/legalcode">
|
||||
<meta name="dcterms.language" content="en">
|
||||
<meta name="viewport" content="width=device-width, initial-scale=1">
|
||||
<link rel="stylesheet" type="text/css" href="$BASEassets/bootstrap.min.css">
|
||||
<link rel="stylesheet" type="text/css" href="$BASEassets/main.css">
|
||||
</head>
|
||||
|
||||
<body>
|
||||
<nav class="navbar navbar-default navbar-fixed-top">
|
||||
<div class="container">
|
||||
<div class="navbar-header">
|
||||
<button type="button" class="navbar-toggle collapsed" data-toggle="collapse" data-target=".navbar-collapse">
|
||||
<span class="sr-only">Toggle navigation</span>
|
||||
<span class="icon-bar"></span><span class="icon-bar"></span><span class="icon-bar"></span>
|
||||
</button>
|
||||
<a class="navbar-brand" href="$BASEindex.html">Darwin Core</a>
|
||||
</div>
|
||||
<div class="collapse navbar-collapse">
|
||||
<ul class="nav navbar-nav">
|
||||
<li class="$MENU/TERMS/INDEX"><a href="$BASEterms/index.html">Terms</a></li>
|
||||
<li class="$MENU/EXAMPLES/INDEX"><a href="$BASEexamples/index.html">Examples</a></li>
|
||||
<li class="dropdown">
|
||||
<a href="#" class="dropdown-toggle" data-toggle="dropdown" role="button" aria-expanded="false">Reference <span class="caret"></span></a>
|
||||
<ul class="dropdown-menu" role="menu">
|
||||
<li class="$MENU/CHANGE_POLICY"><a href="$BASEchange_policy.html">Change policy</a></li>
|
||||
<li class="divider"></li>
|
||||
<li class="$MENU/SIMPLE_DWC"><a href="$BASEsimple_dwc.html">Simple Darwin Core</a></li>
|
||||
<li class="divider"></li>
|
||||
<li class="$MENU/GUIDES/TEXT/INDEX"><a href="$BASEguides/text/index.html">Text guide</a></li>
|
||||
<li class="$MENU/GUIDES/XML/INDEX"><a href="$BASEguides/xml/index.html">XML guide</a></li>
|
||||
<li class="$MENU/GUIDES/RDF/INDEX disabled"><a href="$BASEguides/rdf/index.html">RDF guide</a></li>
|
||||
<li class="divider"></li>
|
||||
<li class="$MENU/TERMS/HISTORY"><a href="$BASEterms/history.html">Term history</a></li>
|
||||
<li class="$MENU/TERMS/DECISIONS"><a href="$BASEterms/decisions.html">Term decisions</a></li>
|
||||
<li class="$MENU/TERMS/MAPPINGS"><a href="$BASEterms/mappings.html">Term mappings</a></li>
|
||||
</ul>
|
||||
</li>
|
||||
</ul>
|
||||
<ul class="nav navbar-nav navbar-right">
|
||||
<li class="$MENU/RESOURCES/INDEX"><a href="$BASEresources/index.html">Resources</a></li>
|
||||
<li><a href="http://github.com/tdwg/dwc">Source</a></li>
|
||||
</ul>
|
||||
</div>
|
||||
</div>
|
||||
</nav>
|
||||
|
||||
<div class="content">
|
||||
<div class="container">
|
||||
<div class="page-header">
|
||||
<h1>$TITLE</h1>
|
||||
<p>$DESCRIPTION</p>
|
||||
</div>
|
||||
|
|
@ -1,3 +1,4 @@
|
|||
Cheetah==2.4.4
|
||||
rdflib==4.1.2
|
||||
PyYAML==3.11
|
||||
PyYAML==3.11
|
||||
mistune
|
||||
|
|
@ -86,10 +86,7 @@
|
|||
#else
|
||||
<table class="table table-bordered table-condensed dwc-table class-definition">
|
||||
#end if
|
||||
<colgroup>
|
||||
<col />
|
||||
<col />
|
||||
</colgroup>
|
||||
<colgroup><col /><col /></colgroup>
|
||||
<tbody>
|
||||
<tr><td colspan="2">$t.name</td></tr>
|
||||
<tr><td>Label</td><td>$t.label</td></tr>
|
||||
|
|
@ -106,7 +103,7 @@
|
|||
#end if
|
||||
#end def
|
||||
#for $group in $groups
|
||||
<section class="class-group">
|
||||
<section>
|
||||
<a id="$group.name" class="anchor"></a>
|
||||
<header class="well">
|
||||
<h2>$group.name</h2>
|
||||
|
|
|
|||
|
|
@ -1,8 +1,12 @@
|
|||
#!/usr/bin/env python
|
||||
|
||||
'''
|
||||
easy_install pip
|
||||
pip install -r requirements.txt
|
||||
Install the required libraries for this script with PIP:
|
||||
$ easy_install pip
|
||||
$ sudo pip install -r requirements.txt
|
||||
|
||||
To run the script just run it from inside the build folder:
|
||||
$ ./update_terms.py
|
||||
'''
|
||||
|
||||
import yaml, re, csv, codecs
|
||||
|
|
|
|||
|
|
@ -69,10 +69,10 @@
|
|||
<h1>Change policy</h1>
|
||||
</div>
|
||||
|
||||
<h2>Introduction</h2>
|
||||
<h2>1. Introduction</h2>
|
||||
<p>This document and the policies contained herein are modeled on the <em>Dublin Core Metadata Initiative Namespace Policy</em> [<a href="http://dublincore.org/documents/2007/07/02/dcmi-namespace/">DCMINAMESPACEPOLICY</a>]. All terms in the Darwin Core must be identified with a unique Uniform Resource Identifier (URI). For convenience, the term URIs are grouped into collections known as <em>Darwin Core namespaces</em>. This document describes the policies associated with Darwin Core namespaces and how term URIs are allocated by the <em>Darwin Core Task Group</em> [<a href="http://www.tdwg.org/activities/darwincore/">DWC-TASK</a>].</p>
|
||||
|
||||
<h2>Namespace URIs</h2>
|
||||
<h2>2. Namespace URIs</h2>
|
||||
<p>The Darwin Core namespace URI for the collection of all Darwin Core properties, classes, and encoding schemes is:</p>
|
||||
<pre class="example">http://rs.tdwg.org/dwc/terms/</pre>
|
||||
<p>The term identifier for the current (recommended) version of a term is a URI based on the namespace and the term name without version information. Some example Darwin Core term identifiers follow:</p>
|
||||
|
|
@ -83,32 +83,32 @@
|
|||
<p>All Darwin Core identifiers will dereference to a Darwin Core term
|
||||
declaration for the identified term.</p>
|
||||
|
||||
<h2>Term change policy</h2>
|
||||
<h2>3. Term change policy</h2>
|
||||
<p>Changes to Darwin Core recommendations or term declarations will occur from time to time for a variety of reasons. Changes have varying implications for the decision making process and for versioning Darwin Core documents and term URIs. The types of changes and appropriate processes are identified and explained in the following sections.</p>
|
||||
<p><strong>Reporting issues</strong>: In all cases the proposed change should be reported to the <em>Technical Architecture Group</em> [<a href="mailto:tdwg-tag@lists.tdwg.org">TDWG-TAG</a>] and the outcome of the proposal should be announced on the <em>Darwin Core mailing list</em> [<a href="http://lists.tdwg.org/mailman/listinfo/tdwg-content">TDWG-CONTENT</a>].</p>
|
||||
<p><strong>Decisions</strong>: In cases where an Executive decision is required,the <em>Technical Architecture Group</em> will conduct a minimum 30-day public comment period on the <em>Darwin Core mailing list</em> [<a href="http://lists.tdwg.org/mailman/listinfo/tdwg-content">TDWG-CONTENT</a>], during which the proposal can be refined based on discussion in an effort to reach consensus (no dissenting opinion expressed publicly on the mailing list for 30 days from the most recent iteration). If a consensus is reached, the proposal will be presented by the <em>Technical Architecture Group</em> to the Executive Committee for a decision [<a href="terms/decisions.html">DECISIONS</a>] within 30 days.</p>
|
||||
<p><strong>Versions</strong>: In cases where a decision requires a version change, the attributes <em>Status</em> (recommended, superseded, or deprecated), <em>Date Issued</em>, <em>Date Modified</em>, <em>Decision</em>, <em>Version</em>, <em>Replaces</em>, and <em>Is Replaced By</em> will be modified in the affected terms as appropriate.</p>
|
||||
|
||||
<h3>Minor editorial errata</h3>
|
||||
<h3>3.1 Minor editorial errata</h3>
|
||||
<p>An error in spelling, punctuation, grammar, or other clerical mistake
|
||||
discovered in a Darwin Core recommendation or term declaration may be
|
||||
corrected without a public comment period or Executive Decision. Minor
|
||||
editorial changes of this type do not require a version change for the
|
||||
affected term and/or documents.</p>
|
||||
|
||||
<h3>Substantive editorial errata</h3>
|
||||
<h3>3.2 Substantive editorial errata</h3>
|
||||
<p>A substantive error is one that compromises the usefulness or accuracy of systems based on Darwin Core. Those that are unequivocal (for example, an incorrect URI or reference) may be treated as minor editorial errata (Section 3.1).</p>
|
||||
<p>Otherwise, the <em>Technical Architecture Group</em> will conduct a public comment period and seek an Executive decision to find a solution that minimizes adverse effects on existing applications. Changes of this nature require a version change for the affected term and/or documents.</p>
|
||||
|
||||
<h3>Semantic changes to Darwin Core terms</h3>
|
||||
<h3>3.3 Semantic changes to Darwin Core terms</h3>
|
||||
<p>Darwin Core terms may be changed based on public demand and consensus. A request to the <em>Technical Architecture Group</em> for a term change should consist of proposed values for the complete list of attributes given in the term definitions section of the <em>Darwin Core Terms Complete History</em> [<a href="terms/history.html">HISTORY</a>] along with a statement of justification for the change.</p>
|
||||
<p>Term changes that are likely to have substantial functional impact on human understanding or machine processing will posted for public commentary and an Executive decision. Changes of this nature require a version change for the affected term and/or documents.</p>
|
||||
|
||||
<h3>Addition of Darwin Core terms</h3>
|
||||
<h3>3.4 Addition of Darwin Core terms</h3>
|
||||
<p>New terms may be added to the Darwin Core namespaces based on public demand and consensus. A request to the <em>Technical Architecture Group</em> [<a href="mailto:tdwg-tag@lists.tdwg.org">TDWG-TAG</a>] for a new term should consist of proposed values for the complete list of attributes given in the term definitions section of the <em>Darwin Core Terms Complete History</em> [<a href="terms/history.html">HISTORY</a>] along with a statement of justification for the new term, including an explanation of why no existing term will suffice.</p>
|
||||
<p>New term proposals will be posted for public commentary and an Executive decision. Changes of this nature require a version change for the affected term and/or documents.</p>
|
||||
|
||||
<h2>Persistence policy</h2>
|
||||
<h2>4. Persistence policy</h2>
|
||||
<p>TDWG recognizes that people and applications depend on the persistence of formal documents and machine processable schemas that have been made publicly available. In particular, the stability of Darwin Core term URIs and Darwin Core namespace URIs is critical to interoperability over time. Thus, the wide promulgation of this set of URIs dictates that they be maintained to support legacy applications that have adopted them.</p>
|
||||
</div>
|
||||
</div>
|
||||
|
|
|
|||
|
|
@ -70,7 +70,6 @@
|
|||
</div>
|
||||
|
||||
<p>Following are links to examples of marking up data in Darwin Core:</p>
|
||||
|
||||
<ul>
|
||||
<h2><li><a href="examples_specimen.md">Specimens</a></li></h2>
|
||||
<h2><li><a href="examples_observation.md">Observations</a></li></h2>
|
||||
|
|
|
|||
|
|
@ -0,0 +1,109 @@
|
|||
<!DOCTYPE html>
|
||||
<html lang="en">
|
||||
<head>
|
||||
<meta charset="utf-8">
|
||||
<title>Darwin Core RDF Guide</title>
|
||||
<link href="http://rs.tdwg.org/dwc/" rel="schema.DwC">
|
||||
<meta content="Darwin Core RDF Guide" name="DC.title">
|
||||
<meta content="Guidelines for implementing Darwin Core as RDF." name="DC.description">
|
||||
<meta name="DC.modified" content="2015-01-13"><!-- Also update in footer -->
|
||||
|
||||
<meta name="dcterms.subject" content="biodiversity, standards">
|
||||
<meta name="dcterms.creator" content="Darwin Core Task Group">
|
||||
<meta name="dcterms.contributor" content="John Wieczorek (MVZ)">
|
||||
<meta name="dcterms.contributor" content="Markus Döring (GBIF)">
|
||||
<meta name="dcterms.contributor" content="Renato De Giovanni (CRIA)">
|
||||
<meta name="dcterms.contributor" content="Tim Robertson (GBIF)">
|
||||
<meta name="dcterms.contributor" content="Dave Vieglais (KUNHM)">
|
||||
<meta name="dcterms.contributor" content="Peter Desmet (INBO)">
|
||||
<meta name="dcterms.publisher" content="Biodiversity Information Standards (TDWG)">
|
||||
<meta name="dcterms.license" content="http://creativecommons.org/licenses/by/4.0/legalcode">
|
||||
<meta name="dcterms.language" content="en">
|
||||
<meta name="viewport" content="width=device-width, initial-scale=1">
|
||||
<link rel="stylesheet" type="text/css" href="../../assets/bootstrap.min.css">
|
||||
<link rel="stylesheet" type="text/css" href="../../assets/main.css">
|
||||
<link href="http://www.tdwg.org/" rel="meta">
|
||||
</head>
|
||||
|
||||
<body>
|
||||
<nav class="navbar navbar-default navbar-fixed-top">
|
||||
<div class="container">
|
||||
<div class="navbar-header">
|
||||
<button type="button" class="navbar-toggle collapsed" data-toggle="collapse" data-target=".navbar-collapse">
|
||||
<span class="sr-only">Toggle navigation</span>
|
||||
<span class="icon-bar"></span><span class="icon-bar"></span><span class="icon-bar"></span>
|
||||
</button>
|
||||
<a class="navbar-brand" href="../index.html">Darwin Core</a>
|
||||
</div>
|
||||
<div class="collapse navbar-collapse">
|
||||
<ul class="nav navbar-nav">
|
||||
<li><a href="../../terms/index.html">Terms</a></li>
|
||||
<li><a href="../../examples/index.html">Examples</a></li>
|
||||
<li class="dropdown">
|
||||
<a href="#" class="dropdown-toggle" data-toggle="dropdown" role="button" aria-expanded="false">Reference <span class="caret"></span></a>
|
||||
<ul class="dropdown-menu" role="menu">
|
||||
<li><a href="../../change_policy.html">Change policy</a></li>
|
||||
<li class="divider"></li>
|
||||
<li><a href="../../simple_dwc.html">Simple Darwin Core</a></li>
|
||||
<li class="divider"></li>
|
||||
<li><a href="../text/index.html">Text guide</a></li>
|
||||
<li><a href="../xml/index.html">XML guide</a></li>
|
||||
<li class="disabled active"><a href="../rdf/index.html">RDF guide</a></li>
|
||||
<li class="divider"></li>
|
||||
<li><a href="../../terms/history.html">Term history</a></li>
|
||||
<li><a href="../../terms/decisions.html">Term decisions</a></li>
|
||||
<li><a href="../../terms/mappings.html">Term mappings</a></li>
|
||||
</ul>
|
||||
</li>
|
||||
</ul>
|
||||
<ul class="nav navbar-nav navbar-right">
|
||||
<li><a href="../../resources/index.html">Resources</a></li>
|
||||
<li><a href="http://github.com/tdwg/dwc">Source</a></li>
|
||||
</ul>
|
||||
</div>
|
||||
</div>
|
||||
</nav>
|
||||
|
||||
<div class="content">
|
||||
<div class="container">
|
||||
<div class="page-header">
|
||||
<h1>Darwin Core RDF Guide</h1>
|
||||
</div>
|
||||
|
||||
<h2 id="introduction">1. Introduction</h2>
|
||||
|
||||
<p>This guide has to be added still.</p>
|
||||
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<footer class="footer">
|
||||
<div class="container">
|
||||
<div class="row">
|
||||
<div class="col-xs-4">
|
||||
<p><a rel="license" href="http://creativecommons.org/licenses/by/4.0/"><img alt="Creative Commons License" style="border-width:0" src="https://i.creativecommons.org/l/by/4.0/88x31.png"/></a></p>
|
||||
</div>
|
||||
<div class="col-xs-8">
|
||||
<ul class="list-inline pull-right">
|
||||
<li>Page last modified on 2015-01-13</li>
|
||||
<li><a href="https://github.com/tdwg/dwc/blob/gh-pages/resources.html">Edit on GitHub</a></li>
|
||||
</ul>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</footer>
|
||||
|
||||
<!-- Scripts -->
|
||||
<script type="text/javascript" src="../../assets/jquery.min.js"></script>
|
||||
<script type="text/javascript" src="../../assets/bootstrap.min.js"></script>
|
||||
<script>
|
||||
(function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
|
||||
(i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
|
||||
m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)
|
||||
})(window,document,'script','//www.google-analytics.com/analytics.js','ga');
|
||||
|
||||
ga('create', 'UA-386033-4', 'auto');
|
||||
ga('send', 'pageview');
|
||||
</script>
|
||||
</body>
|
||||
</html>
|
||||
File diff suppressed because it is too large
Load Diff
Binary file not shown.
|
Before Width: | Height: | Size: 16 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 5.5 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 39 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 14 KiB |
|
|
@ -37,8 +37,8 @@
|
|||
</div>
|
||||
<div class="collapse navbar-collapse">
|
||||
<ul class="nav navbar-nav">
|
||||
<li><a href="../terms/index.html">Terms</a></li>
|
||||
<li><a href="../examples/index.html">Examples</a></li>
|
||||
<li><a href="../../terms/index.html">Terms</a></li>
|
||||
<li><a href="../../examples/index.html">Examples</a></li>
|
||||
<li class="dropdown">
|
||||
<a href="#" class="dropdown-toggle" data-toggle="dropdown" role="button" aria-expanded="false">Reference <span class="caret"></span></a>
|
||||
<ul class="dropdown-menu" role="menu">
|
||||
|
|
@ -78,15 +78,15 @@
|
|||
files and complementary metadata files that describe their content.</p>
|
||||
|
||||
<p>This document provides guidelines for formatting and sharing Darwin Core
|
||||
terms [<a href="../../index.htm">TERMS</a>] in <em>fielded text</em> formats,
|
||||
terms [<a href="../../index.html">TERMS</a>] in <em>fielded text</em> formats,
|
||||
such as one or more comma separated value (CSV) files. Data conforming to the
|
||||
Simple Darwin Core [<a href="../../simple/index.htm">SIMPLEDWC</a>] (CSV
|
||||
Simple Darwin Core [<a href="../../simple.html">SIMPLEDWC</a>] (CSV
|
||||
format and having the first row include Darwin Core standard term names) can
|
||||
be shared in a single file, while a non-standard text file can be understood
|
||||
using an [<a href="http://www.w3.org/XML/">XML</a>] metafile to describe its
|
||||
contents and formatting.</p>
|
||||
|
||||
<img src="images/usage.png">
|
||||
<p><img src="images/usage.png"></p>
|
||||
|
||||
<p>More complex structure can be shared in multiple related files. The
|
||||
description of content and relationships between files can be achieved using
|
||||
|
|
@ -120,11 +120,11 @@ ID,Species,Count
|
|||
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
|
||||
xmlns:xs="http://www.w3.org/2001/XMLSchema"
|
||||
xsi:schemaLocation="http://rs.tdwg.org/dwc/text/ http://rs.tdwg.org/dwc/text/tdwg_dwc_text.xsd">
|
||||
<core rowType="http://rs.tdwg.org/dwc/xsd/simpledarwincore/SimpleDarwinRecord" ignoreHeaderLines="1">
|
||||
<core rowType="http://rs.tdwg.org/dwc/terms/Occurrence" ignoreHeaderLines="1">
|
||||
<files>
|
||||
<location>http://data.gbif.org/download/specimens.csv</location>
|
||||
</files>
|
||||
<field index="0" term="http://rs.tdwg.org/dwc/terms/catalogNumber" />
|
||||
<field index="0" term="http://rs.tdwg.org/dwc/terms/occurrenceID" />
|
||||
<field index="1" term="http://rs.tdwg.org/dwc/terms/scientificName" />
|
||||
<field index="2" term="http://rs.tdwg.org/dwc/terms/individualCount" />
|
||||
<!-- A constant value has no index, but applies to all rows -->
|
||||
|
|
@ -137,12 +137,12 @@ ID,Species,Count
|
|||
of the CSV file contained the term names:</p>
|
||||
|
||||
<pre class="example">
|
||||
type,institutionCode,collectionCode,catalogNumber,scientificName,individualCount,datasetID
|
||||
PhysicalObject,ANSP,PH,123,"Cryptantha gypsophila Reveal & C.R. Broome",12,urn:lsid:tim.lsid.tdwg.org:collections:1
|
||||
PhysicalObject,ANSP,PH,124,"Buxbaumia piperi",2,urn:lsid:tim.lsid.tdwg.org:collections:1
|
||||
occurrenceID,scientificName,individualCount,datasetID
|
||||
123,"Cryptantha gypsophila Reveal & C.R. Broome",12,urn:lsid:tim.lsid.tdwg.org:collections:1
|
||||
124,"Buxbaumia piperi",2,urn:lsid:tim.lsid.tdwg.org:collections:1
|
||||
</pre>
|
||||
|
||||
<h3>1.2 XML versus <em>Fielded Text</em></h3>
|
||||
<h3>1.2 XML versus Fielded Text</h3>
|
||||
|
||||
<p>Many resources exist on the web describing the advantages of Extensible
|
||||
Markup Language [<a href="http://www.w3.org/XML/">XML</a>] over less
|
||||
|
|
@ -167,8 +167,8 @@ PhysicalObject,ANSP,PH,124,"Buxbaumia piperi",2,urn:lsid:tim.lsid.tdwg.org:colle
|
|||
|
||||
<h2 id="metafile">2. Metafile Content</h2>
|
||||
|
||||
<p>The text metafile schema [<a href=
|
||||
"../../../text/tdwg_dwc_text.xsd">TEXTSCHEMA</a>] provides technical details
|
||||
<p>The text metafile schema [<a href="tdwg_dwc_text.xsd">TEXTSCHEMA</a>]
|
||||
provides technical details
|
||||
for the structure of a metafile by defining the elements and attributes
|
||||
required to describe the contents and relationships between text files. These
|
||||
elements and attributes, with descriptions and specifications for their use
|
||||
|
|
@ -183,20 +183,14 @@ PhysicalObject,ANSP,PH,124,"Buxbaumia piperi",2,urn:lsid:tim.lsid.tdwg.org:colle
|
|||
|
||||
<h4>Attributes</h4>
|
||||
|
||||
<table class="border">
|
||||
<thead>
|
||||
<table class="table table-bordered table-condensed dwc-table">
|
||||
<tr>
|
||||
<th>Attribute</th>
|
||||
|
||||
<th>Description</th>
|
||||
|
||||
<th>Required</th>
|
||||
|
||||
<th>Default</th>
|
||||
</tr>
|
||||
</thead>
|
||||
|
||||
<tbody>
|
||||
<tr>
|
||||
<td class=""><em>metadata</em></td>
|
||||
|
||||
|
|
@ -209,19 +203,14 @@ PhysicalObject,ANSP,PH,124,"Buxbaumia piperi",2,urn:lsid:tim.lsid.tdwg.org:colle
|
|||
<td></td>
|
||||
<td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>Elements
|
||||
|
||||
<table class="border">
|
||||
<thead>
|
||||
</table>
|
||||
|
||||
<h4>Elements</h4>
|
||||
<table class="table table-bordered table-condensed dwc-table">
|
||||
<tr>
|
||||
<th>Element</th>
|
||||
|
||||
<th>Description</th>
|
||||
</tr>
|
||||
</thead>
|
||||
|
||||
<tbody>
|
||||
<tr>
|
||||
<td class="">
|
||||
<a href="#coreTag"><core></a>
|
||||
|
|
@ -255,28 +244,20 @@ PhysicalObject,ANSP,PH,124,"Buxbaumia piperi",2,urn:lsid:tim.lsid.tdwg.org:colle
|
|||
the same core record.
|
||||
</td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
|
||||
|
||||
<h3 id="coreTag">2.2 The <core> or <extension> element</h3>
|
||||
|
||||
<h4>Attributes</h4>
|
||||
|
||||
<table class="border">
|
||||
<thead>
|
||||
<table class="table table-bordered table-condensed dwc-table">
|
||||
<tr>
|
||||
<th>Attribute</th>
|
||||
|
||||
<th>Description</th>
|
||||
|
||||
<th>Required</th>
|
||||
|
||||
<th>Default</th>
|
||||
</tr>
|
||||
</thead>
|
||||
|
||||
<tbody>
|
||||
<tr>
|
||||
<td class=""><em>rowType</em></td>
|
||||
|
||||
|
|
@ -286,16 +267,10 @@ PhysicalObject,ANSP,PH,124,"Buxbaumia piperi",2,urn:lsid:tim.lsid.tdwg.org:colle
|
|||
http://rs.tdwg.org/dwc/terms/Occurrence for Occurrence records or
|
||||
http://rs.tdwg.org/dwc/terms/Taxon for Taxon records. Additional
|
||||
classes may be referenced by URI and defined outside the Darwin Core
|
||||
specification. The row type defaults to the ambiguous
|
||||
SimpleDarwinRecord. For convenience the URIs for classes defined by
|
||||
specification. For convenience the URIs for classes defined by
|
||||
the Darwin Core are listed below:
|
||||
|
||||
<dl>
|
||||
<dt>Simple Darwin Record</dt>
|
||||
|
||||
<dd>
|
||||
http://rs.tdwg.org/dwc/xsd/simpledarwincore/SimpleDarwinRecord</dd>
|
||||
|
||||
<dt>Occurrence</dt>
|
||||
|
||||
<dd>http://rs.tdwg.org/dwc/terms/Occurrence</dd>
|
||||
|
|
@ -332,7 +307,7 @@ PhysicalObject,ANSP,PH,124,"Buxbaumia piperi",2,urn:lsid:tim.lsid.tdwg.org:colle
|
|||
|
||||
<td>✓</td>
|
||||
|
||||
<td>http://rs.tdwg.org/dwc/xsd/simpledarwincore/SimpleDarwinRecord</td>
|
||||
<td></td>
|
||||
</tr>
|
||||
|
||||
<tr>
|
||||
|
|
@ -371,8 +346,7 @@ PhysicalObject,ANSP,PH,124,"Buxbaumia piperi",2,urn:lsid:tim.lsid.tdwg.org:colle
|
|||
<td class=""><em>encoding</em></td>
|
||||
|
||||
<td>
|
||||
Specifies the <a href=
|
||||
"http://en.wikipedia.org/wiki/Character_encoding">character
|
||||
Specifies the <a href="http://en.wikipedia.org/wiki/Character_encoding">character
|
||||
encoding</a> for the data file. The encoding is extremely important,
|
||||
but often ignored. The most frequently used encodings are:
|
||||
|
||||
|
|
@ -450,19 +424,15 @@ PhysicalObject,ANSP,PH,124,"Buxbaumia piperi",2,urn:lsid:tim.lsid.tdwg.org:colle
|
|||
|
||||
<td>YYYY-MM-DD</td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>Elements
|
||||
|
||||
<table class="border">
|
||||
<thead>
|
||||
</table>
|
||||
|
||||
<h4>Elements</h4>
|
||||
<table class="table table-bordered table-condensed dwc-table">
|
||||
<tr>
|
||||
<th>Element</th>
|
||||
|
||||
<th>Description</th>
|
||||
</tr>
|
||||
</thead>
|
||||
|
||||
<tbody>
|
||||
<tr>
|
||||
<td class="">
|
||||
<a href="#files"><files></a>
|
||||
|
|
@ -510,7 +480,6 @@ PhysicalObject,ANSP,PH,124,"Buxbaumia piperi",2,urn:lsid:tim.lsid.tdwg.org:colle
|
|||
'column' in the row.
|
||||
</td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
|
||||
|
||||
|
|
@ -523,17 +492,12 @@ PhysicalObject,ANSP,PH,124,"Buxbaumia piperi",2,urn:lsid:tim.lsid.tdwg.org:colle
|
|||
entity.</p>
|
||||
|
||||
<h4>Elements</h4>
|
||||
|
||||
<table class="border">
|
||||
<thead>
|
||||
<table class="table table-bordered table-condensed dwc-table">
|
||||
<tr>
|
||||
<th>Element</th>
|
||||
|
||||
<th>Description</th>
|
||||
</tr>
|
||||
</thead>
|
||||
|
||||
<tbody>
|
||||
<tr>
|
||||
<td class=""><em>location</em></td>
|
||||
|
||||
|
|
@ -542,16 +506,15 @@ PhysicalObject,ANSP,PH,124,"Buxbaumia piperi",2,urn:lsid:tim.lsid.tdwg.org:colle
|
|||
either of the following forms:
|
||||
|
||||
<ul>
|
||||
<li>A filepath relative to the location of the metafile such as
|
||||
"specimen.txt","./specimen.txt", "data/specimen.txt".</li>
|
||||
|
||||
<li>A web accessible URL such as
|
||||
"http://www.gbif.org/data/specimen.csv" or
|
||||
"ftp://ftp.gbif.org/tim/specimen.txt".</li>
|
||||
|
||||
<li>A filepath relative to the location of the metafile such as
|
||||
"specimen.txt","./specimen.txt", "data/specimen.txt".</li>
|
||||
</ul>
|
||||
</td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
|
||||
|
||||
|
|
@ -563,20 +526,14 @@ PhysicalObject,ANSP,PH,124,"Buxbaumia piperi",2,urn:lsid:tim.lsid.tdwg.org:colle
|
|||
|
||||
<h4>Attributes</h4>
|
||||
|
||||
<table class="border">
|
||||
<thead>
|
||||
<table class="table table-bordered table-condensed dwc-table">
|
||||
<tr>
|
||||
<th>Attribute</th>
|
||||
|
||||
<th>Description</th>
|
||||
|
||||
<th>Required</th>
|
||||
|
||||
<th>Default</th>
|
||||
</tr>
|
||||
</thead>
|
||||
|
||||
<tbody>
|
||||
<tr>
|
||||
<td class=""><em>index</em></td>
|
||||
|
||||
|
|
@ -620,14 +577,13 @@ PhysicalObject,ANSP,PH,124,"Buxbaumia piperi",2,urn:lsid:tim.lsid.tdwg.org:colle
|
|||
source values for this field are based on. The URI ideally should
|
||||
resolve to some machine readable definition like SKOS, RDF or at least
|
||||
some simple text or html file often found for ISO or RFC standards. For
|
||||
example http://rs.gbif.org/vocabulary/gbif/nomenclatural_code.xml,
|
||||
example http://rs.gbif.org/vocabulary/gbif/rank.xml,
|
||||
http://www.ietf.org/rfc/rfc3066.txt or
|
||||
http://www.iso.org/iso/list-en1-semic-3.txt .</td>
|
||||
<td>
|
||||
|
||||
<td></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
|
||||
|
||||
|
|
@ -650,7 +606,7 @@ PhysicalObject,ANSP,PH,124,"Buxbaumia piperi",2,urn:lsid:tim.lsid.tdwg.org:colle
|
|||
for those species, and lists of countries and the threat status for those
|
||||
species.</p>
|
||||
|
||||
<img src="images/extension.png">
|
||||
<p><img src="images/extension.png"></p>
|
||||
|
||||
<pre class="example">
|
||||
<?xml version="1.0" encoding="UTF-8"?>
|
||||
|
|
@ -720,14 +676,13 @@ SELECT
|
|||
LINES TERMINATED BY '\n'
|
||||
FROM
|
||||
dwc;
|
||||
</pre><a id="tools" name="tools"></a>
|
||||
</pre>
|
||||
|
||||
<h2 id="tools">5. Tools</h2>
|
||||
<h2 id="resources">5. Resources</h2>
|
||||
|
||||
<p>For tools and applications, including a Java-based application to read
|
||||
Darwin Core text archives, see the <i>Darwin Core Tools and Applications</i>
|
||||
page [<a href=
|
||||
"https://github.com/tdwg/dwc-documentation/blob/master/doc/resources.md">TOOLS</a>].</p>
|
||||
Darwin Core text archives, see the <a href="../../resources/index.html">Darwin Core Resources</a> page.</p>
|
||||
|
||||
|
||||
</div>
|
||||
</div>
|
||||
|
|
|
|||
|
|
@ -0,0 +1,289 @@
|
|||
TITLE: Darwin Core text guide
|
||||
DESCRIPTION: Guidelines for implementing Darwin Core in Text files.
|
||||
LAST_MODIFIED: 2015-01-14
|
||||
|
||||
|
||||
## 1. Introduction
|
||||
|
||||
This document provides guidelines for formatting and sharing Darwin Core terms [[TERMS](../../terms/index.html)] in _fielded text_ formats, such as one or more comma separated value (CSV) files. Data conforming to the Simple Darwin Core [[SIMPLEDWC](../../simple_dwc.html)] (CSV format and having the first row include Darwin Core standard term names) can be shared in a single file, while a non-standard text file can be understood using an [[XML](http://www.w3.org/XML/)] metafile to describe its contents and formatting.
|
||||
|
||||
|
||||
|
||||
More complex structure can be shared in multiple related files. The description of content and relationships between files can be achieved using the metafile. This guideline makes recommendations for the simple case of a _core_ file, upon which Darwin Core _records_ are based, and _extensions_ that are linked to records in that core file. Specifically, extension records have a _many-to-one_ relationship with records in the core file. For example, a core file might contain specimen records, with one specimen per row in the file, while an extension file contains one or more identifications for those specimens, with one identification per row in the extension file, and with an identifier to the specimen for each identification row. This example would allow many identifications to be associated with each specimen.
|
||||
|
||||
### 1.1 Simple example metafile content
|
||||
|
||||
A simple comma separated values (CSV) data file with the following content:
|
||||
|
||||
```
|
||||
ID,Species,Count
|
||||
123,"Cryptantha gypsophila Reveal & C.R. Broome",12
|
||||
124,"Buxbaumia piperi",2
|
||||
```
|
||||
|
||||
can be described with the following Darwin Core metafile:
|
||||
|
||||
```
|
||||
<?xml version="1.0" encoding="UTF-8"?>
|
||||
<archive xmlns="http://rs.tdwg.org/dwc/text/"
|
||||
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
|
||||
xmlns:xs="http://www.w3.org/2001/XMLSchema"
|
||||
xsi:schemaLocation="http://rs.tdwg.org/dwc/text/ http://rs.tdwg.org/dwc/text/tdwg_dwc_text.xsd">
|
||||
<core rowType="http://rs.tdwg.org/dwc/xsd/simpledarwincore/SimpleDarwinRecord" ignoreHeaderLines="1">
|
||||
<files>
|
||||
<location>http://data.gbif.org/download/specimens.csv</location>
|
||||
</files>
|
||||
<field index="0" term="http://rs.tdwg.org/dwc/terms/catalogNumber" />
|
||||
<field index="1" term="http://rs.tdwg.org/dwc/terms/scientificName" />
|
||||
<field index="2" term="http://rs.tdwg.org/dwc/terms/individualCount" />
|
||||
<!-- A constant value has no index, but applies to all rows -->
|
||||
<field term="http://rs.tdwg.org/dwc/terms/datasetID" default="urn:lsid:tim.lsid.tdwg.org:collections:1"/>
|
||||
</core>
|
||||
</archive>
|
||||
```
|
||||
|
||||
These same data could be understood without the metafile if the first row of the CSV file contained the term names:
|
||||
|
||||
```
|
||||
type,institutionCode,collectionCode,catalogNumber,scientificName,individualCount,datasetID
|
||||
PhysicalObject,ANSP,PH,123,"Cryptantha gypsophila Reveal & C.R. Broome",12,urn:lsid:tim.lsid.tdwg.org:collections:1
|
||||
PhysicalObject,ANSP,PH,124,"Buxbaumia piperi",2,urn:lsid:tim.lsid.tdwg.org:collections:1
|
||||
```
|
||||
|
||||
### 1.2 XML versus _fielded text_
|
||||
|
||||
Many resources exist on the web describing the advantages of Extensible Markup Language [[XML](http://www.w3.org/XML/)] over less structured content such as _fielded text_. The Darwin Core Text Guide (this document) is not meant to promote the use of _fielded text_ over XML for data exchange, but rather to provide recommendations for how to handle such data files when necessary.
|
||||
|
||||
Two scenarios that might benefit from the use of _fielded text_ are:
|
||||
|
||||
* The transfer of large numbers of Darwin Core records and related data from one database to another. Typically databases are very efficient at exporting and importing comma separated text files.
|
||||
* The description of legacy data existing in a _fielded text_ format, such that it might be automatically understood and loaded into another system. It could be that this system would then serve the data in another format such as XML.
|
||||
|
||||
## 2. Metafile Content
|
||||
|
||||
The text metafile schema [[TEXTSCHEMA](tdwg_dwc_text.xsd)] provides technical details for the structure of a metafile by defining the elements and attributes required to describe the contents and relationships between text files. These elements and attributes, with descriptions and specifications for their use in a metafile, are described in the following table.
|
||||
|
||||
### 2.1 The `<archive>` element
|
||||
|
||||
The `<archive>` element is the container for the list of related files (one core and zero or more extensions). The `<archive>` element has just one attribute, `metadata`.
|
||||
|
||||
#### `metadata` attribute
|
||||
|
||||
Contains a qualified Uniform Resource Locator (URL) defining the location of a metadata description of the entire archive. The format of the metadata is not prescribed, but a standardized format such as Ecological Metadata Language (EML), Federal Geographic Data Committee (FGDC), or ISO 19115 family is recommended.
|
||||
|
||||
* **Required**: no
|
||||
* **Default**: metadata.xml
|
||||
|
||||
#### `<core>` subelement
|
||||
|
||||
An `<archive>` must contain exactly one `<core>` element, representing the data entity (the actual file and its column header mappings to Darwin Core terms) upon which records are based.
|
||||
|
||||
If extensions are being used, each record in the core data must have a unique identifier. The field for this identifier must be specified in an explicit `<id>` field in order to associate extension records with the core record.
|
||||
|
||||
#### `<extension>` subelement
|
||||
|
||||
An `<archive>` may define zero or more `<extension>` elements, each representing an individual extension entity directly related to the core. In addition to the general file attributes described below, every extension entity must have an explicit `<coreId>` field to relate the extension record to a row in the core entity. The extension itself does not have to have a unique ID field and many rows can point to the same core record.
|
||||
|
||||
### 2.2 The `<core>` or `<extension>` element
|
||||
|
||||
#### `rowType` attribute
|
||||
|
||||
A Unified Resource Identifier (URI) for the term identifying the class of data represented by each row, for example, http://rs.tdwg.org/dwc/terms/Occurrence for Occurrence records or http://rs.tdwg.org/dwc/terms/Taxon for Taxon records. Additional classes may be referenced by URI and defined outside the Darwin Core specification. The row type is required. For convenience the URIs for classes defined by the Darwin Core are listed below:
|
||||
|
||||
<dl class="dl-horizontal">
|
||||
<dt>Occurrence</dt><dd>http://rs.tdwg.org/dwc/terms/Occurrence</dd>
|
||||
<dt>Event</dt><dd>http://rs.tdwg.org/dwc/terms/Event</dd>
|
||||
<dt>Location</dt><dd>http://purl.org/dc/terms/Location</dd>
|
||||
<dt>GeologicalContext</dt><dd>http://purl.org/dc/terms/GeologicalContext</dd>
|
||||
<dt>Identification</dt><dd>http://rs.tdwg.org/dwc/terms/Identification</dd>
|
||||
<dt>Taxon</dt><dd>http://rs.tdwg.org/dwc/terms/Taxon</dd>
|
||||
<dt>ResourceRelationship</dt><dd>http://rs.tdwg.org/dwc/terms/ResourceRelationship</dd>
|
||||
<dt>MeasurementOrFact</dt><dd>http://rs.tdwg.org/dwc/terms/MeasurementOrFact</dd>
|
||||
</dl>
|
||||
|
||||
* **Required**: yes
|
||||
|
||||
#### `fieldsTerminatedBy` attribute
|
||||
|
||||
Specifies the delimiter between fields. Typical values might be `,` or `\t` for CSV or Tab files respectively.
|
||||
|
||||
* **Required**: no
|
||||
* **Default**: `,`
|
||||
|
||||
#### `linesTerminatedBy` attribute
|
||||
|
||||
Specifies the row separator character.
|
||||
|
||||
* **Required**: no
|
||||
* **Default**: `\n`
|
||||
|
||||
#### `fieldsEnclosedBy` attribute
|
||||
|
||||
Specifies the character used to enclose (mark the start and end of) each field. CSV files frequently use the double quote character (`"`), but the default is no enclosing character. Note that a comma separated value file that has commas within the content of any field must have an enclosing character.</td>
|
||||
|
||||
* **Required**: no
|
||||
* **Default**: `"`
|
||||
|
||||
#### `encoding` attribute
|
||||
|
||||
Specifies the [character encoding](http://en.wikipedia.org/wiki/Character_encoding) for the data file. The encoding is extremely important, but often ignored. The most frequently used encodings are:
|
||||
|
||||
<dl class="dl-horizontal">
|
||||
<dt>UTF-8</dt><dd>8-bit Unicode Transformation Format.</dd>
|
||||
<dt>UTF-16</dt><dd>16-bit Unicode Transformation Format.</dd>
|
||||
<dt>ISO-8859-1</dt><dd>Commonly known as Latin-1 and a common default on systems configured for a single western European language.</dd>
|
||||
<dt>Windows-1252</dt><dd>Commonly known as WinLatin and a common default of legacy versions of Microsoft Windows based operating systems.</dd>
|
||||
</dl>
|
||||
|
||||
* **Required**: no
|
||||
* **Default**: `UTF-8`
|
||||
|
||||
#### `ignoreHeaderLines` attribute
|
||||
|
||||
Specifies the number lines to ignore from the beginning of the file. This can be used to ignore files with column headings or preamble comments for example.
|
||||
|
||||
* **Required**: no
|
||||
* **Default**: `0`
|
||||
|
||||
#### `dateFormat` attribute
|
||||
|
||||
When verbatim dates are consistent in format, this field can be used to indicate the format represented. It is recommended to use the date, dateTime and time for field formats wherever possible, but where verbatim dates are required, a format may be specified here. This should be considered a 'hint' for consumers. It is recommended that consumers support the minimum combinations of `DD` `MM` and `YYYY` with the separators `/` and `-`. Examples:
|
||||
|
||||
<dl class="dl-horizontal">
|
||||
<dt>DDMMYYYY</dt><dd>For dates of the form 21121978</dd>
|
||||
<dt>DD-MM-YYYY</dt><dd>For dates of the form 21-12-1978</dd>
|
||||
<dt>MMDDYYYY</dt><dd>For dates of the form 12211978</dd>
|
||||
<dt>MM-DD-YYYY</dt><dd>For dates of the form 12-21-1978</dd>
|
||||
<dt>YYYYMMDD</dt><dd>For dates of the form 19781221</dd>
|
||||
</dl>
|
||||
|
||||
#### `<files>` subelement
|
||||
|
||||
`<core>` or `<extension>` element must contain one `<files>` element to locate the data being described.
|
||||
|
||||
#### `<id>` subelement
|
||||
|
||||
If extensions are being used, the `<core>` must contain an <id> element that indicates the identifier for a record.
|
||||
|
||||
#### `<coreId>` subelement
|
||||
|
||||
If extensions are being used, the `<extension>` element must contain a `<coreId>` element that indicates the column in the extension file that contains the core record identifier (the matching `<id>` in the core file).
|
||||
|
||||
#### `<field>` subelement
|
||||
|
||||
A `<core>` or `<extension>` element must contain one or more <field> elements, each representing a 'column' in the row.
|
||||
|
||||
### 2.3 `<files>` element
|
||||
|
||||
The files element must contain one or more <location> elements, each defining where a file resides. Each core or extension entity can be composed from one or more files. If an entity has data in more than one file, use the `<location>` element multiple times, once for each file that makes up the entity.
|
||||
|
||||
#### `<location>` subelement
|
||||
|
||||
Specifies the location of the file being described, which may take either of the following forms:
|
||||
|
||||
* A web accessible URL such as `http://www.gbif.org/data/specimen.csv` or `ftp://ftp.gbif.org/tim/specimen.txt`.
|
||||
* A filepath relative to the location of the metafile such as `specimen.txt`, `./specimen.txt`, `data/specimen.txt`.
|
||||
|
||||
### 2.4 The `<field>` element
|
||||
|
||||
The field element is used to specify the location and content of data within a file. There must be one field element for every term being shared for the entity, whether explicitly or through the use of a default value for all rows in the file.
|
||||
|
||||
#### `index` attribute
|
||||
|
||||
Specifies the position of the column in the row. The first column has an index of 0, the second column 1, etc. If no column index is specified, then the term and the default may be used to define a constant value for all rows.
|
||||
|
||||
* **Required**: no
|
||||
* **Default**:
|
||||
|
||||
#### `term` attribute
|
||||
|
||||
A Unified Resource Identifier (URI) for the term represented by this field. For example, a field containing the scientific name would have term="http://rs.tdwg.org/dwc/terms/scientificName". Terms outside of the Darwin Core specification may be used, such as those from the Dublin Core Metadata Initative, for example, dcterms:modified would be term="http://purl.org/dc/terms/modified".
|
||||
|
||||
* **Required**: yes
|
||||
|
||||
#### `default` attribute
|
||||
|
||||
Specifies value to use if one is not supplied for the field in a given row. If no index is supplied, the default can be used to define a constant for all rows for a field that is not in the data file.
|
||||
|
||||
* **Required**: no
|
||||
* **Default**:
|
||||
|
||||
#### `vocabulary` attribute
|
||||
|
||||
A Unified Resource Identifier (URI) for a vocabulary that the source values for this field are based on. The URI ideally should resolve to some machine readable definition like SKOS, RDF or at least some simple text or html file often found for ISO or RFC standards. For example http://rs.gbif.org/vocabulary/gbif/nomenclatural_code.xml, http://www.ietf.org/rfc/rfc3066.txt or http://www.iso.org/iso/list-en1-semic-3.txt.
|
||||
|
||||
* **Required**: no
|
||||
* **Default**:
|
||||
|
||||
## 3. Implementation Guide
|
||||
|
||||
### 3.1 Extension example
|
||||
|
||||
The following example illustrates the use of extensions. In this example there are three files in the archive, all of which are located in the same directory as the metafile. The whales.txt file acts as a core file of Taxon records. The whales.txt file is extended by two other files, types.txt and distribution.txt. The types.txt file contains records of a type specified in an external definition at http://http://rs.gbif.org/terms/1.0/Types and consists of Dublin Core and Darwin Core terms, while the distribution.txt file contains records of a type specified at http://http://rs.gbif.org/terms/1.0/Distribution and consists of Darwin Core terms plus an additional term for threatStatus. Both extension files are related to the core file by the taxonNameID fields. Presumably, this archive contains information about whale species, type specimen records for those species, and lists of countries and the threat status for those species.
|
||||
|
||||
|
||||
|
||||
```XML
|
||||
<?xml version="1.0" encoding="UTF-8"?>
|
||||
<archive xmlns="http://rs.tdwg.org/dwc/text/"
|
||||
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
|
||||
xmlns:xs="http://www.w3.org/2001/XMLSchema"
|
||||
xsi:schemaLocation="http://rs.tdwg.org/dwc/text/ http://rs.tdwg.org/dwc/text/tdwg_dwc_text.xsd">
|
||||
|
||||
<core encoding="UTF-8" fieldsTerminatedBy="\t" linesTerminatedBy="\n" ignoreHeaderLines="1" rowType="http://rs.tdwg.org/dwc/terms/Taxon">
|
||||
<files>
|
||||
<location>whales.txt</location>
|
||||
</files>
|
||||
<id index="0" />
|
||||
<field index="0" term="http://rs.tdwg.org/dwc/terms/taxonID" />
|
||||
<field index="1" term="http://purl.org/dc/terms/modified" />
|
||||
<field index="2" term="http://rs.tdwg.org/dwc/terms/scientificName"/>
|
||||
<field index="3" term="http://rs.tdwg.org/dwc/terms/acceptedNameUsageID"/>
|
||||
<field index="4" term="http://rs.tdwg.org/dwc/terms/parentNameUsageID"/>
|
||||
<field index="5" term="http://rs.tdwg.org/dwc/terms/originalNameUsageID"/>
|
||||
</core>
|
||||
|
||||
<extension encoding="UTF-8" fieldsTerminatedBy="," linesTerminatedBy="\n" fieldsEnclosedBy='"' ignoreHeaderLines="1" rowType="http://rs.gbif.org/terms/1.0/Types">
|
||||
<files>
|
||||
<location>types.csv</location>
|
||||
</files>
|
||||
<coreId index="0" />
|
||||
<field index="1" term="http://purl.org/dc/terms/bibliographicCitation"/>
|
||||
<field index="2" term="http://rs.tdwg.org/dwc/terms/catalogNumber"/>
|
||||
<field index="3" term="http://rs.tdwg.org/dwc/terms/collectionCode"/>
|
||||
<field index="4" term="http://rs.tdwg.org/dwc/terms/institutionCode"/>
|
||||
<field index="5" term="http://rs.tdwg.org/dwc/terms/typeStatus"/>
|
||||
</extension>
|
||||
|
||||
<extension encoding="UTF-8" fieldsTerminatedBy="," linesTerminatedBy="\n" fieldsEnclosedBy='"' ignoreHeaderLines="1" rowType="http://rs.gbif.org/terms/1.0/Distribution">
|
||||
<files>
|
||||
<location>distribution.csv</location>
|
||||
</files>
|
||||
<coreId index="0" />
|
||||
<field index="1" term="http://rs.tdwg.org/dwc/terms/countryCode"/>
|
||||
<field index="2" term="http://rs.gbif.org/terms/1.0/threatStatus"/>
|
||||
<field index="3" term="http://rs.tdwg.org/dwc/terms/occurrenceStatus"/>
|
||||
</extension>
|
||||
</archive>
|
||||
```
|
||||
|
||||
## 4. Database Example
|
||||
|
||||
### 4.1 MySQL
|
||||
|
||||
It is very easy to produce _fielded text_ using the `SELECT INTO` outfile command from MySQL. The encoding of the resulting file will depend on the server variables and collations used, and might need to be modified before the operation is done. Note that MySQL will export `NULL` values as \N by default. Use the `IFNULL()` function as shown in the following example to avoid this.
|
||||
|
||||
```SQL
|
||||
SELECT
|
||||
IFNULL(id, ''), IFNULL(scientific_name, ''), IFNULL(count,'')
|
||||
INTO outfile '/tmp/dwc.txt'
|
||||
FIELDS TERMINATED BY ','
|
||||
OPTIONALLY ENCLOSED BY '"'
|
||||
LINES TERMINATED BY '\n'
|
||||
FROM
|
||||
dwc;
|
||||
```
|
||||
|
||||
## 5. Tools
|
||||
|
||||
For tools and applications, including a Java-based application to read Darwin Core text archives, see the [resources page](../../resources/index.html).
|
||||
|
|
@ -1,298 +1,82 @@
|
|||
<!DOCTYPE html>
|
||||
|
||||
<html lang="en">
|
||||
<head>
|
||||
<meta content="text/html; charset=utf-8" http-equiv="Content-Type">
|
||||
|
||||
<title>Darwin Core XML Guide</title>
|
||||
<link href="http://rs.tdwg.org/dwc/" rel="schema.DwC">
|
||||
<meta content="Darwin Core XML Guide" name="DC.title">
|
||||
<meta content="Guide for implementing Darwin Core in XML." name=
|
||||
"DC.description">
|
||||
<meta content="biodiversity, standards" name="DC.subject">
|
||||
<meta content="Darwin Core Task Group" name="DC.creator">
|
||||
<meta content="John Wieczorek (MVZ)" name="DC.contributor">
|
||||
<meta content="Markus Döring (GBIF)" name="DC.contributor">
|
||||
<meta content="Renato De Giovanni (CRIA)" name="DC.contributor">
|
||||
<meta content="Tim Robertson (GBIF)" name="DC.contributor">
|
||||
<meta content="Dave Vieglais (KUNHM)" name="DC.contributor">
|
||||
<meta content="2009-02-12" name="DC.dateAccepted">
|
||||
<meta content="http://rs.tdwg.org/dwc/2010-05-23/terms/guides/xml/" name=
|
||||
"DC.replaces">
|
||||
<meta content="2014-11-08" name="DC.modified">
|
||||
<meta content="http://rs.tdwg.org/dwc/2014-11-08/terms/guides/xml" name=
|
||||
"DC.identifier">
|
||||
<meta content="text/html" name="DC.format">
|
||||
<meta content="Biodiversity Information Standards TDWG" name="DC.publisher">
|
||||
<meta content="http://creativecommons.org/licenses/by/4.0/legalcode" name=
|
||||
"DC.license">
|
||||
<meta content="public" name="DC.accessRights">
|
||||
<meta content="Darwin Core XML Guide. 2014" name="DC.bibliographicCitation">
|
||||
<meta content="en" name="DC.language">
|
||||
<link href="http://www.tdwg.org/" rel="meta">
|
||||
<link href="../../../DarwinCore_files/default.css" rel="stylesheet" type=
|
||||
"text/css">
|
||||
<script src="../../../DarwinCore_files/default.js" type="text/javascript"></script>
|
||||
<meta charset="utf-8">
|
||||
<title>Darwin Core XML Guide</title>
|
||||
<link href="http://rs.tdwg.org/dwc/" rel="schema.DwC">
|
||||
<meta content="Darwin Core XML Guide" name="DC.title">
|
||||
<meta content="Guidelines for implementing Darwin Core as XML." name="DC.description">
|
||||
<meta name="DC.modified" content="2015-01-13"><!-- Also update in footer -->
|
||||
|
||||
<meta name="dcterms.subject" content="biodiversity, standards">
|
||||
<meta name="dcterms.creator" content="Darwin Core Task Group">
|
||||
<meta name="dcterms.contributor" content="John Wieczorek (MVZ)">
|
||||
<meta name="dcterms.contributor" content="Markus Döring (GBIF)">
|
||||
<meta name="dcterms.contributor" content="Renato De Giovanni (CRIA)">
|
||||
<meta name="dcterms.contributor" content="Tim Robertson (GBIF)">
|
||||
<meta name="dcterms.contributor" content="Dave Vieglais (KUNHM)">
|
||||
<meta name="dcterms.contributor" content="Peter Desmet (INBO)">
|
||||
<meta name="dcterms.publisher" content="Biodiversity Information Standards (TDWG)">
|
||||
<meta name="dcterms.license" content="http://creativecommons.org/licenses/by/4.0/legalcode">
|
||||
<meta name="dcterms.language" content="en">
|
||||
<meta name="viewport" content="width=device-width, initial-scale=1">
|
||||
<link rel="stylesheet" type="text/css" href="../../assets/bootstrap.min.css">
|
||||
<link rel="stylesheet" type="text/css" href="../../assets/main.css">
|
||||
<link href="http://www.tdwg.org/" rel="meta">
|
||||
</head>
|
||||
|
||||
<body>
|
||||
<table border="0" cellpadding="0" cellspacing="0" style=
|
||||
"background-color: #617394" width="100%">
|
||||
<tbody>
|
||||
<tr>
|
||||
<td>
|
||||
<a href="http://www.tdwg.org"><img alt=
|
||||
"Biodiversity Information Standards (TDWG) logo" height="89" src=
|
||||
"../../../DarwinCore_files/TDWGlogo_Twiki.gif" width="148"></a>
|
||||
</td>
|
||||
|
||||
<td align="right" height="100" valign="top" width="100%"></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
|
||||
<table border="0" cellpadding="0" cellspacing="0" width="100%">
|
||||
<tbody>
|
||||
<tr>
|
||||
<td style="background-color: #617394" width="15%">
|
||||
<div id="menu">
|
||||
<div class="topMenu" id="nav">
|
||||
<div class="menuItem level1">
|
||||
<a href="../../../index.htm" onfocus=
|
||||
"blurLink(this);">Introduction</a>
|
||||
</div>
|
||||
|
||||
<div class="subMenu">
|
||||
<div class="menuItem">
|
||||
<a href="../../../index.htm#references" onfocus=
|
||||
"blurLink(this);">References</a>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<div class="menuItem level1">
|
||||
<a href="../../index.htm" onfocus="blurLink(this);">Quick
|
||||
Reference Guide</a>
|
||||
</div>
|
||||
|
||||
<div class="menuItem level1">
|
||||
<a href="../../simple/index.htm" onfocus=
|
||||
"blurLink(this);">Simple Darwin Core</a>
|
||||
</div>
|
||||
|
||||
<div class="separator">
|
||||
<hr>
|
||||
</div>
|
||||
|
||||
<div class="menuItem level1">
|
||||
<a href="../../namespace/index.htm" onfocus=
|
||||
"blurLink(this);">Namespace Policy</a>
|
||||
</div>
|
||||
|
||||
<div class="menuItem level1">
|
||||
<a href="../text/index.htm" onfocus="blurLink(this);">Text
|
||||
Guide</a>
|
||||
</div>
|
||||
|
||||
<div class="menuItem level1 highlighted">
|
||||
<a href="../xml/index.htm" onfocus="blurLink(this);">XML
|
||||
Guide</a>
|
||||
</div>
|
||||
|
||||
<div class="subMenu">
|
||||
<div class="menuItem">
|
||||
<a href="./index.htm#introduction" onfocus=
|
||||
"blurLink(this);">Introduction</a>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<div class="subMenu">
|
||||
<div class="menuItem">
|
||||
<a href="./index.htm#implement" onfocus=
|
||||
"blurLink(this);">Implementation Guide</a>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<div class="subSubMenu">
|
||||
<div class="menuItem">
|
||||
<a href="#xmlschema" onfocus="blurLink(this);">XML Schema</a>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<div class="subSubMenu">
|
||||
<div class="menuItem">
|
||||
<a href="#xmlnamespaces" onfocus="blurLink(this);">XML
|
||||
Namespaces</a>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<div class="subSubMenu">
|
||||
<div class="menuItem">
|
||||
<a href="#abstractmodel" onfocus="blurLink(this);">Abstract
|
||||
Model</a>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<div class="subSubMenu">
|
||||
<div class="menuItem">
|
||||
<a href="#propsandvalues" onfocus=
|
||||
"blurLink(this);">Properties & Values</a>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<div class="subSubMenu">
|
||||
<div class="menuItem">
|
||||
<a href="#nullvalues" onfocus="blurLink(this);">Null
|
||||
Values</a>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<div class="subSubMenu">
|
||||
<div class="menuItem">
|
||||
<a href="#simpledarwincore" onfocus="blurLink(this);">Simple
|
||||
Darwin Core</a>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<div class="subSubMenu">
|
||||
<div class="menuItem">
|
||||
<a href="#classes" onfocus="blurLink(this);">Classes &
|
||||
Containment</a>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<div class="separator">
|
||||
<hr>
|
||||
</div>
|
||||
|
||||
<div class="menuItem level1">
|
||||
<a href="../../history/index.htm" onfocus=
|
||||
"blurLink(this);">Complete History</a>
|
||||
</div>
|
||||
|
||||
<div class="menuItem level1">
|
||||
<a href="../../history/decisions/index.htm" onfocus=
|
||||
"blurLink(this);">Decision History</a>
|
||||
</div>
|
||||
|
||||
<div class="menuItem level1">
|
||||
<a href="../../history/dwctoabcd/index.htm" onfocus=
|
||||
"blurLink(this);">Mapping to ABCD</a>
|
||||
</div>
|
||||
|
||||
<div class="menuItem level1">
|
||||
<a href="../../history/versions/index.htm" onfocus=
|
||||
"blurLink(this);">Mapping to Old Versions</a>
|
||||
</div>
|
||||
<nav class="navbar navbar-default navbar-fixed-top">
|
||||
<div class="container">
|
||||
<div class="navbar-header">
|
||||
<button type="button" class="navbar-toggle collapsed" data-toggle="collapse" data-target=".navbar-collapse">
|
||||
<span class="sr-only">Toggle navigation</span>
|
||||
<span class="icon-bar"></span><span class="icon-bar"></span><span class="icon-bar"></span>
|
||||
</button>
|
||||
<a class="navbar-brand" href="../index.html">Darwin Core</a>
|
||||
</div>
|
||||
</div>
|
||||
</td>
|
||||
<div class="collapse navbar-collapse">
|
||||
<ul class="nav navbar-nav">
|
||||
<li><a href="../../terms/index.html">Terms</a></li>
|
||||
<li><a href="../../examples/index.html">Examples</a></li>
|
||||
<li class="dropdown">
|
||||
<a href="#" class="dropdown-toggle" data-toggle="dropdown" role="button" aria-expanded="false">Reference <span class="caret"></span></a>
|
||||
<ul class="dropdown-menu" role="menu">
|
||||
<li><a href="../../change_policy.html">Change policy</a></li>
|
||||
<li class="divider"></li>
|
||||
<li><a href="../../simple_dwc.html">Simple Darwin Core</a></li>
|
||||
<li class="divider"></li>
|
||||
<li><a href="../text/index.html">Text guide</a></li>
|
||||
<li class="active"><a href="../xml/index.html">XML guide</a></li>
|
||||
<li class="disabled"><a href="../rdf/index.html">RDF guide</a></li>
|
||||
<li class="divider"></li>
|
||||
<li><a href="../../terms/history.html">Term history</a></li>
|
||||
<li><a href="../../terms/decisions.html">Term decisions</a></li>
|
||||
<li><a href="../../terms/mappings.html">Term mappings</a></li>
|
||||
</ul>
|
||||
</li>
|
||||
</ul>
|
||||
<ul class="nav navbar-nav navbar-right">
|
||||
<li><a href="../../resources/index.html">Resources</a></li>
|
||||
<li><a href="http://github.com/tdwg/dwc">Source</a></li>
|
||||
</ul>
|
||||
</div>
|
||||
</div>
|
||||
</nav>
|
||||
|
||||
<div class="content">
|
||||
<div class="container">
|
||||
<div class="page-header">
|
||||
<h1>Darwin Core XML Guide</h1>
|
||||
</div>
|
||||
|
||||
<td>
|
||||
<center><h1>Darwin Core XML Guide</h1><center>
|
||||
|
||||
<p></p>
|
||||
|
||||
<table cellspacing="0" class="docinfo">
|
||||
<tbody>
|
||||
<tr>
|
||||
<th>Title:</th>
|
||||
|
||||
<td>Darwin Core XML Guide</td>
|
||||
</tr>
|
||||
|
||||
<tr>
|
||||
<th>Date Issued:</th>
|
||||
|
||||
<td>2009-02-12</td>
|
||||
</tr>
|
||||
|
||||
<tr>
|
||||
<th>Date Modified:</th>
|
||||
|
||||
<td>2014-11-08</td>
|
||||
</tr>
|
||||
|
||||
<tr>
|
||||
<th>Abstract:</th>
|
||||
|
||||
<td>Guidelines for the implementation of Darwin Core in
|
||||
XML.</td>
|
||||
</tr>
|
||||
|
||||
<tr>
|
||||
<th>Contributors:</th>
|
||||
|
||||
<td>John Wieczorek (MVZ), Markus Döring (GBIF), Renato De
|
||||
Giovanni (CRIA), Tim Robertson (GBIF), Dave Vieglais
|
||||
(KUNHM)</td>
|
||||
</tr>
|
||||
|
||||
<tr>
|
||||
<th>Legal:</th>
|
||||
|
||||
<td>This document is governed by the standard legal, copyright,
|
||||
licensing provisions and disclaimers issued by the Taxonomic
|
||||
Databases Working Group.</td>
|
||||
</tr>
|
||||
|
||||
<tr>
|
||||
<th>Part of TDWG Standard:</th>
|
||||
|
||||
<td>
|
||||
<a href=
|
||||
"http://www.tdwg.org/standards/450/">http://www.tdwg.org/standards/450/</a>
|
||||
</td>
|
||||
</tr>
|
||||
|
||||
<tr>
|
||||
<th>Creator:</th>
|
||||
|
||||
<td>Darwin Core Task Group</td>
|
||||
</tr>
|
||||
|
||||
<tr>
|
||||
<th>Identifier:</th>
|
||||
|
||||
<td>http://rs.tdwg.org/dwc/2014-11-08/terms/guides/xml/</td>
|
||||
</tr>
|
||||
|
||||
<tr>
|
||||
<th>Latest Version:</th>
|
||||
|
||||
<td>
|
||||
<a href=
|
||||
"http://rs.tdwg.org/dwc/terms/guides/xml/index.htm">http://rs.tdwg.org/dwc/terms/guides/xml/</a>
|
||||
</td>
|
||||
</tr>
|
||||
|
||||
<tr>
|
||||
<th>Replaces:</th>
|
||||
|
||||
<td>
|
||||
<a href=
|
||||
"http://rs.tdwg.org/dwc/2010-05-23/terms/guides/xml/index.htm">
|
||||
http://rs.tdwg.org/dwc/2010-05-23/terms/guides/xml/</a>
|
||||
</td>
|
||||
</tr>
|
||||
|
||||
<tr>
|
||||
<th>Document Status:</th>
|
||||
|
||||
<td>Current Standard</td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table><br>
|
||||
<br>
|
||||
</td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table><a id="introduction" name="introduction"></a>
|
||||
|
||||
<h2>1. Introduction</h2><b>Audience</b>: This document is targeted toward
|
||||
<h2 id="introduction">1. Introduction</h2>
|
||||
<p>
|
||||
<b>Audience</b>: This document is targeted toward
|
||||
those who wish to use or construct application schemas using Darwin Core
|
||||
terms in XML. It includes explanations of existing schemas such as the Simple
|
||||
Darwin Core [<a href="../../simple/index.htm">SIMPLEDWC</a>] and how to build
|
||||
new schemas to meet specific models of information.
|
||||
new schemas to meet specific models of information.</p>
|
||||
|
||||
<p>This document provides guidelines for implementing application schemas
|
||||
based on Darwin Core terms [<a href="../../index.htm">TERMS</a>] using
|
||||
|
|
@ -304,31 +88,28 @@
|
|||
<p>This document does not provide guidelines for encoding Darwin Core in
|
||||
RDF/XML. Nor does it take a position on the relative merits of encoding
|
||||
metadata in 'plain' XML rather than RDF/XML. This document provides
|
||||
guidelines in those cases where RDF/XML is not considered appropriate. <a id=
|
||||
"implement" name="implement"></a></p>
|
||||
guidelines in those cases where RDF/XML is not considered appropriate.</p>
|
||||
|
||||
<h2>2. Implementation Guide</h2>
|
||||
<h2 id="implement">2. Implementation Guide</h2>
|
||||
|
||||
<p><a id="xmlschema" name="xmlschema"></a></p>
|
||||
|
||||
<h3>2.1 XML Schema</h3>Implementors should base their XML applications on
|
||||
<h3 id="xmlschema">2.1 XML Schema</h3>
|
||||
<p>Implementors should base their XML applications on
|
||||
<i>XML Schemas</i> [<a href="http://www.w3.org/XML/Schema">XMLSCHEMA</a>]
|
||||
rather than <i>XML DTDs</i>. Approaches based on <i>XML Schemas</i> are more
|
||||
flexible and are more easily re-used within other XML applications.
|
||||
flexible and are more easily re-used within other XML applications.</p>
|
||||
|
||||
<p><a id="xmlnamespaces" name="xmlnamespaces"></a></p>
|
||||
|
||||
<h3>2.2 XML Namespaces</h3>Implementors should use <i>XML Namespaces</i>
|
||||
<h3 id="xmlnamespaces">2.2 XML Namespaces</h3>
|
||||
<p>Implementors should use <i>XML Namespaces</i>
|
||||
[<a href="http://www.w3.org/TR/1999/REC-xml-names-19990114/">XMLNS</a>] to
|
||||
uniquely identify elements. Darwin Core namespaces are defined in the
|
||||
<i>Darwin Core Namespace Policy</i> [<a href=
|
||||
"../../namespace/index.htm">NAMESPACEPOLICY</a>], while Dublin Core
|
||||
namespaces are defined in the <i>DCMI Namespace Recommendation</i> [<a href=
|
||||
"http://dublincore.org/documents/dcmi-namespace/">DCMINS</a>].
|
||||
"http://dublincore.org/documents/dcmi-namespace/">DCMINS</a>].</p>
|
||||
|
||||
<p><a id="abstractmodel" name="abstractmodel"></a></p>
|
||||
|
||||
<h3>2.3 Abstract model</h3>
|
||||
<h3 id="abstractmodel">2.3 Abstract model</h3>
|
||||
|
||||
<p>The Darwin Core follows the <i>Dublin Core Metadata Initiative Abstract
|
||||
Model</i> [<a href=
|
||||
|
|
@ -353,18 +134,12 @@
|
|||
record</em> describe that record.</li>
|
||||
|
||||
<li>A <em>Darwin Core record</em> must include all required
|
||||
<em>properties</em>, if any, and their associated <em>values</em>.</li>
|
||||
<!--
|
||||
<LI>Each literal string <EM>value</EM> may have an associated language (e.g., en-GB).</LI>
|
||||
<LI>Each <EM>value</EM> may have an associated <EM>encoding scheme</EM>.</LI>
|
||||
<LI>Each <EM>encoding scheme</EM> has a <EM>name</EM>.</LI></UL>
|
||||
-->
|
||||
<em>properties</em>, if any, and their associated <em>values</em>.</li>
|
||||
</ul>
|
||||
|
||||
<p><a id="propsandvalues" name="propsandvalues"></a></p>
|
||||
|
||||
<h3>2.4 Properties and Values</h3>
|
||||
|
||||
<h3 id="propsandvalues">2.4 Properties and Values</h3>
|
||||
|
||||
<p>The Darwin Core follows the guidelines for expressing Dublin Core metadata
|
||||
using XML [<a href=
|
||||
"http://dublincore.org/documents/dc-xml/">DCMIXMLGUIDE</a>] except in that
|
||||
|
|
@ -375,6 +150,7 @@
|
|||
value given in the <em>Term name</em> attribute in the Darwin Core Terms
|
||||
recommendation [<a href="../../index.htm">TERMS</a>] with the appropriate
|
||||
namespace name. For example, use</p>
|
||||
|
||||
<pre class="example">
|
||||
<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema"
|
||||
targetNamespace="http://rs.tdwg.org/dwc/terms/"
|
||||
|
|
@ -384,58 +160,29 @@
|
|||
</pre>
|
||||
|
||||
<p>rather than</p>
|
||||
|
||||
<pre class="example">
|
||||
<dwc:basisOfRecord value="HumanObservation" />
|
||||
</pre>
|
||||
|
||||
<p><!--
|
||||
<H3>2.5 Encoding Schemes</H3>
|
||||
If an encoding scheme is recommended in the <EM>Description</EM> attribute of the term, use that encoding scheme or
|
||||
a refinement of it to constrain the values of the term.
|
||||
<P>
|
||||
Implementors should encode <EM>encoding schemes</EM> using the 'xsi:type' attribute of the XML element for the property.
|
||||
The name of the encoding scheme should be given as the attribute value, and should be in the form of an XML qualified name
|
||||
(QName), which associates the scheme name with the appropriate namespace name. For example:
|
||||
<PRE class="example">
|
||||
<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema"
|
||||
targetNamespace="http://rs.tdwg.org/dwc/terms/"
|
||||
xmlns:dc="http://purl.org/dc/terms/"
|
||||
xmlns:dwc="http://rs.tdwg.org/dwc/terms/">
|
||||
<dwc:countryCode xsi:type="dc:ISO3166">COL</dwc:countryCode>
|
||||
</PRE>
|
||||
or
|
||||
<PRE class="example">
|
||||
<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema"
|
||||
targetNamespace="http://rs.tdwg.org/dwc/terms/"
|
||||
xmlns:dwc="http://rs.tdwg.org/dwc/terms/">
|
||||
<dwc:basisOfRecord xsi:type="dwc:DwCType">PreservedSpecimen</dwc:basisOfRecord>
|
||||
</PRE>
|
||||
|
||||
This allows implementors to take some advantage of the data typing functionality provided by the W3C XML Schema specifications
|
||||
[<A href="http://www.w3.org/XML/Schema">XMLSCHEMA</A>].
|
||||
-->
|
||||
<a id="nullvalues" name="nullvalues"></a></p>
|
||||
|
||||
<h3>2.5 Null values</h3>
|
||||
<h3 id="nullvalues">2.5 Null values</h3>
|
||||
|
||||
<p>Elements for which the value is null should be omitted from the document
|
||||
or explicitly coded using the attribute <i>xsi:nil="true"</i>.</p>
|
||||
|
||||
<pre class="example">
|
||||
<dwc:locality xsi:nil="true"/>
|
||||
</pre>Do not use an empty string - an element with no content:
|
||||
</pre>
|
||||
|
||||
<p>Do not use an empty string - an element with no content:</p>
|
||||
|
||||
<pre class="example">
|
||||
<dwc:locality></dwc:locality>
|
||||
</pre><!--
|
||||
<H3>2.7 Language</H3>
|
||||
<P>
|
||||
It is permissible to indicate the language of the <EM>value</EM> using the 'xml:lang' attribute. For example:
|
||||
<PRE class="example"><dwc:country xml:lang="es">España</dwc:country>
|
||||
<dwc:sex xml:lang="en">female</dwc:sex>
|
||||
</PRE>
|
||||
-->
|
||||
<a id="simpledarwincore" name="simpledarwincore"></a>
|
||||
</pre>
|
||||
|
||||
<h3>2.6 Simple Darwin Core</h3>
|
||||
|
||||
<h3 id="simpledarwincore">2.6 Simple Darwin Core</h3>
|
||||
|
||||
<p>The <i>Simple Darwin Core</i> [<a href=
|
||||
"../../../xsd/tdwg_dwc_simple.xsd">SIMPLEXMLSCHEMA</a>] most closely models
|
||||
|
|
@ -469,6 +216,7 @@ It is permissible to indicate the language of the <EM>value</EM> using the '
|
|||
link shows a blank page in your browser, use the View Source option to see
|
||||
the XML document) shows detail for a single record having a more complete set
|
||||
of elements.</p>
|
||||
|
||||
<pre class="example">
|
||||
<?xml version="1.0"?>
|
||||
<dwr:SimpleDarwinRecordSet
|
||||
|
|
@ -494,9 +242,8 @@ It is permissible to indicate the language of the <EM>value</EM> using the '
|
|||
</dwr:SimpleDarwinRecordSet>
|
||||
</pre>
|
||||
|
||||
<p><a id="classes" name="classes"></a></p>
|
||||
|
||||
<h3>2.7 Classes and Containment</h3>
|
||||
<h3 id="classes">2.7 Classes and Containment</h3>
|
||||
|
||||
<p>Many Darwin Core terms (<i>properties</i>) are defined as being associated
|
||||
with another term (a <i>class</i>). For example, <a href=
|
||||
|
|
@ -542,6 +289,7 @@ It is permissible to indicate the language of the <EM>value</EM> using the '
|
|||
of which has had a second identification) at one location following this
|
||||
class-based schema. Note that you can reuse the location definition here by
|
||||
referring to it via locationID:</p>
|
||||
|
||||
<pre class="example">
|
||||
<?xml version="1.0"?>
|
||||
<dwr:DarwinRecordSet
|
||||
|
|
@ -633,10 +381,13 @@ It is permissible to indicate the language of the <EM>value</EM> using the '
|
|||
<dwc:relationshipOfResource>mother of</dwc:relationshipOfResource>
|
||||
</dwc:ResourceRelationship>
|
||||
</dwr:DarwinRecordSet>
|
||||
</pre>Here is different example demonstrating area count observations for
|
||||
</pre>
|
||||
|
||||
<p>Here is different example demonstrating area count observations for
|
||||
events on two different days at one location. Note that we omit the
|
||||
identification class here as there is not identification related data and link
|
||||
via the taxonID directly:
|
||||
via the taxonID directly:</p>
|
||||
|
||||
<pre class="example">
|
||||
<?xml version="1.0"?>
|
||||
<dwr:DarwinRecordSet
|
||||
|
|
@ -728,24 +479,37 @@ via the taxonID directly:
|
|||
</dwc:Occurrence>
|
||||
</dwr:DarwinRecordSet>
|
||||
</pre>
|
||||
<hr>
|
||||
<!-- Footer -->
|
||||
|
||||
<p>Except where otherwise noted, content on this site is licensed under a
|
||||
<a href="http://creativecommons.org/licenses/by/4.0/" rel="license">Creative
|
||||
Commons Attribution 4.0 International License</a>.</p>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<p><a href="http://creativecommons.org/licenses/by/4.0/" rel=
|
||||
"license"><img alt="Creative Commons License" id="creative_commons_icon" src=
|
||||
"http://i.creativecommons.org/l/by/4.0/88x31.png"></a> Copyright 2011-2014 -
|
||||
Biodiversity Information Standards - TDWG - <a href=
|
||||
"http://www.tdwg.org/about-tdwg/contact-us/">Contact Us</a><br>
|
||||
<!-- The following is used to register Google Analytics for Darwin Core -->
|
||||
<script src="http://www.google-analytics.com/urchin.js" type=
|
||||
"text/javascript"></script> <script type="text/javascript">
|
||||
|
||||
_uacct = "UA-386033-4";
|
||||
urchinTracker();
|
||||
</script></p>
|
||||
</body>
|
||||
</html>
|
||||
<footer class="footer">
|
||||
<div class="container">
|
||||
<div class="row">
|
||||
<div class="col-xs-4">
|
||||
<p><a rel="license" href="http://creativecommons.org/licenses/by/4.0/"><img alt="Creative Commons License" style="border-width:0" src="https://i.creativecommons.org/l/by/4.0/88x31.png"/></a></p>
|
||||
</div>
|
||||
<div class="col-xs-8">
|
||||
<ul class="list-inline pull-right">
|
||||
<li>Page last modified on 2015-01-13</li>
|
||||
<li><a href="https://github.com/tdwg/dwc/blob/gh-pages/resources.html">Edit on GitHub</a></li>
|
||||
</ul>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</footer>
|
||||
|
||||
<!-- Scripts -->
|
||||
<script type="text/javascript" src="../../assets/jquery.min.js"></script>
|
||||
<script type="text/javascript" src="../../assets/bootstrap.min.js"></script>
|
||||
<script>
|
||||
(function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
|
||||
(i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
|
||||
m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)
|
||||
})(window,document,'script','//www.google-analytics.com/analytics.js','ga');
|
||||
|
||||
ga('create', 'UA-386033-4', 'auto');
|
||||
ga('send', 'pageview');
|
||||
</script>
|
||||
</body>
|
||||
</html>
|
||||
|
|
|
|||
14
index.html
14
index.html
|
|
@ -72,25 +72,25 @@
|
|||
|
||||
<div class="content">
|
||||
<div class="container">
|
||||
<h2>Introduction</h2>
|
||||
<h2>1. Introduction</h2>
|
||||
<p>The Darwin Core is body of standards. It includes a glossary of terms (in other contexts these might be called properties, elements, fields, columns, attributes, or concepts) intended to facilitate the sharing of information about biological diversity by providing reference definitions, examples, and commentaries. The Darwin Core is primarily based on taxa, their occurrence in nature as documented by observations, specimens, samples, and related information. Included are documents describing how these terms are managed, how the set of terms can be extended for new purposes, and how the terms can be used. The normative document for the terms [<a href="terms/dwc_normative.rdf">RDF-NORMATIVE</a>] is written in the Resource Description Framework (RDF) and is the definitive resource to understand the term definitions and their relationships to each other. The <em>Simple Darwin Core</em> [<a href="simple_dwc.html">SIMPLEDWC</a>] is a specification for one particular way to use the terms - to share data about taxa and their occurrences in a simply structured way - and is probably what is meant if someone suggests to "format your data according to the Darwin Core".</p>
|
||||
|
||||
<h2>Motivation</h2>
|
||||
<h2>2. Motivation</h2>
|
||||
<p>The Darwin Core standard was originally conceived to facilitate the discovery, retrieval, and integration of information about modern biological specimens, their spatiotemporal occurrence, and their supporting evidence housed in collections (physical or digital). The Darwin Core today is broader in scope and more versatile. It is meant to provide a stable standard reference for sharing information on biological diversity. As a glossary of terms, the Darwin Core is meant to provide stable semantic definitions with the goal of being maximally reusable in a variety of contexts.</p>
|
||||
|
||||
<h2>Rationale</h2>
|
||||
<h2>3. Rationale</h2>
|
||||
<p>The Darwin Core is based on the standards developed by the <em>Dublin Core Metadata Initiative</em> [<a href="http://dublincore.org/">DCMI</a>] and can be viewed as an extension of the Dublin Core for biodiversity information. The purpose of these terms is to facilitate data sharing by providing a well-defined standard core vocabulary in a flexible framework to minimize the barriers to adoption and to maximize reusability. The terms described in this standard are a part of a larger set of vocabularies and technical specifications under development [<a href="http://wiki.tdwg.org/twiki/bin/view/">TDWG-DEV</a>] and maintained by <em>Biodiversity Information Standards (TDWG)</em> [<a href="http://www.tdwg.org/standards/">TDWG-STANDARDS</a>].</p>
|
||||
|
||||
<h2>Guiding principles</h2>
|
||||
<h2>4. Guiding principles</h2>
|
||||
<p>Each term has a definition and commentaries that are meant to promote the consistent use of the terms across applications and disciplines. Evolving commentaries that discuss, refine, expand, or translate the definitions and examples are referred to through links in the <em>Comments</em> attribute of each term. This means of documentation allows the standard to adapt to new purposes without disrupting existing applications. There is meant to be a clear separation between the terms defined in this standard and the applications that make use of them. For example, though the data types and constraints are not provided in the term definitions, recommendations are made about how to restrict the values where appropriate.</p>
|
||||
|
||||
<h2>Content</h2>
|
||||
<h2>5. Content</h2>
|
||||
<p>The standard consists of a vocabulary of terms (properties, elements, fields, concepts) [<a href="terms/index.html">TERMS</a>], the policy governing the maintenance of these terms [<a href="change_policy.html">NAMESPACEPOLICY</a>], the decisions that resulted in changes to terms [<a href="terms/decisions.html">DECISIONS</a>], the complete history of terms including detailed attributes [<a href="terms/history.html">HISTORY</a>], a <em>Generic Darwin Core XML schema</em> [<a href="guides/xml/tdwg_dwcterms.xsd">TERMSXMLSCHEMA</a>] from which other schemas can be constructed, a <em>Simple Darwin Core XML schema</em> [<a href="guides/xml/tdwg_dwc_simple.xsd">SIMPLEXMLSCHEMA</a>] as a complete schema ready for use, a schema to allow Darwin Core data transfer in text files [<a href="guides/text/tdwg_dwc_text.xsd">TEXTSCHEMA</a>], and associated reference schemas for the construction of more structured content. These pages also describe mappings between the current standard and pre-standard historical versions <a href="terms/old_versions.html">[VERSIONS]</a>, including mappings <a href="terms/mapping_abcd.html">[DWCTOABCD]</a> to concepts in the <em>Access to Biological Collections Data</em> standard <a href="http://www.tdwg.org/schemas/abcd/2.06">[ABCD]</a>.</p>
|
||||
|
||||
<h2>Extension</h2>
|
||||
<h2>6. Extension</h2>
|
||||
<p>Though the Darwin Core is insufficient for the needs of all biological disciplines, it can be adapted to serve new purposes. Darwin Core can be extended by adding new terms to share additional information. To do so you should be familiar with the recommendations and procedures defined in the <em>Darwin Core Namespace Policy</em> [<a href="change_policy.html">NAMESPACEPOLICY</a>]. Basically, before proposing a new term, consider the existing terms in this and other compatible standards to determine if the new concept can be accommodated by a simple revision of the description and comments for an existing term, without losing the existing meaning of that term.</p>
|
||||
|
||||
<h2>Participation</h2>
|
||||
<h2>7. Participation</h2>
|
||||
<p>To receive notification of activity or participate in discussions about Darwin Core, join the <em>tdwg-content</em> mailing list [<a href="http://lists.tdwg.org/mailman/listinfo/tdwg-content">TDWG-CONTENT</a>] and watch the <em>Darwin Core Project</em> [<a href= "https://github.com/tdwg/dwc">DWC-PROJECT</a>]. For discussion or commentary on the definition of recommended terms, consult the link inside the <em>Comment</em> section in the listing for the term in the <em>Quick Reference Guide</em> [<a href="terms/index.html">TERMS</a>] or search for the relevant content in the auxiliary <em>Darwin Core Documentation</em> [<a href= "http://terms.tdwg.org/wiki/Darwin_Core">DWC-WIKI</a>].</p>
|
||||
<p>To make a formal request for a change to or addition of a term to the Darwin Core, read and follow the recommendations in the <em>Darwin Core Namespace Policy</em> [<a href="change_policy.html">NAMESPACEPOLICY</a>]. For those who wish to construct and submit as a standard any application profile, such as an XML schema, that extends the capabilities of the Darwin Core, adding new terms to the Darwin Core vocabulary that don't already exist in a compatible vocabulary will be a prerequisite. Consult the appropriate guideline, such as the <em>XML Guide</em> [<a href="terms/guides/xml">XMLGUIDE</a>], for information about the construction of a new application profile. The rules of submission of proposed standards can be found in the <em>Biodiversity Information Standards (TDWG)</em> process document [<a href="http://www.tdwg.org/about-tdwg/process/">PROCESS</a>].</p>
|
||||
</div>
|
||||
|
|
|
|||
|
|
@ -4,9 +4,9 @@
|
|||
<meta charset="utf-8">
|
||||
|
||||
<title>Darwin Core resources</title>
|
||||
<meta name="DC.title" content="Darwin Core resources">
|
||||
<meta name="DC.description" content="Darwin Core tools and other resources.">
|
||||
<meta name="DC.modified" content="2015-01-13"><!-- Also update in footer -->
|
||||
<meta name="dcterms.title" content="Darwin Core resources">
|
||||
<meta name="dcterms.description" content="Darwin Core tools and other resources.">
|
||||
<meta name="dcterms.modified" content="2015-01-13"><!-- Also update in footer -->
|
||||
|
||||
<meta name="dcterms.subject" content="biodiversity, standards">
|
||||
<meta name="dcterms.creator" content="Darwin Core Task Group">
|
||||
|
|
@ -71,7 +71,7 @@
|
|||
|
||||
<p>This entire repository can be downloaded from <a href="https://github.com/tdwg/dwc/archive/gh-pages.zip">Github</a>.
|
||||
|
||||
<h2>Downloads</h2>
|
||||
<h2>1. Downloads & Templates</h2>
|
||||
<ul>
|
||||
<li><a href="../terms/dwc_normative.rdf">Normative Darwin Core (RDF)</a></li>
|
||||
<li><a href="dwc_terms.csv">List of all Darwin Core terms with definitions (CSV)</a></li>
|
||||
|
|
@ -83,25 +83,25 @@
|
|||
<li><a href="http://www.gbif.org/resources/2552">Darwin Core Archive How-to Guide (PDF)</a></li>
|
||||
</ul>
|
||||
|
||||
<h2>Vocabularies</h2>
|
||||
<h2>2. Vocabularies</h2>
|
||||
<ul>
|
||||
<li><a href="http://terms.tdwg.org/wiki/Darwin_Core">GBIF Darwin Core Media Wiki</a></li>
|
||||
<li><a href="https://code.google.com/p/applecore/">Apple Core: Darwin Core for Botany</a></li>
|
||||
</ul>
|
||||
|
||||
<h2>Tools</h2>
|
||||
<h2>3. Tools</h2>
|
||||
<ul>
|
||||
<li><a href="http://www.gbif.org/ipt">Integrated Publishing Toolkit (GBIF)</a></li>
|
||||
<li><a href="https://github.com/gbif/dwca-reader/">Darwin Core Archive Reader (java, GBIF)</a></li>
|
||||
<li><a href="https://github.com/BelgianBiodiversityPlatform/python-dwca-reader">Darwin Core Archive Reader (python, Belgian Biodiversity Platform)</a></li>
|
||||
<li><a href="http://tools.gbif.org/dwca-assistant">Darwin Core Archive Assistant (GBIF)</a></li>
|
||||
<li><a href="http://tools.gbif.org/dwca-validator/">Darwin Core Archive Validator (GBIF)</a></li>
|
||||
<li><a href="https://github.com/gbif/dwca-validator">Darwin Core Archive Validator code (java, GBIF)</a></li>
|
||||
<li><a href="http://terms.tdwg.org/wiki/Darwin_Core">Darwin Core enumeration and term Factory (java)</a></li>
|
||||
<li><a href="http://tools.gbif.org/dwca-validator/">Darwin Core Archive Validator (GBIF)</a> - <a href="https://github.com/gbif/dwca-validator">java source code</a></li>
|
||||
<li><a href="https://github.com/gbif/dwc-api">Darwin Core term enumeration (java)</a></li>
|
||||
<li><a href="https://github.com/Canadensys/dwca2sql">Darwin Core to SQL (java, Canadensys)</a></li>
|
||||
<li><a href="https://github.com/ropensci/finch">finch, read Darwin Core archives in R</a></li>
|
||||
</ul>
|
||||
|
||||
<h2>References</h2>
|
||||
<h2>4. References</h2>
|
||||
<ul>
|
||||
</ul>
|
||||
</div>
|
||||
|
|
|
|||
File diff suppressed because one or more lines are too long
|
|
@ -4,9 +4,9 @@
|
|||
<meta charset="utf-8">
|
||||
|
||||
<title>Darwin Core term decisions</title>
|
||||
<meta name="DC.title" content="Darwin Core term decisions">
|
||||
<meta name="DC.description" content="A history of decisions about Darwin Core terms.">
|
||||
<meta name="DC.modified" content="2015-01-13"><!-- Also update in footer -->
|
||||
<meta name="dcterms.title" content="Darwin Core term decisions">
|
||||
<meta name="dcterms.description" content="A history of decisions about Darwin Core terms.">
|
||||
<meta name="dcterms.modified" content="2015-01-13"><!-- Also update in footer -->
|
||||
|
||||
<meta name="dcterms.subject" content="biodiversity, standards">
|
||||
<meta name="dcterms.creator" content="Darwin Core Task Group">
|
||||
|
|
@ -69,19 +69,19 @@
|
|||
<h1>Term decisions</h1>
|
||||
</div>
|
||||
|
||||
<h2>Introduction</h2>
|
||||
<h2>1. Introduction</h2>
|
||||
<p>From time to time changes are proposed to Darwin Core terms through the process described in the Term Change Policy section of the <em>Darwin Core Namespace Policy</em> [<a href= "../change_policy.html">NAMESPACEPOLICY</a>]. This document shows the outcome of decisions based on officially proposed changes.</p>
|
||||
|
||||
<h2>Decisions</h2>
|
||||
<h2>2. Decisions</h2>
|
||||
|
||||
<a id="Decision-2009-12-07_1" class="anchor"></a>
|
||||
<table class="table table-bordered table-condensed dwc-table">
|
||||
<colgroup><col /><col /></colgroup>
|
||||
<tbody>
|
||||
<tr><td colspan="2">Decision-2009-12-07_1</td></tr>
|
||||
<tr><td>Identifier</td><td>http://rs.tdwg.org/dwc/terms/decisions.html#Decision-2009-12-07_1</td></tr>
|
||||
<tr><td>Description</td><td>The recommended controlled vocabulary for dcterms:type was changed from a vocabulary of Darwin Core Classes (Occurrence, Taxon, Location, Event) to the DCMI type vocabulary (PhysicalObject, Event, StillImage, MovingImage, Sound, Text, Dataset) to be consistent with the standard use of that term.</td></tr>
|
||||
<tr><td>Date</td><td>2009-12-07</td></tr>
|
||||
<tr><td>Identifier</td><td>http://rs.tdwg.org/dwc/terms/decisions.html#Decision-2009-12-07_1</td></tr>
|
||||
<tr><td>Description</td><td>The recommended controlled vocabulary for dcterms:type was changed from a vocabulary of Darwin Core Classes (Occurrence, Taxon, Location, Event) to the DCMI type vocabulary (PhysicalObject, Event, StillImage, MovingImage, Sound, Text, Dataset) to be consistent with the standard use of that term.</td></tr>
|
||||
<tr><td>Date</td><td>2009-12-07</td></tr>
|
||||
</tbody>
|
||||
</table>
|
||||
|
||||
|
|
|
|||
|
|
@ -1,196 +1,163 @@
|
|||
<html>
|
||||
<!DOCTYPE html>
|
||||
<html lang="en">
|
||||
<head>
|
||||
<meta charset="utf-8">
|
||||
|
||||
<title>Darwin Core term history</title>
|
||||
<meta name="dcterms.title" content="Darwin Core term history">
|
||||
<meta name="dcterms.description" content=""><!-- Populate -->
|
||||
<meta name="dcterms.modified" content="2015-01-13"><!-- Also update in footer -->
|
||||
|
||||
<meta name="dcterms.subject" content="biodiversity, standards">
|
||||
<meta name="dcterms.creator" content="Darwin Core Task Group">
|
||||
<meta name="dcterms.contributor" content="John Wieczorek (MVZ)">
|
||||
<meta name="dcterms.contributor" content="Markus Döring (GBIF)">
|
||||
<meta name="dcterms.contributor" content="Renato De Giovanni (CRIA)">
|
||||
<meta name="dcterms.contributor" content="Tim Robertson (GBIF)">
|
||||
<meta name="dcterms.contributor" content="Dave Vieglais (KUNHM)">
|
||||
<meta name="dcterms.contributor" content="Peter Desmet (INBO)">
|
||||
<meta name="dcterms.publisher" content="Biodiversity Information Standards (TDWG)">
|
||||
<meta name="dcterms.license" content="http://creativecommons.org/licenses/by/4.0/legalcode">
|
||||
<meta name="dcterms.language" content="en">
|
||||
<meta name="viewport" content="width=device-width, initial-scale=1">
|
||||
<link rel="stylesheet" type="text/css" href="../assets/bootstrap.min.css">
|
||||
<link rel="stylesheet" type="text/css" href="../assets/main.css">
|
||||
</head>
|
||||
|
||||
<body>
|
||||
<h2>1. Introduction</h2>
|
||||
This page contains detailed historical information about the Darwin Core terms and standard. You may want to consider consulting one of the following pages if you have other specific interests:
|
||||
<a href="../index.html">Darwin Core Terms</a> - current term definitions
|
||||
<a href="../dwc_normative.rdf">Normative Darwin Core</a> - authoritative specification of the standard in RDF
|
||||
<a href="./old_versions.html">Darwin Core Versions</a> - pre-standard versions of Darwin Core
|
||||
<a href="./mapping_abcd.html">Mapping to ABCD</a> - relationship of terms to <a href=
|
||||
"http://www.tdwg.org/schemas/abcd/2.06">ABCD 2.06</a>
|
||||
|
||||
<a id="dwchistory" name="dwchistory"></a>
|
||||
<h2>2. History of Darwin Core</h2>
|
||||
Darwin Core was developed as a standard under the <a href="http://www.tdwg.org/activities/darwincore/">Darwin Core Task Group</a> following the <a href="http://www.tdwg.org/about-tdwg/process/">standards process</a> of <a href="http://www.tdwg.org/">Biodiversity Information Standards (TDWG)</a>.
|
||||
|
||||
Following is the timeline for the Darwin Core ratification process:
|
||||
* 14 Feb 2009 - The standard was submitted to the TDWG Executive Committee.
|
||||
* 17 Feb 2009 - Gail Kampmeier accepted role as Review Manager.
|
||||
* 11 Apr 2009 - Peer Review submitted to Darwin Core Task Group.
|
||||
* 01 May 2009 - Revisions made and comments submitted to Review Manager.
|
||||
* 13 May 2009 - Additional recommendations provided by the Review Manager.
|
||||
* 24 May 2009 - Revisions made and new version committed to standards track.
|
||||
* 29 May 2009 - Revisions accepted and draft standard forwarded for review by the TDWG Executive Committee.
|
||||
* 29 Jun 2009 - Executive Review submitted to Darwin Core Task Group with recommendation to accept for Public Review with revisions.
|
||||
* 08 Jul 2009 - Revisions made and new version committed to standards track.
|
||||
* 11 Jul 2009 - Proposed standard announced for public review.
|
||||
* 10 Aug 2009 - Earliest possible date for the close of public review.
|
||||
* 23 Sep 2009 - Public Review closed, response version published.
|
||||
* 08 Oct 2009 - Standard ratified by TDWG Executive Committee.
|
||||
<body>
|
||||
<nav class="navbar navbar-default navbar-fixed-top">
|
||||
<div class="container">
|
||||
<div class="navbar-header">
|
||||
<button type="button" class="navbar-toggle collapsed" data-toggle="collapse" data-target=".navbar-collapse">
|
||||
<span class="sr-only">Toggle navigation</span>
|
||||
<span class="icon-bar"></span><span class="icon-bar"></span><span class="icon-bar"></span>
|
||||
</button>
|
||||
<a class="navbar-brand" href="../index.html">Darwin Core</a>
|
||||
</div>
|
||||
<div class="collapse navbar-collapse">
|
||||
<ul class="nav navbar-nav">
|
||||
<li><a href="../terms/index.html">Terms</a></li>
|
||||
<li><a href="../examples/index.html">Examples</a></li>
|
||||
<li class="dropdown">
|
||||
<a href="#" class="dropdown-toggle" data-toggle="dropdown" role="button" aria-expanded="false">Reference <span class="caret"></span></a>
|
||||
<ul class="dropdown-menu" role="menu">
|
||||
<li><a href="../change_policy.html">Change policy</a></li>
|
||||
<li class="divider"></li>
|
||||
<li><a href="../simple_dwc.html">Simple Darwin Core</a></li>
|
||||
<li class="divider"></li>
|
||||
<li><a href="../guides/text/index.html">Text guide</a></li>
|
||||
<li><a href="../guides/xml/index.html">XML guide</a></li>
|
||||
<li class="disabled"><a href="../guides/rdf/index.html">RDF guide</a></li>
|
||||
<li class="divider"></li>
|
||||
<li class="active"><a href="../terms/history.html">Term history</a></li>
|
||||
<li><a href="../terms/decisions.html">Term decisions</a></li>
|
||||
<li><a href="../terms/mappings.html">Term mappings</a></li>
|
||||
</ul>
|
||||
</li>
|
||||
</ul>
|
||||
<ul class="nav navbar-nav navbar-right">
|
||||
<li><a href="../resources/index.html">Resources</a></li>
|
||||
<li><a href="http://github.com/tdwg/dwc">Source</a></li>
|
||||
</ul>
|
||||
</div>
|
||||
</div>
|
||||
</nav>
|
||||
|
||||
Public review was conducted and archived on the <a href="http://lists.tdwg.org/pipermail/tdwg-content/">tdwg-content mailing list</a> (tdwg-content@lists.tdwg.org) from 11 July through 23 Sep 2009.
|
||||
<div class="content">
|
||||
<div class="container">
|
||||
<div class="page-header">
|
||||
<h1>Term history</h1>
|
||||
</div>
|
||||
|
||||
### Changes from previous versions
|
||||
<h2>1. Introduction</h2>
|
||||
This page contains detailed historical information about the Darwin Core terms and standard. You may want to consider consulting one of the following pages if you have other specific interests:
|
||||
<a href="../index.html">Darwin Core Terms</a> - current term definitions
|
||||
<a href="../dwc_normative.rdf">Normative Darwin Core</a> - authoritative specification of the standard in RDF
|
||||
<a href="./old_versions.html">Darwin Core Versions</a> - pre-standard versions of Darwin Core
|
||||
<a href="./mapping_abcd.html">Mapping to ABCD</a> - relationship of terms to <a href=
|
||||
"http://www.tdwg.org/schemas/abcd/2.06">ABCD 2.06</a>
|
||||
|
||||
The Standard Darwin Core differs from previous versions in several important ways.
|
||||
<h2>2. History of Darwin Core</h2>
|
||||
Darwin Core was developed as a standard under the <a href="http://www.tdwg.org/activities/darwincore/">Darwin Core Task Group</a> following the <a href="http://www.tdwg.org/about-tdwg/process/">standards process</a> of <a href="http://www.tdwg.org/">Biodiversity Information Standards (TDWG)</a>.
|
||||
|
||||
* The primary purpose of the standard is more open to biological data of all kinds than previous versions, whose scope was limited to biological occurrence and biased toward specimen data.
|
||||
* The foundation of the standard is a list of reusable concepts (called terms) rather than just a set of XML schemas. The list is maintained in its canonical form in rdf (http://rs.tdwg.org/dwc/rdf/dwcterms.rdf). The remainder of the standard consists of documentation about the terms, their maintenance, their use in applications, and the mechanisms for extending the Darwin Core, as well as a number of functional and example application profiles.
|
||||
* The list of terms consists of those derived from previous versions of the Darwin Core XML schemas (including OBIS and the Curatorial, Geospatial, and Paleontology extensions), as well as terms recommended for use by the Observations, Animal Movement, Crop Wild Relatives, Genetic Resources, and Sensitive Data groups. In the making of this list and the crafting of the term definitions, care was taken to address concerns arising in discussion groups, mailing lists, and wiki commentary since the inception of the first proposed Darwin Core XML schema.
|
||||
Following is the timeline for the Darwin Core ratification process:
|
||||
* 14 Feb 2009 - The standard was submitted to the TDWG Executive Committee.
|
||||
* 17 Feb 2009 - Gail Kampmeier accepted role as Review Manager.
|
||||
* 11 Apr 2009 - Peer Review submitted to Darwin Core Task Group.
|
||||
* 01 May 2009 - Revisions made and comments submitted to Review Manager.
|
||||
* 13 May 2009 - Additional recommendations provided by the Review Manager.
|
||||
* 24 May 2009 - Revisions made and new version committed to standards track.
|
||||
* 29 May 2009 - Revisions accepted and draft standard forwarded for review by the TDWG Executive Committee.
|
||||
* 29 Jun 2009 - Executive Review submitted to Darwin Core Task Group with recommendation to accept for Public Review with revisions.
|
||||
* 08 Jul 2009 - Revisions made and new version committed to standards track.
|
||||
* 11 Jul 2009 - Proposed standard announced for public review.
|
||||
* 10 Aug 2009 - Earliest possible date for the close of public review.
|
||||
* 23 Sep 2009 - Public Review closed, response version published.
|
||||
* 08 Oct 2009 - Standard ratified by TDWG Executive Committee.
|
||||
|
||||
<a id="termhistory" name="termhistory"></a>
|
||||
<h2>3. Term History</h2>
|
||||
<p>This document serves as a complete alphabetically ordered reference for all terms associated with the Darwin Core, including historical pre-standard versions (Classic, MaNIS, OBIS, Draft Standard 1.4, Curatorial extension, Geospatial extension, Paleontology extension).</p>
|
||||
Public review was conducted and archived on the <a href="http://lists.tdwg.org/pipermail/tdwg-content/">tdwg-content mailing list</a> (tdwg-content@lists.tdwg.org) from 11 July through 23 Sep 2009.
|
||||
|
||||
<p>Following is the complete list of term attributes and their
|
||||
definitions:</p>
|
||||
### Changes from previous versions
|
||||
|
||||
<table align="center" border="0" width="95%">
|
||||
<tbody>
|
||||
<tr>
|
||||
<td width="20%"><b>Term Name</b>:</td>
|
||||
The Standard Darwin Core differs from previous versions in several important ways.
|
||||
|
||||
<td width="80%">The name by which the latest version of the term is
|
||||
commonly known.</td>
|
||||
</tr>
|
||||
* The primary purpose of the standard is more open to biological data of all kinds than previous versions, whose scope was limited to biological occurrence and biased toward specimen data.
|
||||
* The foundation of the standard is a list of reusable concepts (called terms) rather than just a set of XML schemas. The list is maintained in its canonical form in rdf (http://rs.tdwg.org/dwc/rdf/dwcterms.rdf). The remainder of the standard consists of documentation about the terms, their maintenance, their use in applications, and the mechanisms for extending the Darwin Core, as well as a number of functional and example application profiles.
|
||||
* The list of terms consists of those derived from previous versions of the Darwin Core XML schemas (including OBIS and the Curatorial, Geospatial, and Paleontology extensions), as well as terms recommended for use by the Observations, Animal Movement, Crop Wild Relatives, Genetic Resources, and Sensitive Data groups. In the making of this list and the crafting of the term definitions, care was taken to address concerns arising in discussion groups, mailing lists, and wiki commentary since the inception of the first proposed Darwin Core XML schema.
|
||||
|
||||
<tr>
|
||||
<td width="20%"><b>Identifier</b>:</td>
|
||||
<h2>3. Term History</h2>
|
||||
<p>This document serves as a complete alphabetically ordered reference for all terms associated with the Darwin Core, including historical pre-standard versions (Classic, MaNIS, OBIS, Draft Standard 1.4, Curatorial extension, Geospatial extension, Paleontology extension).</p>
|
||||
<p>Following is the complete list of term attributes and their definitions:</p>
|
||||
|
||||
<td width="80%">The unique identifier for the latest version of the
|
||||
term.</td>
|
||||
</tr>
|
||||
<dl class="dl-horizontal">
|
||||
<dt>Term Name</dt><dd>The name by which the latest version of the term is commonly known.</dd>
|
||||
<dt>Identifier</dt><dd>The unique identifier for the latest version of the term.</dd>
|
||||
<dt>Namespace</dt><dd>The namespace (Darwin Core, Dublin Core) within which the term is defined. The combination of the namespace and the version make a unique identifier for the term.</dd>
|
||||
<dt>Label</dt><dd>The commonly used label for the term.</dd>
|
||||
<dt>Definition</dt><dd>A description of the nature of the content of the term.</dd>
|
||||
<dt>Comment</dt><dd>Further commentary about the usage of the term, with examples and a reference to further information.</dd>
|
||||
<dt>Type of Term</dt><dd>The category (property, class, vocabulary encoding scheme, or datatype - syntax encoding scheme) to which the term belongs.</dd>
|
||||
<dt>Refines</dt><dd>The name of a term of which this term is a refined (more specialized) version.</dd>
|
||||
<dt>Status</dt><dd>The status of the term - deprecated (not recommended for use), superseded (not recommended for use - replaced by the term or terms shown in the Is Replaced By column), or recommended (ready for use).</dd>
|
||||
<dt>Date Issued</dt><dd>Date on which the term was first published.</dd>
|
||||
<dt>Date Modified</dt><dd>Date on which the term was last changed in any way that would change its meaning or use.</dd>
|
||||
<dt>Member Of</dt><dd>The Class of which this term is a member.</dd>
|
||||
<dt>Has Domain</dt><dd>A Class of which a resource described by the term is a property.</dd>
|
||||
<dt>Has Range</dt><dd>A Class of which a value described by the term is an instance.</dd>
|
||||
<dt>Decision</dt><dd>The reference to the published decision that resulted in the current version of the term.</dd>
|
||||
<dt>Version</dt><dd>The identifier for the specific version of the term.</dd>
|
||||
<dt>Replaces</dt><dd>The identifier of the previous version of the term.</dd>
|
||||
<dt>Is Replaced By</dt><dd>The identifier of the next newer version of the term.</dd>
|
||||
<dt>Class</dt><dd>The primary category of terms (Class) that this term describes.</dd>
|
||||
<dt>ABCD 2.</dd>06</dt><dd>The xpath(s) to the equivalent concept(s) in the Access to Biological Collections Data schema version 2.06.</dd>
|
||||
</dl>
|
||||
|
||||
<tr>
|
||||
<td width="20%"><b>Namespace</b>:</td>
|
||||
<a id="acceptedNameUsage-2009-09-21" class="anchor"></a>
|
||||
<table class="table table-bordered table-condensed dwc-table term-definition">
|
||||
<colgroup><col /><col /></colgroup>
|
||||
<tbody>
|
||||
<tr><td colspan="2">acceptedNameUsage</td></tr>
|
||||
<tr><td>Identifier</td><td><a href="http://rs.tdwg.org/dwc/terms/acceptedNameUsage">http://rs.tdwg.org/dwc/terms/acceptedNameUsage</a></td></tr>
|
||||
<tr><td>Namespace</td><td>http://rs.tdwg.org/dwc/terms/</td></tr>
|
||||
<tr><td>Label</td><td>Accepted Name Usage</td></tr>
|
||||
<tr><td>Definition</td><td>The full name, with authorship and date information if known, of the currently valid (zoological) or accepted (botanical) taxon.</td></tr>
|
||||
<tr><td>Comment</td><td>Example: "Tamias minimus" valid name for "Eutamias minimus".</td></tr>
|
||||
<tr><td>Reference</td><td><a href="http://terms.tdwg.org/wiki/dwc:acceptedNameUsage">http://terms.tdwg.org/wiki/dwc:acceptedNameUsage</a></td></tr>
|
||||
<tr><td>Type of term</td><td>http://www.w3.org/1999/02/22-rdf-syntax-ns#Property</td></tr>
|
||||
<tr><td>Refines</td><td></td></tr>
|
||||
<tr><td>Status</td><td>recommended</td></tr>
|
||||
<tr><td>Date issued</td><td>2008-11-19</td></tr>
|
||||
<tr><td>Date modified</td><td>2009-09-21</td></tr>
|
||||
<tr><td>Has domain</td><td></td></tr>
|
||||
<tr><td>Has range</td><td></td></tr>
|
||||
<tr><td>Version</td><td>acceptedNameUsage-2009-09-21</td></tr>
|
||||
<tr><td>Replaces</td><td><a href="#acceptedScientificName-2009-07-06">acceptedScientificName-2009-07-06</a></td></tr>
|
||||
<tr><td>Is replaced by</td><td></td></tr>
|
||||
<tr><td>Class</td><td>http://rs.tdwg.org/dwc/terms/Taxon</td></tr>
|
||||
<tr><td>ABCD 2.06</td><td>not in ABCD</td></tr>
|
||||
</tbody>
|
||||
</table>
|
||||
|
||||
<td width="80%">The namespace (Darwin Core, Dublin Core) within which
|
||||
the term is defined. The combination of the namespace and the version
|
||||
make a unique identifier for the term.</td>
|
||||
</tr>
|
||||
|
||||
<tr>
|
||||
<td width="20%"><b>Label</b>:</td>
|
||||
|
||||
<td width="80%">The commonly used label for the term.</td>
|
||||
</tr>
|
||||
|
||||
<tr>
|
||||
<td width="20%"><b>Definition</b>:</td>
|
||||
|
||||
<td width="80%">A description of the nature of the content of the
|
||||
term.</td>
|
||||
</tr>
|
||||
|
||||
<tr>
|
||||
<td width="20%"><b>Comment</b>:</td>
|
||||
|
||||
<td width="80%">Further commentary about the usage of the term, with
|
||||
examples and a reference to further information.</td>
|
||||
</tr>
|
||||
|
||||
<tr>
|
||||
<td width="20%"><b>Type of Term</b>:</td>
|
||||
|
||||
<td width="80%">The category (property, class, vocabulary encoding
|
||||
scheme, or datatype - syntax encoding scheme) to which the term
|
||||
belongs.</td>
|
||||
</tr>
|
||||
|
||||
<tr>
|
||||
<td width="20%"><b>Refines</b>:</td>
|
||||
|
||||
<td width="80%">The name of a term of which this term is a refined
|
||||
(more specialized) version.</td>
|
||||
</tr>
|
||||
|
||||
<tr>
|
||||
<td width="20%"><b>Status</b>:</td>
|
||||
|
||||
<td width="80%">The status of the term - deprecated (not recommended
|
||||
for use), superseded (not recommended for use - replaced by the term
|
||||
or terms shown in the <i>Is Replaced By</i> column), or recommended
|
||||
(ready for use).</td>
|
||||
</tr>
|
||||
|
||||
<tr>
|
||||
<td width="20%"><b>Date Issued</b>:</td>
|
||||
|
||||
<td width="80%">Date on which the term was first published.</td>
|
||||
</tr>
|
||||
|
||||
<tr>
|
||||
<td width="20%"><b>Date Modified</b>:</td>
|
||||
|
||||
<td width="80%">Date on which the term was last changed in any way
|
||||
that would change its meaning or use.</td>
|
||||
</tr>
|
||||
|
||||
<tr>
|
||||
<td width="20%"><b>Member Of</b>:</td>
|
||||
|
||||
<td width="80%">The Class of which this term is a member.</td>
|
||||
</tr>
|
||||
|
||||
<tr>
|
||||
<td width="20%"><b>Has Domain</b>:</td>
|
||||
|
||||
<td width="80%">A Class of which a resource described by the term is
|
||||
a property.</td>
|
||||
</tr>
|
||||
|
||||
<tr>
|
||||
<td width="20%"><b>Has Range</b>:</td>
|
||||
|
||||
<td width="80%">A Class of which a value described by the term is an
|
||||
instance.</td>
|
||||
</tr>
|
||||
|
||||
<tr>
|
||||
<td width="20%"><b>Decision</b>:</td>
|
||||
|
||||
<td width="80%">The reference to the published decision that resulted
|
||||
in the current version of the term.</td>
|
||||
</tr>
|
||||
|
||||
<tr>
|
||||
<td width="20%"><b>Version</b>:</td>
|
||||
|
||||
<td width="80%">The identifier for the specific version of the
|
||||
term.</td>
|
||||
</tr>
|
||||
|
||||
<tr>
|
||||
<td width="20%"><b>Replaces</b>:</td>
|
||||
|
||||
<td width="80%">The identifier of the previous version of the
|
||||
term.</td>
|
||||
</tr>
|
||||
|
||||
<tr>
|
||||
<td width="20%"><b>Is Replaced By</b>:</td>
|
||||
|
||||
<td width="80%">The identifier of the next newer version of the
|
||||
term.</td>
|
||||
</tr>
|
||||
|
||||
<tr>
|
||||
<td width="20%"><b>Class</b>:</td>
|
||||
|
||||
<td width="80%">The primary category of terms (Class) that this term
|
||||
describes.</td>
|
||||
</tr>
|
||||
|
||||
<tr>
|
||||
<td width="20%"><b>ABCD 2.06</b>:</td>
|
||||
|
||||
<td width="80%">The xpath(s) to the equivalent concept(s) in the
|
||||
Access to Biological Collections Data schema version 2.06.</td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
|
||||
<p></p>
|
||||
<table cellspacing="0" class="border">
|
||||
<tbody>
|
||||
<!-- Begin Term Table -->
|
||||
|
|
@ -789,8 +756,36 @@ The Standard Darwin Core differs from previous versions in several important way
|
|||
<TR><TH colspan="2"><A name="YearIdentified-2003-06-13">Term Name: YearIdentified</A></TH></TR> <TR><TD>Identifier:</TD><TD>http://digir.net/schema/conceptual/darwin/2003/1.0/YearIdentified</TD></TR> <TR><TD>Namespace:</TD><TD>http://digir.net/schema/conceptual/darwin/2003/1.0/</TD></TR> <TR><TD>Label:</TD><TD>Year Identified</TD></TR> <TR><TD>Definition:</TD><TD>The year portion of the date when the Collection Item was identified; as four digits [-9999..9999], e.g., 1906, 2002.</TD></TR> <TR><TD>Comment:</TD><TD></TD></TR> <TR><TD>Type of Term:</TD><TD>http://www.w3.org/1999/02/22-rdf-syntax-ns#Property</TD></TR> <TR><TD>Refines:</TD><TD></TD></TR> <TR><TD>Status:</TD><TD>superseded</TD></TR> <TR><TD>Date Issued:</TD><TD>2003-06-13</TD></TR> <TR><TD>Date Modified:</TD><TD>2003-06-13</TD></TR> <TR><TD>Has Domain:</TD><TD></TD></TR> <TR><TD>Has Range:</TD><TD></TD></TR> <TR><TD>Version:</TD><TD>YearIdentified-2003-06-13</TD></TR> <TR><TD>Replaces:</TD><TD></TD></TR> <TR><TD>Is Replaced By:</TD><TD><a href="./index.htm#dateIdentified-2009-04-24">dateIdentified-2009-04-24</a></TD></TR> <TR><TD>Class:</TD><TD></TD></TR> <TR><TD>ABCD 2.06:</TD><TD>accessible from DataSets/DataSet/Units/Unit/Identifications/Identification/Date/DateText</TD></TR>
|
||||
<TR><TH colspan="2"><A name="YearIdentified-2003-06-17">Term Name: YearIdentified</A></TH></TR> <TR><TD>Identifier:</TD><TD>http://digir.net/schema/conceptual/darwin/2003/1.0/YearIdentified</TD></TR> <TR><TD>Namespace:</TD><TD>http://digir.net/schema/conceptual/darwin/2003/1.0/</TD></TR> <TR><TD>Label:</TD><TD>Year Identified</TD></TR> <TR><TD>Definition:</TD><TD>The four digit year in the Common Era calendar in which the cataloged item was identified as having the ScientificName.</TD></TR> <TR><TD>Comment:</TD><TD></TD></TR> <TR><TD>Type of Term:</TD><TD>http://www.w3.org/1999/02/22-rdf-syntax-ns#Property</TD></TR> <TR><TD>Refines:</TD><TD></TD></TR> <TR><TD>Status:</TD><TD>superseded</TD></TR> <TR><TD>Date Issued:</TD><TD>2003-06-17</TD></TR> <TR><TD>Date Modified:</TD><TD>2003-06-17</TD></TR> <TR><TD>Has Domain:</TD><TD></TD></TR> <TR><TD>Has Range:</TD><TD></TD></TR> <TR><TD>Version:</TD><TD>YearIdentified-2003-06-17</TD></TR> <TR><TD>Replaces:</TD><TD><a href="./index.htm#YearIdentified-2003-06-13">YearIdentified-2003-06-13</a></TD></TR> <TR><TD>Is Replaced By:</TD><TD><a href="./index.htm#dateIdentified-2009-04-24">dateIdentified-2009-04-24</a></TD></TR> <TR><TD>Class:</TD><TD></TD></TR> <TR><TD>ABCD 2.06:</TD><TD>accessible from DataSets/DataSet/Units/Unit/Identifications/Identification/Date/DateText</TD></TR>
|
||||
|
||||
<!-- End Term Table -->
|
||||
</tbody>
|
||||
</table>
|
||||
<hr />
|
||||
</body>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<footer class="footer">
|
||||
<div class="container">
|
||||
<div class="row">
|
||||
<div class="col-xs-4">
|
||||
<p><a rel="license" href="http://creativecommons.org/licenses/by/4.0/"><img alt="Creative Commons License" style="border-width:0" src="https://i.creativecommons.org/l/by/4.0/88x31.png"/></a></p>
|
||||
</div>
|
||||
<div class="col-xs-8">
|
||||
<ul class="list-inline pull-right">
|
||||
<li>Page last modified on 2015-01-13</li>
|
||||
<li><a href="https://github.com/tdwg/dwc/blob/gh-pages/terms/history.html">Edit on GitHub</a></li>
|
||||
</ul>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</footer>
|
||||
|
||||
<!-- Scripts -->
|
||||
<script type="text/javascript" src="../assets/jquery.min.js"></script>
|
||||
<script type="text/javascript" src="../assets/bootstrap.min.js"></script>
|
||||
<script>
|
||||
(function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
|
||||
(i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
|
||||
m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)
|
||||
})(window,document,'script','//www.google-analytics.com/analytics.js','ga');
|
||||
|
||||
ga('create', 'UA-386033-4', 'auto');
|
||||
ga('send', 'pageview');
|
||||
</script>
|
||||
</body>
|
||||
</html>
|
||||
|
|
|
|||
1007
terms/index.html
1007
terms/index.html
File diff suppressed because it is too large
Load Diff
Loading…
Reference in New Issue