Skip to content

iand/genster

Repository files navigation

genster

go.dev reference Check Status Test Status

Usage

genster is an application for building browseable family history sites from GEDCOM files. It generates markdown documents that cam be processed with a site generator such as Jekyll or Hugo.

I created it for myself so it makes many assumptions about my particular style of using GEDCOM. It may or may not work for other people.

Notably:

  • I use Ancestry extensively and use this as the primary source of my GEDCOMs. Because of this genster includes various idioms that are peculiar to Ancestry.
  • I use Ancestry custom events to convey extra information. These appear in the exported GEDCOM as a general EVEN with the "fact label" of the event becoming its type.

Getting Started

As of Go 1.19, install the latest genster executable using:

go install github.com/iand/genster@latest

This will download and build a binary in $GOBIN.

Conventions

Some custom event "fact labels" with specific handling:

  • Nickname - holds the preferred nickname for a person (unfortunately alternate names and AKAs are very messy in Ancestry and I wanted a single value to refer to the person)
  • OLB - one line bio, a short sentence that summarises the person's life

Other examples of custom event "fact labels" that are used verbatim in the generated pages:

  • Admitted to Shipmeadow Workhouse
  • Discharged to Shipmeadow Workhouse
  • Enlisted in Royal Fusiliers
  • Discharged from Royal Fusiliers
  • Posted to Malta - use when assigned or sent to a new post
  • Posted Home
  • Stationed at Woolwich
  • Promoted to Corporal Wheeler
  • Awarded Queen's South Africa Medal - include clasps in details
  • Missing in action
  • Injured in action

Events with values that start with one of these phrases will be included verbatim in the generated narrative:

  • He was recorded as
  • She was recorded as
  • It was recorded that
  • George is recorded
  • George was recorded

License

This is free and unencumbered software released into the public domain. For more information, see http://unlicense.org/ or the accompanying UNLICENSE file.

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages