gloss

Create glossaries, simply. Supports descriptions, tags, references and disambiguations

usage:

node gloss.js <input.yml> <output.html> [--sort-yaml]

• input.yml is your glossary definition as outlined below
• output.html is the generated html file
• --sort-yaml causes the input yaml file to be sorted into alphabetical order

Definitions

Simple

Thing: Description of thing

or

Thing:
  Description of thing

Tags

Thing:
  - Description of thing
  - [One Tag, Another Tag]

References

Define "See other" style definitions by simply setting the description to the name of the other term:

Thing A: 
  Description of Thing A
Thing B: 
  - Description of Thing B
  - Thing A

Reference other terms inside descriptions with backticks

Thing A: 
  Description of Thing A
Thing B: 
  - Description of Thing B, which is similar to `Thing A`
  - Thing A

Disambiguations

Define "disambiguation" style definitions by prefixing the term to disambiguate against with the ¬ (not) operator:

Thing A: Description of Thing A
Thing B: 
  - Description of Thing B
  - Thing A
  - ¬Thing C
Thing C: Description of Thing C

Multiple Definitions

You can conveniently create similies by comma separating term names. The first term becomes the primary term that the similies reference.

Thing A,Also A: Description of Thing A

is equivalent to:

Thing A: Description of Thing A
Also A: Thing A