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.

--external-id is repeatable in the form type:value (e.g. wikitree:Little-20642) and fills the person's external_ids property.

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

  # Record identifiers from other systems
  glx add person --given Lewis --surname Little \
    --external-id wikitree:Little-20642 --external-id familysearch:LZX1-ABC --archive ./archive

Options

  -a, --archive string            Archive path (directory) (default ".")
      --dry-run                   Print what would be created without writing files
      --external-id stringArray   External ID in the form type:value, e.g. wikitree:Little-20642 (repeatable)
      --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