This page describe the specs of yaml frontmatter for csv file format. The main goals of the format are extreme simplicity and readability
Because for data human’s curators from no-data, CSV, CSV+metadata to Semi-structured data, the technological gap is too large. A simple file format to add metadata to the existing datasets is needed, json is very cryptic for humans, but yaml can do the job.
There are many initiatives which it plans to use json + csv, but most are not meant to be published and read by humans.
A YAML metadata block is a valid YAML object, delimited by a line of three hyphens
--- at the top and a line of three hyphens
--- or three dots
... at the bottom.
Use the JSON Table Schema:
--- name: my-dataset fields: - name: var1 title: variable 1 type: string description: explaining var1 constraints: - required: true - name: var2 title: variable 2 type: integer - name: var3 title: variable 3 type: number --- var1,var2,var3 A,1,2.5 B,3,4.3
|Language||Parser||Skip lines||Comment lines||Comments|
|Ruby||csv.read||no||yes||skip lines via regex|
Use Github Issues.