{#
    This template is NOT used by jekyll, but by the Darwin Core build script
    to create the terms/index.md file, which mostly contains html.
#}
---
container: fluid
---

# Darwin Core quick reference guide

This document is intended to be an easy-to-read reference of the currently (as of 2021-07-15) recommended terms maintained as part of the [Darwin Core standard](https://www.tdwg.org/standards/dwc/) and is maintained by the [Darwin Core Maintenance Group](https://www.tdwg.org/community/dwc/). 

This page is not part of the standard, but combines the normative term names and definitions with the non-normative comments and examples that are meant to help people to use the terms consistently. Capitalized terms, such as Occurrence, are Darwin Core classes, which are special category terms used to group sets of terms for convenience. Comprehensive metadata for current and obsolete terms in human readable form are found in the document [List of Darwin Core terms](../list/). 

Additional [files with just the current term names](https://github.com/tdwg/dwc/tree/master/dist) and a [file with the full term history](https://github.com/tdwg/dwc/blob/master/vocabulary/term_versions.csv) can be found in the [Darwin Core repository](https://github.com/tdwg/dwc). 

For inquiries about how to use Darwin Core, either enter an issue in the [Darwin Core Questions & Answers site](https://github.com/tdwg/dwc-qa/blob/master/README.md) or enter an issue in the [alternative form](https://tinyurl.com/darwin-qa), which will have the same effect. See the bottom of this document for how to [cite Darwin Core](#cite-darwin-core).

{% for class_group in class_groups %}

## {{ class_group.label }}

{% if class_group.label == 'Record-level' %}
This category contains terms that are generic in that they might apply to any type of record in a dataset.
{% endif %}
{% if class_group.label == 'UseWithIRI' %}
For more information on `UseWithIRI`, see [Section 2.5 of the RDF Guide](https://dwc.tdwg.org/rdf/#25-terms-in-the-dwciri-namespace-normative).
{% endif %}
<div class="my-4">
    {% for term in class_group.terms %}
    <a class="btn btn-sm btn-outline-secondary m-1" href="#{{ term.namespace }}:{{ term.label }}">{{ term.label }}</a>
    {% endfor %}
</div>

{% if class_group.label != 'Record-level' and class_group.label != 'UseWithIRI' %}
{# Class #}
<table class="table table-sm table-bordered">
    <tbody>
        <tr class="table-primary"><th colspan="2">{{ class_group.label }} <span class="badge badge-primary float-right">Class</span></th></tr>
        <tr><td class="theme-label">Identifier</td><td><a href="{{ class_group.iri }}">{{ class_group.iri }}</a></td></tr>
        <tr><td class="theme-label">Definition</td><td>{{ class_group.definition }}</td></tr>
        <tr><td class="theme-label">Comments</td><td>{{ class_group.comments }}</td></tr>
        <tr><td class="theme-label">Examples</td><td>{{ class_group.examples }}</td></tr>
    </tbody>
</table>
{%endif %}

{% for term in class_group.terms %}
{# Term #}
<p class="invisible">
    <a id="{{ term.namespace }}:{{ term.label }}"></a>{% if term.namespace != "dwciri" %}<a id="{{ term.label }}"></a>{% endif %}
</p>
<table class="table table-sm table-bordered">
    <tbody>
        <tr class="table-secondary"><th colspan="2">{{ term.label }} <span class="badge badge-secondary float-right">Property</span></th></tr>
        <tr><td class="theme-label">Identifier</td><td><a href="{{ term.iri }}">{{ term.iri }}</a></td></tr>
        <tr><td class="theme-label">Definition</td><td>{{ term.definition }}</td></tr>
        <tr><td class="theme-label">Comments</td><td>{{ term.comments }}</td></tr>
        <tr><td class="theme-label">Examples</td><td>{{ term.examples }}</td></tr>
    </tbody>
</table>
{% endfor %}

{% endfor %}

# Cite Darwin Core
To cite Darwin Core in general, use the peer-reviewed article on Darwin Core:

Wieczorek J, Bloom D, Guralnick R, Blum S, Döring M, et al. (2012) Darwin Core: An Evolving Community-Developed Biodiversity Data Standard. PLoS ONE 7(1): e29715. <https://doi.org/10.1371/journal.pone.0029715>

To cite the standard document upon which this page is built, use the following:

Darwin Core Maintenance Group. 2021. List of Darwin Core terms. Biodiversity Information Standards (TDWG). <http://rs.tdwg.org/dwc/doc/list/>

To cite this document specifically, use the following:

Darwin Core Maintenance Group. 2021. Darwin Core quick reference guide. Biodiversity Information Standards (TDWG). <https://dwc.tdwg.org/terms/>