glx add event

Create an event entity

Synopsis

Create an Event entity in the archive.

--type is required and is validated against the event_types vocabulary. --principal is a shorthand for adding the named person with role "principal". --participant is repeatable in the form person-id:role. At least one of --principal or --participant is required. --date must be a valid GLX date string (e.g. 1725-02-25, ABT 1850, JULIAN 1643-02-20). --property is repeatable in the form key=value; each key must be defined in the event_properties vocabulary (event_subtype, description, cause, ...).

glx add event [flags]

Examples

  # Christening with a principal and a place
  glx add event --type christening --date 1725-02-25 \
    --place place-enkirch \
    --principal person-johann-peter-jungk \
    --archive ./archive

  # Marriage with multiple participants
  glx add event --type marriage --date 1850 \
    --participant person-john:groom \
    --participant person-jane:bride \
    --archive ./archive

  # Event with properties
  glx add event --type death --date 1826 --principal person-lewis-little \
    --property cause="fever" --property description="Died intestate" \
    --archive ./archive

Options

  -a, --archive string            Archive path (directory) (default ".")
      --date string               Event date (GLX date string)
      --dry-run                   Print what would be created without writing files
      --force                     Overwrite an existing entity with the chosen ID
  -h, --help                      help for event
      --id string                 Override the derived entity ID
      --note stringArray          Free-text note (repeatable)
      --participant stringArray   Additional participant in the form person-id:role (repeatable)
      --place string              Place ID for the event
      --principal string          Person ID of the principal subject (shorthand for --participant PERSON-ID:principal)
      --property stringArray      Event property in the form key=value; key from event_properties (repeatable)
      --skip-validate             Skip whole-archive validation after adding (vocab and reference checks still run)
      --title string              Optional human-readable title
      --type string               Event type (required, vocabulary key in event_types)

Options inherited from parent commands

  -q, --quiet   Suppress non-error output (where supported)

SEE ALSO

• glx add - Create entities (person, place, event, …) from CLI flags