mirror of https://github.com/tdwg/dwc.git
Write script readme and migrate xml guide to new design
This commit is contained in:
parent
b30db03c67
commit
190e884fc1
|
@ -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
|
||||||
|
|
|
@ -1,8 +1,12 @@
|
||||||
#!/usr/bin/env python
|
#!/usr/bin/env python
|
||||||
|
|
||||||
'''
|
'''
|
||||||
easy_install pip
|
Install the required libraries for this script with PIP:
|
||||||
pip install -r requirements.txt
|
$ 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
|
import yaml, re, csv, codecs
|
||||||
|
|
|
@ -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>
|
|
@ -1,298 +1,82 @@
|
||||||
<!DOCTYPE html>
|
<!DOCTYPE html>
|
||||||
|
|
||||||
<html lang="en">
|
<html lang="en">
|
||||||
<head>
|
<head>
|
||||||
<meta content="text/html; charset=utf-8" http-equiv="Content-Type">
|
<meta charset="utf-8">
|
||||||
|
<title>Darwin Core XML Guide</title>
|
||||||
<title>Darwin Core XML Guide</title>
|
<link href="http://rs.tdwg.org/dwc/" rel="schema.DwC">
|
||||||
<link href="http://rs.tdwg.org/dwc/" rel="schema.DwC">
|
<meta content="Darwin Core XML Guide" name="DC.title">
|
||||||
<meta content="Darwin Core XML Guide" name="DC.title">
|
<meta content="Guidelines for implementing Darwin Core as XML." name="DC.description">
|
||||||
<meta content="Guide for implementing Darwin Core in XML." name=
|
<meta name="DC.modified" content="2015-01-13"><!-- Also update in footer -->
|
||||||
"DC.description">
|
|
||||||
<meta content="biodiversity, standards" name="DC.subject">
|
<meta name="dcterms.subject" content="biodiversity, standards">
|
||||||
<meta content="Darwin Core Task Group" name="DC.creator">
|
<meta name="dcterms.creator" content="Darwin Core Task Group">
|
||||||
<meta content="John Wieczorek (MVZ)" name="DC.contributor">
|
<meta name="dcterms.contributor" content="John Wieczorek (MVZ)">
|
||||||
<meta content="Markus Döring (GBIF)" name="DC.contributor">
|
<meta name="dcterms.contributor" content="Markus Döring (GBIF)">
|
||||||
<meta content="Renato De Giovanni (CRIA)" name="DC.contributor">
|
<meta name="dcterms.contributor" content="Renato De Giovanni (CRIA)">
|
||||||
<meta content="Tim Robertson (GBIF)" name="DC.contributor">
|
<meta name="dcterms.contributor" content="Tim Robertson (GBIF)">
|
||||||
<meta content="Dave Vieglais (KUNHM)" name="DC.contributor">
|
<meta name="dcterms.contributor" content="Dave Vieglais (KUNHM)">
|
||||||
<meta content="2009-02-12" name="DC.dateAccepted">
|
<meta name="dcterms.contributor" content="Peter Desmet (INBO)">
|
||||||
<meta content="http://rs.tdwg.org/dwc/2010-05-23/terms/guides/xml/" name=
|
<meta name="dcterms.publisher" content="Biodiversity Information Standards (TDWG)">
|
||||||
"DC.replaces">
|
<meta name="dcterms.license" content="http://creativecommons.org/licenses/by/4.0/legalcode">
|
||||||
<meta content="2014-11-08" name="DC.modified">
|
<meta name="dcterms.language" content="en">
|
||||||
<meta content="http://rs.tdwg.org/dwc/2014-11-08/terms/guides/xml" name=
|
<meta name="viewport" content="width=device-width, initial-scale=1">
|
||||||
"DC.identifier">
|
<link rel="stylesheet" type="text/css" href="../../assets/bootstrap.min.css">
|
||||||
<meta content="text/html" name="DC.format">
|
<link rel="stylesheet" type="text/css" href="../../assets/main.css">
|
||||||
<meta content="Biodiversity Information Standards TDWG" name="DC.publisher">
|
<link href="http://www.tdwg.org/" rel="meta">
|
||||||
<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>
|
|
||||||
</head>
|
</head>
|
||||||
|
|
||||||
<body>
|
<body>
|
||||||
<table border="0" cellpadding="0" cellspacing="0" style=
|
<nav class="navbar navbar-default navbar-fixed-top">
|
||||||
"background-color: #617394" width="100%">
|
<div class="container">
|
||||||
<tbody>
|
<div class="navbar-header">
|
||||||
<tr>
|
<button type="button" class="navbar-toggle collapsed" data-toggle="collapse" data-target=".navbar-collapse">
|
||||||
<td>
|
<span class="sr-only">Toggle navigation</span>
|
||||||
<a href="http://www.tdwg.org"><img alt=
|
<span class="icon-bar"></span><span class="icon-bar"></span><span class="icon-bar"></span>
|
||||||
"Biodiversity Information Standards (TDWG) logo" height="89" src=
|
</button>
|
||||||
"../../../DarwinCore_files/TDWGlogo_Twiki.gif" width="148"></a>
|
<a class="navbar-brand" href="../index.html">Darwin Core</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>
|
|
||||||
</div>
|
</div>
|
||||||
</div>
|
<div class="collapse navbar-collapse">
|
||||||
</td>
|
<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>
|
<h2 id="introduction">1. Introduction</h2>
|
||||||
<center><h1>Darwin Core XML Guide</h1><center>
|
<p>
|
||||||
|
<b>Audience</b>: This document is targeted toward
|
||||||
<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
|
|
||||||
those who wish to use or construct application schemas using Darwin Core
|
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
|
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
|
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
|
<p>This document provides guidelines for implementing application schemas
|
||||||
based on Darwin Core terms [<a href="../../index.htm">TERMS</a>] using
|
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
|
<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
|
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
|
metadata in 'plain' XML rather than RDF/XML. This document provides
|
||||||
guidelines in those cases where RDF/XML is not considered appropriate. <a id=
|
guidelines in those cases where RDF/XML is not considered appropriate.</p>
|
||||||
"implement" name="implement"></a></p>
|
|
||||||
|
|
||||||
<h2>2. Implementation Guide</h2>
|
<h2 id="implement">2. Implementation Guide</h2>
|
||||||
|
|
||||||
<p><a id="xmlschema" name="xmlschema"></a></p>
|
<h3 id="xmlschema">2.1 XML Schema</h3>
|
||||||
|
<p>Implementors should base their XML applications on
|
||||||
<h3>2.1 XML Schema</h3>Implementors should base their XML applications on
|
|
||||||
<i>XML Schemas</i> [<a href="http://www.w3.org/XML/Schema">XMLSCHEMA</a>]
|
<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
|
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
|
[<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
|
uniquely identify elements. Darwin Core namespaces are defined in the
|
||||||
<i>Darwin Core Namespace Policy</i> [<a href=
|
<i>Darwin Core Namespace Policy</i> [<a href=
|
||||||
"../../namespace/index.htm">NAMESPACEPOLICY</a>], while Dublin Core
|
"../../namespace/index.htm">NAMESPACEPOLICY</a>], while Dublin Core
|
||||||
namespaces are defined in the <i>DCMI Namespace Recommendation</i> [<a href=
|
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
|
<p>The Darwin Core follows the <i>Dublin Core Metadata Initiative Abstract
|
||||||
Model</i> [<a href=
|
Model</i> [<a href=
|
||||||
|
@ -353,18 +134,12 @@
|
||||||
record</em> describe that record.</li>
|
record</em> describe that record.</li>
|
||||||
|
|
||||||
<li>A <em>Darwin Core record</em> must include all required
|
<li>A <em>Darwin Core record</em> must include all required
|
||||||
<em>properties</em>, if any, and their associated <em>values</em>.</li>
|
<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>
|
|
||||||
-->
|
|
||||||
</ul>
|
</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
|
<p>The Darwin Core follows the guidelines for expressing Dublin Core metadata
|
||||||
using XML [<a href=
|
using XML [<a href=
|
||||||
"http://dublincore.org/documents/dc-xml/">DCMIXMLGUIDE</a>] except in that
|
"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
|
value given in the <em>Term name</em> attribute in the Darwin Core Terms
|
||||||
recommendation [<a href="../../index.htm">TERMS</a>] with the appropriate
|
recommendation [<a href="../../index.htm">TERMS</a>] with the appropriate
|
||||||
namespace name. For example, use</p>
|
namespace name. For example, use</p>
|
||||||
|
|
||||||
<pre class="example">
|
<pre class="example">
|
||||||
<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema"
|
<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema"
|
||||||
targetNamespace="http://rs.tdwg.org/dwc/terms/"
|
targetNamespace="http://rs.tdwg.org/dwc/terms/"
|
||||||
|
@ -384,58 +160,29 @@
|
||||||
</pre>
|
</pre>
|
||||||
|
|
||||||
<p>rather than</p>
|
<p>rather than</p>
|
||||||
|
|
||||||
<pre class="example">
|
<pre class="example">
|
||||||
<dwc:basisOfRecord value="HumanObservation" />
|
<dwc:basisOfRecord value="HumanObservation" />
|
||||||
</pre>
|
</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
|
<h3 id="nullvalues">2.5 Null values</h3>
|
||||||
[<A href="http://www.w3.org/XML/Schema">XMLSCHEMA</A>].
|
|
||||||
-->
|
|
||||||
<a id="nullvalues" name="nullvalues"></a></p>
|
|
||||||
|
|
||||||
<h3>2.5 Null values</h3>
|
|
||||||
|
|
||||||
<p>Elements for which the value is null should be omitted from the document
|
<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>
|
or explicitly coded using the attribute <i>xsi:nil="true"</i>.</p>
|
||||||
|
|
||||||
<pre class="example">
|
<pre class="example">
|
||||||
<dwc:locality xsi:nil="true"/>
|
<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">
|
<pre class="example">
|
||||||
<dwc:locality></dwc:locality>
|
<dwc:locality></dwc:locality>
|
||||||
</pre><!--
|
</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>
|
|
||||||
|
|
||||||
<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=
|
<p>The <i>Simple Darwin Core</i> [<a href=
|
||||||
"../../../xsd/tdwg_dwc_simple.xsd">SIMPLEXMLSCHEMA</a>] most closely models
|
"../../../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
|
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
|
the XML document) shows detail for a single record having a more complete set
|
||||||
of elements.</p>
|
of elements.</p>
|
||||||
|
|
||||||
<pre class="example">
|
<pre class="example">
|
||||||
<?xml version="1.0"?>
|
<?xml version="1.0"?>
|
||||||
<dwr:SimpleDarwinRecordSet
|
<dwr:SimpleDarwinRecordSet
|
||||||
|
@ -494,9 +242,8 @@ It is permissible to indicate the language of the <EM>value</EM> using the '
|
||||||
</dwr:SimpleDarwinRecordSet>
|
</dwr:SimpleDarwinRecordSet>
|
||||||
</pre>
|
</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
|
<p>Many Darwin Core terms (<i>properties</i>) are defined as being associated
|
||||||
with another term (a <i>class</i>). For example, <a href=
|
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
|
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
|
class-based schema. Note that you can reuse the location definition here by
|
||||||
referring to it via locationID:</p>
|
referring to it via locationID:</p>
|
||||||
|
|
||||||
<pre class="example">
|
<pre class="example">
|
||||||
<?xml version="1.0"?>
|
<?xml version="1.0"?>
|
||||||
<dwr:DarwinRecordSet
|
<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:relationshipOfResource>mother of</dwc:relationshipOfResource>
|
||||||
</dwc:ResourceRelationship>
|
</dwc:ResourceRelationship>
|
||||||
</dwr:DarwinRecordSet>
|
</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
|
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
|
identification class here as there is not identification related data and link
|
||||||
via the taxonID directly:
|
via the taxonID directly:</p>
|
||||||
|
|
||||||
<pre class="example">
|
<pre class="example">
|
||||||
<?xml version="1.0"?>
|
<?xml version="1.0"?>
|
||||||
<dwr:DarwinRecordSet
|
<dwr:DarwinRecordSet
|
||||||
|
@ -728,24 +479,37 @@ via the taxonID directly:
|
||||||
</dwc:Occurrence>
|
</dwc:Occurrence>
|
||||||
</dwr:DarwinRecordSet>
|
</dwr:DarwinRecordSet>
|
||||||
</pre>
|
</pre>
|
||||||
<hr>
|
|
||||||
<!-- Footer -->
|
|
||||||
|
|
||||||
<p>Except where otherwise noted, content on this site is licensed under a
|
</div>
|
||||||
<a href="http://creativecommons.org/licenses/by/4.0/" rel="license">Creative
|
</div>
|
||||||
Commons Attribution 4.0 International License</a>.</p>
|
|
||||||
|
|
||||||
<p><a href="http://creativecommons.org/licenses/by/4.0/" rel=
|
<footer class="footer">
|
||||||
"license"><img alt="Creative Commons License" id="creative_commons_icon" src=
|
<div class="container">
|
||||||
"http://i.creativecommons.org/l/by/4.0/88x31.png"></a> Copyright 2011-2014 -
|
<div class="row">
|
||||||
Biodiversity Information Standards - TDWG - <a href=
|
<div class="col-xs-4">
|
||||||
"http://www.tdwg.org/about-tdwg/contact-us/">Contact Us</a><br>
|
<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>
|
||||||
<!-- The following is used to register Google Analytics for Darwin Core -->
|
</div>
|
||||||
<script src="http://www.google-analytics.com/urchin.js" type=
|
<div class="col-xs-8">
|
||||||
"text/javascript"></script> <script type="text/javascript">
|
<ul class="list-inline pull-right">
|
||||||
|
<li>Page last modified on 2015-01-13</li>
|
||||||
_uacct = "UA-386033-4";
|
<li><a href="https://github.com/tdwg/dwc/blob/gh-pages/resources.html">Edit on GitHub</a></li>
|
||||||
urchinTracker();
|
</ul>
|
||||||
</script></p>
|
</div>
|
||||||
</body>
|
</div>
|
||||||
</html>
|
</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>
|
||||||
|
|
Loading…
Reference in New Issue