mirror of https://github.com/tdwg/dwc.git
Update README.md
This commit is contained in:
parent
87bfd242c6
commit
9c19d91516
75
README.md
75
README.md
|
@ -1,6 +1,6 @@
|
|||
# Darwin Core
|
||||
|
||||
Darwin Core is a standard maintained by the Darwin Core maintenance group. 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 identifiers, labels, and definitions. Darwin Core is primarily based on taxa, their occurrence in nature as documented by observations, specimens, samples, and related information.
|
||||
Darwin Core is a standard maintained by the [Darwin Core Maintenance Interest Group](https://www.tdwg.org/standards/dwc/#maintenance%20group). 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 identifiers, labels, and definitions. Darwin Core is primarily based on taxa, their occurrence in nature as documented by observations, specimens, samples, and related information.
|
||||
|
||||
## Getting started
|
||||
|
||||
|
@ -23,39 +23,52 @@ Community:
|
|||
The repository structure is described below. Files/directories indicated with `GENERATED` should not be edited manually.
|
||||
|
||||
```
|
||||
├── README.md : Description of this repository
|
||||
├── LICENSE : Repository license
|
||||
│
|
||||
├── standard : All content considered part of the Darwin Core standard
|
||||
│ ├── vocabularies
|
||||
│ │ └── term_versions.csv : Darwin Core term versions history
|
||||
│ │
|
||||
│ └── documents
|
||||
│ ├── simple : Simple Darwin Core guide
|
||||
│ ├── rdf : RDF guide
|
||||
│ ├── text : Text guide
|
||||
│ └── xml : XML guide
|
||||
│
|
||||
├── www : GENERATED Darwin Core website
|
||||
│ └── guides
|
||||
│ └── index.html : GENERATED Darwin Core quick reference guide
|
||||
│
|
||||
├── dist : GENERATED Distribution files generated by build.py
|
||||
│ ├── dwc_terms.csv : GENERATED CSV file with the recommended Darwin Core terms, definitions, etc.
|
||||
│ ├── simple_dwc_horizontal.csv : GENERATED CSV file with Simple Darwin Core terms as a row
|
||||
│ └── simple_dwc_vertical.csv : GENERATED CSV file with Simple Darwin Core terms as a column
|
||||
├── .github
|
||||
│ ├── ISSUE_TEMPLATE : Directory of issue templates generated by GitHub
|
||||
│ ├── CONTRIBUTING.md : Guide on how to contribute, create issues, etc.
|
||||
│
|
||||
├── build
|
||||
│ ├── build.py : Build script to generate distribution files from the normative document
|
||||
│ └── config : Configuration files for build.py
|
||||
│ ├── index.tmpl : Template for index.html
|
||||
│ └── terms.csv : Configuration for the recommended terms, incl. order, labels, examples
|
||||
│ ├── doe-cv-build : Directory of build scripts for the degreeOfEstablishment controlled vocabulary
|
||||
│ ├── em-cv-build : Directory of build scripts for the establishmentMeans controlled vocabulary
|
||||
│ ├── pw-cv-build : Directory of build scripts for the pathway controlled vocabulary
|
||||
│ ├── README.md : Workflow for generating a new version of the vocabulary
|
||||
│ ├── build-termlist.ipynb : Juyter notebook to construct the term list
|
||||
│ ├── build-temlist.py : Script to build Markdown pages that provide term metadata for complex vocabularies
|
||||
│ ├── build.py : Build script to generate distribution files from the normative document
|
||||
│ ├── generate_term_versions.py : Script to build the terms_versions.csv file
|
||||
│ ├── qrg-list.csv : List of the term IRIs in the order that they are to appear in the Quick Reference Guide
|
||||
│ ├── requirements.txt : List of libraries required by the build scripts
|
||||
│ ├── termlist-footer.md : Footer to append to the generated term list document
|
||||
│ ├── termlist-header.md : Header to prepend to the generated term list document
|
||||
│ ├── terms.tmpl : A Jinja2 template to format the Quick Reference Guide
|
||||
│ └── workflow_diagram.png : Figure used in README.md to show how to create a new version of the standard
|
||||
├── dist : GENERATED Distribution files generated by build.py
|
||||
│ ├── simple_dwc_horizontal.csv : GENERATED CSV file with Simple Darwin Core terms as a row
|
||||
│ └── simple_dwc_vertical.csv : GENERATED CSV file with Simple Darwin Core terms as a column
|
||||
│
|
||||
├── .github
|
||||
│ ├── CONTRIBUTING.md : Guide on how to contribute to Darwin Core
|
||||
│ └── ISSUE_TEMPLATE.md : Template for issues
|
||||
├── docs
|
||||
│ ├── doe : Degree of Establishment Controlled Vocabulary List of Terms
|
||||
│ ├── em : Establishment Means Controlled Vocabulary List of Terms
|
||||
│ ├── list : Darwin Core List of Terms documents
|
||||
│ ├── namespace : Darwin Core namespace policy
|
||||
│ ├── pw : Pathway Controlled Vocabulary List of Terms
|
||||
│ ├── rdf : Darwin Core RDF Guide
|
||||
│ ├── simple : Simple Darwin Core Guide
|
||||
│ ├── terms
|
||||
│ │ └── index.md : Content for Quick Reference Guide generation using Jekyll
|
||||
│ │
|
||||
│ ├── text : Darwin Core Text Guide (Darwin Core Archive specification)
|
||||
│ ├── xml : Darwin Core XML Guide
|
||||
│ ├── _config.yml : Jekyll site configuration for Quick Reference Guide
|
||||
│ ├── CNAME : Canonical Name record for dwc.tdwg.org
|
||||
│ └── index.md : Header for Darwin Core web site generation using Jekyll
|
||||
│
|
||||
└── .gitignore : Files and directories to be ignored by git
|
||||
├── vocabulary
|
||||
│ └── term_versions.csv : Darwin Core term versions, contains the complete history of the terms
|
||||
│
|
||||
├── .gitignore : Files and directories to be ignored by git
|
||||
├── LICENSE : Repository license
|
||||
└── README.md : Description of this repository
|
||||
```
|
||||
|
||||
## Contributors
|
||||
|
@ -74,6 +87,6 @@ For Darwin Core in general, consider the peer-reviewed article on Darwin Core:
|
|||
|
||||
For this repository:
|
||||
|
||||
> Darwin Core maintenance group, Biodiversity Information Standards (TDWG) (2014). Darwin Core. Zenodo. https://doi.org/10.5281/zenodo.592792
|
||||
> Darwin Core Maintenance Interest Group, Biodiversity Information Standards (TDWG) (2014). Darwin Core. Zenodo. https://doi.org/10.5281/zenodo.592792
|
||||
|
||||
The citation above represents all versions of the repository. Specific [versions/releases](https://github.com/tdwg/dwc/releases) from 2011 onwards are also deposited on Zenodo.
|
||||
|
|
Loading…
Reference in New Issue