Korin API

V551ToV70

Table of Contents

Classes

Ages
Ages by the 7.0 grammar: lowercase units in the order y m w d, one space between parts and after "<" or ">" ("<0Y" → "< 0y", "11m 99y" → "99y 11m"); a number without a unit is years, as most 5.5.1 programs read it. CHILD, INFANT and STILLBORN become "< 8y", "< 1y" and "0y" with the word as PHRASE; anything else becomes PHRASE of an empty age.
Dates
Dates by the 7.0 grammar (specification section 2.6 and appendix A), uppercase:
Enumerations
Enumeration values in 7.0 case and spelling (birth → BIRTH, PRE-1970 → PRE_1970, DNS/CAN → DNS_CAN). A value the 7.0 set does not have becomes OTHER with the value as PHRASE where 7.0 has both ("1 NAME … 2 TYPE Screen" → TYPE OTHER, PHRASE Screen), and stays as it is elsewhere; the event type a citation is from, whose set has no OTHER, is EVEN, the generic event, with the value as PHRASE ("2 EVEN Census of Galicia" → EVEN EVEN, PHRASE Census of Galicia). A 5.5.1 role description "(text)" is OTHER with PHRASE text.
Events
7.0 EVEN of an individual or a family requires TYPE, 5.5.1 does not: an EVEN with a value ("Moved to Osaka", which describes the event) and no TYPE gets the value as its first TYPE.
FileHeader
HEAD.CHAR, HEAD.GEDC.FORM and HEAD.FILE describe the file, not its data, and 7.0 has none of them (a 7.0 file is always UTF-8 and lineage-linked, and its name is whatever it is saved as): they are removed without a loss (SPEC section 7, "Source housekeeping structures").
Identifiers
AFN, RFN and RIN become EXID with the TYPE the 7.0 term files define for the conversion:
InlineRecords
7.0 has no inline media or source: OBJE and SOUR substructures point to records. Each one without a pointer becomes a new record @X<n>@ (before TRLR, in order of appearance), and the substructure points to it:
Languages
Languages as BCP 47 tags: the 5.5.1 language names (case-insensitive) map to their tags as in the gedcom7code converter, except Dogri, which is "doi" (it writes "dgr", Dogrib). A value that already is a tag of a 2- or 3-letter language ("uk", "en-GB") stays; any other becomes "und" with the value in an extension _PHRASE (7.0 LANG has no PHRASE), as gedcom7code does; HEAD.SCHMA documents it (Schema).
Media
Media files by the 7.0 types:
NoteRecords
The 5.5.1 NOTE record is the 7.0 shared note SNOTE, and a NOTE that points to it (in 5.5.1 a NOTE pointer always points to a NOTE record) is SNOTE too, where 7.0 has SNOTE: under a TRAN (5.5.1 ROMN, FONE) it stays NOTE for the structures rule, which keeps it as _NOTE. NOTE with text stays NOTE.
Occurrences
An event with neither a value nor substructures (1 BURI) says that the event occurred, which 7.0 writes as Y: it has no structure without both.
Repositories
5.5.1 REPO of a source without a pointer (a repository known only by its call numbers) is REPO @VOID@ in 7.0, which requires the pointer.
Schema
HEAD.SCHMA documents the extension tags with a standard meaning that the conversion writes: "_PHRASE https://gedcom.io/terms/v7/PHRASE" (a relocated PHRASE) when a LANG of the input has no BCP 47 tag (Languages). Whether one does comes from the prepass, so that HEAD is complete when it is converted, as convertFile() needs. A tag the input already has is left out, as its meaning there is not known; an existing SCHMA gets the TAG added (unless it has one for _PHRASE already), an input without HEAD a HEAD. Extensions of the input and those without a standard URI (_SUBN, _TYPE) are not documented: Korin does not guess or invent what they mean.
Sexes
SEX U with _SEX X, which the conversion to 5.5.1 writes for SEX X, is SEX X (to 5.5.5 also _SEX N, SEX N).
Submissions
7.0 has no SUBN (the LDS submission record). Its substructures move to HEAD._SUBN, one per SUBN record, so a conversion back can restore it; the record and HEAD.SUBN, the pointer to it, are removed. Done when HEAD is converted, with the SUBN records from the prepass: a SUBN record may be anywhere, HEAD is first. A SUBN record an earlier step of a route made (7.0 → 5.5.1 → 5.5.5) moves when it is converted, its values written anew.
TextValues
Text values by the 7.0 line rules: CONC lines are joined (7.0 has no CONC and no line length limit; CONT stays), and "@" is doubled only at the start of a line instead of everywhere ("with @@ inside" → "with @ inside"). "@#…@" sequences are kept as text ("@#DJULIAN@ x" → "@@#DJULIAN@ x"); the date rule, which runs after this one, reads calendar escapes in DATE from that text. Rules after this one read values by the 7.0 rules (Context::value()).
Translations
FONE and ROMN, the phonetic and romanized variations of a name or place, become TRAN with a BCP 47 LANG in place of their TYPE: the types 5.5.1 names map to a language and script (hangul → ko-Hang, kana → ja-Kana, romaji → ja-Latn, pinyin → zh-Latn-pinyin, wadegiles → zh-Latn-wadegile; a FONE type only for FONE, a ROMN type only for ROMN); any other type keeps its value as _TYPE, with LANG und (FONE) or und-Latn (ROMN, a romanization is in Latin script). An empty TYPE is dropped.
Uids
The vendor tag _UID is the 7.0 UID. Its value is kept as it is: the UID term says an existing identifier "should be used without modification", so a PAF-style UUID with a checksum stays.
Xrefs
Xrefs and pointers. 7.0 allows only uppercase letters, digits and "_" in an xref and reserves @VOID@: a record with any other xref (@fam 1@, @note@, @VOID@) gets @X<n>@, the next free n in document order, and every pointer to it follows. A pointer to a record that does not exist (compared case-sensitively: @test@ is not @TEST@) becomes the null pointer @VOID@, except under NOTE: there it is more likely text written without "@@" escaping (@Smith family@) and stays text (NOTE @@Smith family@), so nothing is lost, and in an extension (_IN @B1@), which 7.0 leaves to the extension's definition. Needs the prepass: a pointer may come before the record it points to.
On this page

Search results