glx add person

Create a person entity

Synopsis

Create a Person entity in the archive.

At least one of --given, --surname, or --id must be supplied. The derived ID is "person-GIVEN-SURNAME" with each part slug-lowercased; --id overrides it.

Sex (recorded sex, GEDCOM SEX) and gender (self-identified) are validated against the archive's sex_types and gender_types vocabularies. Standard vocabularies are loaded automatically for archives that have not customized them.

glx add person [flags]

Examples

  # Mint a person from given + surname
  glx add person --given "Johann Peter" --surname "Jungk" --sex male --archive ./archive

  # Capture the ID into a shell variable
  pid=$(glx add person --given Anna --surname Müller --archive ./archive)
  echo "created $pid"

  # Override the ID explicitly
  glx add person --id person-jungk-johann-peter --given Johann --surname Jungk --archive ./archive

Options

  -a, --archive string          Archive path (directory) (default ".")
      --dry-run                 Print what would be created without writing files
      --force                   Overwrite an existing entity with the chosen ID
      --gender string           Self-identified gender (vocabulary key in gender_types)
      --given string            Given name(s)
  -h, --help                    help for person
      --id string               Override the derived entity ID
      --nickname string         Nickname
      --note stringArray        Free-text note (repeatable)
      --occupation string       Occupation (free text)
      --prefix string           Name prefix (e.g. Dr., Rev.)
      --residence string        Place ID of residence (must reference an existing place; person_properties.residence is reference_type:places)
      --sex string              Recorded sex (vocabulary key in sex_types)
      --skip-validate           Skip whole-archive validation after adding (vocab and reference checks still run)
      --suffix string           Name suffix (e.g. Jr., III)
      --surname string          Surname
      --surname-prefix string   Surname prefix (e.g. de, von)

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