dwc/build/terms.tmpl

{#
  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.
#}

# Darwin Core Quick Reference Guide

This document is intended to be an easy-to-read reference of the currently (as of 2023-06-28) 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. Definitions, comments, and examples may include namespace abbreviations (e.g., "dwc:"). These are included to show that the meaning for the word it is attached to very specifically means the term as defined in that namespace. Thus, dwc:Event means Event as defined by Darwin Core at https://dwc.tdwg.org/terms/#event. Capitalized terms that follow a namespace abbreviation, such as dwc:Occurrence, are Darwin Core class terms, which are a special category of terms used to group sets of property terms (terms that being with lower case names that follow the namespace abbreviation, e.g., dwc:eventID) 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-primary 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">
  <tbody>
    <tr class="table-primary"><th colspan="2">{{ class_group.label }} <span class="badge bg-primary float-end">Class</span></th></tr>
    <tr><td>Identifier</td><td><a href="{{ class_group.iri }}">{{ class_group.iri }}</a></td></tr>
    <tr><td>Definition</td><td>{{ class_group.definition }}</td></tr>
    <tr><td>Comments</td><td>{{ class_group.comments }}</td></tr>
    <tr><td>Examples</td><td>{{ class_group.examples }}</td></tr>
  </tbody>
</table>
{%endif %}

{% for term in class_group.terms %}
{# Term #}
<p class="invisible">
  <span id="{{ term.namespace }}:{{ term.label }}"></span>
  {% if term.namespace != "dwciri" %}
  <span id="{{ term.label }}"></span>
  {% endif %}
</p>
{% set examples = term.examples.split("; ") %}
<table class="table">
  <tbody>
    <tr class="table-secondary"><th colspan="2">{{ term.label }}</th></tr>
    <tr><td>Identifier</td><td><a href="{{ term.iri }}">{{ term.iri }}</a></td></tr>
    <tr><td>Definition</td><td>{{ term.definition }}</td></tr>
    <tr><td>Comments</td><td>{{ term.comments }}</td></tr>
    <tr><td>Examples</td><td>{% if examples | length == 1 %}{{ examples | first }}{% else %}<ul class="list-group list-group-flush">{% for example in examples %}<li class="list-group-item">{{ example }}</li>{% endfor %}</ul>{% endif %}</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/>