dwc/build/README.md

Build script

The build script build.py uses as input:

• vocabulary/term_versions.csv: the list of terms
• terms.tmpl: a Jinja2 template for the quick reference guide

To create:

• The quick reference guide as a Markdown file at docs/terms/index.md. The guide is build as Markdown (with a lot of included html) rather than html, so it can incorporated by Jekyll in the Darwin Core website (including a header, footer and table of content).
• Two simple Darwin Core CSV files in dist/

Run the build script

1. Install the required libraries (once):

   pip install -r requirements.txt
   

2. Run the script from the command line:

   python build.py
   

Generating the "normative document"

The script generate_normative_csv.py pulls source data from the rs.tdwg.org GitHub repo. The local file qrg-list.csv contains a list of the term IRIs in the order that they are to appear in the Quick Reference Guide. This list needs to be changed whenever terms are added to or deprecated from Darwin Core.

It outputs the file term_versions.csv, which is used as the input for the build.py script above.