GEDCOM X Representation of Death and Burial Information (Chinese Example)

Summary

During research for WONG Aloiau (born 1848, Guangdong, China, son of WONG Hin Tai and CHUN Shee, id https://familysearch.org/ark:/61903/4:1:LDKP-MK3), a researcher visits a grave marker in Honolulu, Hawaii, and takes a digital photograph of the grave marker. The marker is described by providing a title, citation, and other metadata. A transcription of the marker (which is in Chinese) is provided, as is a translation. Information about the name, birth, death, and burial is extracted from the marker. The extracted information is assembled together with information extracted from other records to aggregate what is presumed to be known about WONG Aloiau.

Gathering the Information

A researcher visits the Manoa Chinese Cemetery (a.k.a. Lin Yee Chung Cemetery) in Honolulu, Hawaii and takes a photograph of the grave marker for WONG Aloiau. The following is the digital image of the marker:

Grave Marker, WONG Aloiau, Manoa Chinese Cemetery, Honolulu, Hawaii

Describing the Source

The marker itself is described as a source with the following information:

name value provided by
Source Title Grave Marker of WONG Aloiau, Lin Yee Chung Cemetery, Honolulu, Oahu, Hawaii User
Source Citation WONG Aloiau gravestone, Lin Yee Chung Cemetery, Honolulu, Oahu, Hawaii; visited May 1975 by Jane Doe. User, possibly aided by software.
Repository Name Lin Yee Chung Cemetery, Honolulu, Oahu, Hawaii User
Source Type Physical Artifact User
Source Id S-1 Software

Describing the Digital Image of the Source

The digital image of the grave marker is also described as a source with the following information:

name value provided by
Source Title Grave Marker of WONG Aloiau, Lin Yee Chung Cemetery, Honolulu, Oahu, Hawaii User
Source Citation WONG Aloiau gravestone (digital photograph), Lin Yee Chung Cemetery, Honolulu, Oahu, Hawaii; visited May 1975 by Jane Doe. User, possibly aided by software.
ID of Source of the Source S-1 User, possibly aided by software.
Source Type Digital Artifact User, possibly aided by software.
Source Id S-2 Software

Transcribing the Source

The digital image is transcribed as as follows:

WONG ALOIAU
NOV. 22, 1848 – AUG. 3, 1920
中山  大字都  泮沙鄉
生  於  前  清 戊申 年 十一 月 廿二(日)子   時
終  於  民國  庚申 年     七月    十二 (日)    午    時
先考  諱 羅有  字 容康 王 府 君 之 墓

Describing the Transcription of the Source

The transcription of the digital image is also described as a source with the following information:

name value provided by
Source Title Transcription of Grave Marker of WONG Aloiau, Lin Yee Chung Cemetery, Honolulu, Oahu, Hawaii User
Source Citation WONG Aloiau gravestone (transcription), Lin Yee Chung Cemetery, Honolulu, Oahu, Hawaii; visited May 1975 by Jane Doe. User, possibly aided by software.
ID of Source of the Source S-2 User, possibly aided by software.
Source Type Digital Artifact User, possibly aided by software.
Source Id S-3 Software

Translating the Source

The transcription is translated as as follows:

WONG ALOIAU
NOV. 22, 1848 – AUG. 3, 1920 [lunar dates]
[Birthplace] [China, Guandong, ]Chung Shan, See Dai Doo, Pun Sha village
[Date of birth] Born at former Qing 1848 year 11th month 22nd day 23-1 hour.
[Life] ended at Republic of China year 1920 year 7th mo. 12th day 11-13 hour.
Deceased father avoid [mention of] Lo Yau also known as Young Hong Wong [noble]residence ruler’s grave.

Describing the Translation of the Source

The translation of the transcription is also described as a source with the following information:

name value provided by
Source Title Translation of Grave Marker of WONG Aloiau, Lin Yee Chung Cemetery, Honolulu, Oahu, Hawaii User
Source Citation WONG Aloiau gravestone, Lin Yee Chung Cemetery, Honolulu, Oahu, Hawaii; visited May 1975 by Jane Doe. Translation by HANYU Pinyin 王大年. User, possibly aided by software.
ID of Source of the Source S-3 User, possibly aided by software.
Source Type Digital Artifact User, possibly aided by software.
Source Id S-4 Software

Extracting the Information

The researcher extracts the following information from the translation:

description value
Events
type date (original) date (interpreted) place
Birth former Qing 1848 year 11th month 22nd day 23-1 hour Nov. 22 1848 Pun Sha Village, See Dai Doo, Chung Shan, Guangdong, China
Death Republic of China year 1920 year 7th mo. 12th day 11-13 hour Aug. 3 1920 (not extracted)
Burial (not extracted) (not extracted) Lin Yee Chung Cemetery, Honolulu, Oahu, Hawaii
Name WONG ALOIAU
Father’s Name Lo Yau
Father’s A.K.A. Name Young Hong Wong

Analyzing the Information

The researcher analyzes the grave marker within the context of the other records of WONG Aloiau she has found. She writes an analysis document that details her conclusions of the identity of WONG Aloiau.

Representing the Information

The information gathered is represented using GEDCOM X as follows:

Create the GEDCOM X Root Document

All GEDCOM X information is contained within a “root” document. When the document is created, the software being used by the researcher provides information about who can be attributed the information.

The following snippet demonstrates how a root document is initialized in both XML and JSON. The information within the document is dated March 7, 2014 and attributed to a user named “Jane Doe” with an e-mail address of “example@example.org”. An instance of the Agent data type is provided to describe the contributor, and an instance of the Attribution data type is provided to attribute the information to the contributor.

XML
<gedcomx xmlns="http://gedcomx.org/v1/">
    <attribution>
        <contributor resource="#A-1"/>
        <modified>2014-04-04T00:00:00-06:00</modified>
    </attribution>
    ...
    <agent id="A-1">
        <email resource="mailto:example@example.org"/>
        <name>Jane Doe</name>
    </agent>
    ...
</gedcomx>
JSON
{
  "attribution" : {
    "contributor" : {
      "resource" : "#A-1"
    },
    "modified" : 1395900000000
  },
  ...
  "agents" : [ {
    "names" : [ {
      "value" : "Jane Doe"
    } ],
    "emails" : [ {
      "resource" : "mailto:example@example.org"
    } ],
    "id" : "A-1"
  }, ... ],
  ...
}

The Grave Stone and Its Digital Image

The gravestone and its digial image are each described by providing an instance of the SourceDescription data type in the root document. The following snippet demonstrates how the sources are described in both XML and JSON. The source descriptions include a title, a citation, and a reference to the cemetery, which is represented using an Agent. Note that the digital image cites the physical grave stone as a source.

XML
<gedcomx xmlns="http://gedcomx.org/v1/">
    ...
    <sourceDescription resourceType="http://gedcomx.org/PhysicalArtifact" id="S-1">
        <citation>
            <value>WONG Aloiau gravestone, Lin Yee Chung Cemetery, Honolulu, Oahu, Hawaii; visited May 1975 by Jane Doe.</value>
        </citation>
        <title>Grave Marker of WONG Aloiau, Lin Yee Chung Cemetery, Honolulu, Oahu, Hawaii</title>
        <repository resource="#A-2"/>
    </sourceDescription>
    <sourceDescription resourceType="http://gedcomx.org/DigitalArtifact" id="S-2">
        <citation>
            <value>WONG Aloiau gravestone (digital photograph), Lin Yee Chung Cemetery, Honolulu, Oahu, Hawaii; visited May 1975 by Jane Doe.</value>
        </citation>
        <source description="#S-1"/>
        <title>Grave Marker of WONG Aloiau, Lin Yee Chung Cemetery, Honolulu, Oahu, Hawaii</title>
    </sourceDescription>
    ...
    <agent id="A-2">
        <address>
            <city>Honolulu</city>
            <stateOrProvince>Hawaii</stateOrProvince>
        </address>
        <name>Lin Yee Chung Cemetery</name>
    </agent>
    ...
</gedcomx>
JSON
{
  ...
  "sourceDescriptions" : [ {
    "resourceType" : "http://gedcomx.org/PhysicalArtifact",
    "citations" : [ {
      "value" : "WONG Aloiau gravestone, Lin Yee Chung Cemetery, Honolulu, Oahu, Hawaii; visited May 1975 by Jane Doe."
    } ],
    "titles" : [ {
      "value" : "Grave Marker of WONG Aloiau, Lin Yee Chung Cemetery, Honolulu, Oahu, Hawaii"
    } ],
    "repository" : {
      "resource" : "#A-2"
    },
    "id" : "S-1"
  }, {
    "sources" : [ {
      "description" : "#S-1"
    } ],
    "resourceType" : "http://gedcomx.org/DigitalArtifact",
    "citations" : [ {
      "value" : "WONG Aloiau gravestone (digital photograph), Lin Yee Chung Cemetery, Honolulu, Oahu, Hawaii; visited May 1975 by Jane Doe."
    } ],
    "titles" : [ {
      "value" : "Grave Marker of WONG Aloiau, Lin Yee Chung Cemetery, Honolulu, Oahu, Hawaii"
    } ],
    "id" : "S-2"
  }, ... ],
  ...
  "agents" : [ {
    "names" : [ {
      "value" : "Lin Yee Chung Cemetery"
    } ],
    "addresses" : [ {
      "city" : "Honolulu",
      "stateOrProvince" : "Hawaii"
    } ],
    "id" : "A-2"
  }, ... ],
  ...
}

The Transcription

The transcription of the digital image is provided as an instance of the Document data type in the root document. The language of the document is described as Chinese, using the “zh” ISO code. The transcription is then described as a source using a SourceDescription. The following snippet demonstrates how the transcription and its description are represented in both XML and JSON. Note that the digital image is cited as a source.

XML
<gedcomx xmlns="http://gedcomx.org/v1/">
    ...
    <sourceDescription about="#D-1" resourceType="http://gedcomx.org/DigitalArtifact" id="S-3">
        <citation>
            <value>WONG Aloiau gravestone (transcription), Lin Yee Chung Cemetery, Honolulu, Oahu, Hawaii; visited May 1975 by Jane Doe.</value>
        </citation>
        <source description="#S-2"/>
        <title>Transcription of Grave Marker of WONG Aloiau, Lin Yee Chung Cemetery, Honolulu, Oahu, Hawaii</title>
    </sourceDescription>
    ...
    <document xml:lang="zh" id="D-1">
        <source description="#S-2"/>
        <text>WONG ALOIAU
NOV. 22, 1848 – AUG. 3, 1920
中山  大字都  泮沙鄉
生  於  前  清 戊申 年 十一 月 廿二(日)子   時
終  於  民國  庚申 年     七月    十二 (日)    午    時
先考  諱 羅有  字 容康 王 府 君 之 墓</text>
    </document>
    ...
</gedcomx>
JSON
{
  ..
  "sourceDescriptions" : [ {
    "sources" : [ {
      "description" : "#S-2"
    } ],
    "resourceType" : "http://gedcomx.org/DigitalArtifact",
    "citations" : [ {
      "value" : "WONG Aloiau gravestone (transcription), Lin Yee Chung Cemetery, Honolulu, Oahu, Hawaii; visited May 1975 by Jane Doe."
    } ],
    "about" : "#D-1",
    "titles" : [ {
      "value" : "Transcription of Grave Marker of WONG Aloiau, Lin Yee Chung Cemetery, Honolulu, Oahu, Hawaii"
    } ],
    "id" : "S-3"
  }, ... ],
  ...
  "documents" : [ {
    "text" : "WONG ALOIAU\nNOV. 22, 1848 – AUG. 3, 1920\n中山  大字都  泮沙鄉\n生  於  前  清 戊申 年 十一 月 廿二(日)子   時\n終  於  民國  庚申 年     七月    十二 (日)    午    時\n先考  諱 羅有  字 容康 王 府 君 之 墓",
    "sources" : [ {
      "description" : "#S-2"
    } ],
    "lang" : "zh",
    "id" : "D-1"
  }, ... ]
}

The Translation

The translation of the transcription is provided as a Document in the root document. The translation is attributed to another Agent, and is described as a source using a SourceDescription. The following snippet demonstrates how the translation, its attribution, and its description are represented in both XML and JSON. Note that the transcription is cited as a source.

XML
<gedcomx xmlns="http://gedcomx.org/v1/">
    ...
    <sourceDescription about="#D-2" resourceType="http://gedcomx.org/DigitalArtifact" id="S-4">
        <citation>
            <value>WONG Aloiau gravestone, Lin Yee Chung Cemetery, Honolulu, Oahu, Hawaii; visited May 1975 by Jane Doe. Translation by HANYU Pinyin 王大年.</value>
        </citation>
        <source description="#S-3"/>
        <title>Translation of Grave Marker of WONG Aloiau, Lin Yee Chung Cemetery, Honolulu, Oahu, Hawaii</title>
        <attribution>
            <contributor resource="#A-3"/>
            <modified>2014-04-04T00:00:00-06:00</modified>
        </attribution>
    </sourceDescription>
    ...
    <agent id="A-3">
        <email resource="mailto:example@example.org"/>
        <name>HANYU Pinyin 王大年</name>
    </agent>
    ...
    <document id="D-2">
        <source description="#S-3"/>
        <text>WONG ALOIAU
NOV. 22, 1848 – AUG. 3, 1920 [lunar dates]
[Birthplace] [China, Guandong, ]Chung Shan, See Dai Doo, Pun Sha village
[Date of birth] Born at former Qing 1848 year 11th month 22nd day 23-1 hour.
[Life] ended at Republic of China year 1920 year 7th mo. 12th day 11-13 hour.
Deceased father avoid [mention of] Lo Yau also known as Young Hong Wong [noble]residence ruler’s grave.</text>
    </document>
    ...
</gedcomx>
JSON
{
  ...
  "sourceDescriptions" : [ {
    "sources" : [ {
      "description" : "#S-3"
    } ],
    "resourceType" : "http://gedcomx.org/DigitalArtifact",
    "citations" : [ {
      "value" : "WONG Aloiau gravestone, Lin Yee Chung Cemetery, Honolulu, Oahu, Hawaii; visited May 1975 by Jane Doe. Translation by HANYU Pinyin 王大年."
    } ],
    "about" : "#D-2",
    "titles" : [ {
      "value" : "Translation of Grave Marker of WONG Aloiau, Lin Yee Chung Cemetery, Honolulu, Oahu, Hawaii"
    } ],
    "attribution" : {
      "contributor" : {
        "resource" : "#A-3"
      },
      "modified" : 1395900000000
    },
    "id" : "S-4"
  } ],
  ...
  "agents" : [ {
    "names" : [ {
      "value" : "HANYU Pinyin 王大年"
    } ],
    "emails" : [ {
      "resource" : "mailto:example@example.org"
    } ],
    "id" : "A-3"
  }, ... ],
  ...
  "documents" : [ {
    "text" : "WONG ALOIAU\nNOV. 22, 1848 – AUG. 3, 1920 [lunar dates]\n[Birthplace] [China, Guandong, ]Chung Shan, See Dai Doo, Pun Sha village\n[Date of birth] Born at former Qing 1848 year 11th month 22nd day 23-1 hour.\n[Life] ended at Republic of China year 1920 year 7th mo. 12th day 11-13 hour.\nDeceased father avoid [mention of] Lo Yau also known as Young Hong Wong [noble]residence ruler’s grave.",
    "sources" : [ {
      "description" : "#S-3"
    } ],
    "id" : "D-2"
  }, ... ]
}

The Extracted Information

The information that is extracted from the source is represented as persons and relationships. An instance of the Person data type provides person information and an instance of the Relationship data type provides relationship information.

The following snippet demonstrates how the extracted information is represented in both XML and JSON. Each person is designated as extracted because the information was extracted from a single source. Each person includes a name, an id, and a reference to the translation as a source. The birth, death, and burial information is included on the principal person.

XML
<gedcomx xmlns="http://gedcomx.org/v1/">
    ...
    <person extracted="true" id="P-1">
        <source description="#S-4"/>
        <gender type="http://gedcomx.org/Male"/>
        <name>
            <nameForm>
                <fullText>WONG Aloiau</fullText>
            </nameForm>
        </name>
        <fact type="http://gedcomx.org/Birth">
            <date>
                <original>former Qing 1848 year 11th month 22nd day 23-1 hour</original>
                <formal>+1848-11-22</formal>
            </date>
            <place>
                <original>Pun Sha Village, See Dai Doo, Chung Shan, Guangdong, China</original>
            </place>
        </fact>
        <fact type="http://gedcomx.org/Death">
            <date>
                <original>Republic of China year 1920 year 7th mo. 12th day 11-13 hour</original>
                <formal>+1920-08-03</formal>
            </date>
        </fact>
        <fact type="http://gedcomx.org/Burial">
            <place>
                <original>Lin Yee Chung Cemetery, Honolulu, Oahu, Hawaii</original>
            </place>
        </fact>
    </person>
    <person extracted="true" id="P-2">
        <source description="#S-4"/>
        <name>
            <nameForm>
                <fullText>Lo Yau</fullText>
            </nameForm>
        </name>
        <name type="http://gedcomx.org/AlsoKnownAs">
            <nameForm>
                <fullText>Young Hong Wong</fullText>
            </nameForm>
        </name>
    </person>
    ...
    <relationship type="http://gedcomx.org/ParentChild">
        <person1 resource="#P-2"/>
        <person2 resource="#P-1"/>
    </relationship>
    ...
</gedcomx>
JSON
{
  ...
  "persons" : [ {
    "names" : [ {
      "nameForms" : [ {
        "fullText" : "WONG Aloiau"
      } ]
    } ],
    "gender" : {
      "type" : "http://gedcomx.org/Male"
    },
    "facts" : [ {
      "type" : "http://gedcomx.org/Birth",
      "date" : {
        "original" : "former Qing 1848 year 11th month 22nd day 23-1 hour",
        "formal" : "+1848-11-22"
      },
      "place" : {
        "original" : "Pun Sha Village, See Dai Doo, Chung Shan, Guangdong, China"
      }
    }, {
      "type" : "http://gedcomx.org/Death",
      "date" : {
        "original" : "Republic of China year 1920 year 7th mo. 12th day 11-13 hour",
        "formal" : "+1920-08-03"
      }
    }, {
      "type" : "http://gedcomx.org/Burial",
      "place" : {
        "original" : "Lin Yee Chung Cemetery, Honolulu, Oahu, Hawaii"
      }
    } ],
    "extracted" : true,
    "sources" : [ {
      "description" : "#S-4"
    } ],
    "id" : "P-1"
  }, {
    "names" : [ {
      "nameForms" : [ {
        "fullText" : "Lo Yau"
      } ]
    }, {
      "type" : "http://gedcomx.org/AlsoKnownAs",
      "nameForms" : [ {
        "fullText" : "Young Hong Wong"
      } ]
    } ],
    "extracted" : true,
    "sources" : [ {
      "description" : "#S-4"
    } ],
    "id" : "P-2"
  }, ... ],
  "relationships" : [ {
    "type" : "http://gedcomx.org/ParentChild",
    "person1" : {
      "resource" : "#P-2"
    },
    "person2" : {
      "resource" : "#P-1"
    }
  } ],
  ...
}

The Analysis

Following good research process practices, the researcher writes up a document that describes her analysis of the information about WONG Aloiau that was discovered. Presumably, other sources in addition to the gravestone were located and their analysis would be included in the document.

The aggregated analysis, including the text of the document, is represented with another Person that references the extracted information as evidence using instances of EvidenceReference. The following snippet demonstrates how the analysis is represented in both XML and JSON.

XML
<gedcomx xmlns="http://gedcomx.org/v1/">
    ...
    <person id="C-1">
        <analysis resource="#D-3"/>
        <evidence resource="#P-1"/>
        ...
    </person>
    ...
    <document id="D-3">
        <text>...Jane Doe's analysis document...</text>
    </document>
</gedcomx>
JSON
{
  ...
  "persons" : [ {
    "evidence" : [ {
      "resource" : "#P-1"
    } ],
    "analysis" : {
      "resource" : "#D-3"
    },
    "id" : "C-1"
  }, ... ],
  ...
  "documents" : [ {
    "text" : "...Jane Doe's analysis document...",
    "id" : "D-3"
  }, ... ]
}

The Result

Here are the XML and JSON representations of the use case described above.

XML
<gedcomx xmlns="http://gedcomx.org/v1/">
    <attribution>
        <contributor resource="#A-1"/>
        <modified>2014-04-04T00:00:00-06:00</modified>
    </attribution>
    <person extracted="true" id="P-1">
        <source description="#S-4"/>
        <gender type="http://gedcomx.org/Male"/>
        <name>
            <nameForm>
                <fullText>WONG Aloiau</fullText>
            </nameForm>
        </name>
        <fact type="http://gedcomx.org/Birth">
            <date>
                <original>former Qing 1848 year 11th month 22nd day 23-1 hour</original>
                <formal>+1848-11-22</formal>
            </date>
            <place>
                <original>Pun Sha Village, See Dai Doo, Chung Shan, Guangdong, China</original>
            </place>
        </fact>
        <fact type="http://gedcomx.org/Death">
            <date>
                <original>Republic of China year 1920 year 7th mo. 12th day 11-13 hour</original>
                <formal>+1920-08-03</formal>
            </date>
        </fact>
        <fact type="http://gedcomx.org/Burial">
            <place>
                <original>Lin Yee Chung Cemetery, Honolulu, Oahu, Hawaii</original>
            </place>
        </fact>
    </person>
    <person extracted="true" id="P-2">
        <source description="#S-4"/>
        <name>
            <nameForm>
                <fullText>Lo Yau</fullText>
            </nameForm>
        </name>
        <name type="http://gedcomx.org/AlsoKnownAs">
            <nameForm>
                <fullText>Young Hong Wong</fullText>
            </nameForm>
        </name>
    </person>
    <person id="C-1">
        <analysis resource="#D-3"/>
        <evidence resource="#P-1"/>
    </person>
    <relationship type="http://gedcomx.org/ParentChild">
        <person1 resource="#P-2"/>
        <person2 resource="#P-1"/>
    </relationship>
    <sourceDescription resourceType="http://gedcomx.org/PhysicalArtifact" id="S-1">
        <citation>
            <value>WONG Aloiau gravestone, Lin Yee Chung Cemetery, Honolulu, Oahu, Hawaii; visited May 1975 by Jane Doe.</value>
        </citation>
        <title>Grave Marker of WONG Aloiau, Lin Yee Chung Cemetery, Honolulu, Oahu, Hawaii</title>
        <repository resource="#A-2"/>
    </sourceDescription>
    <sourceDescription resourceType="http://gedcomx.org/DigitalArtifact" id="S-2">
        <citation>
            <value>WONG Aloiau gravestone (digital photograph), Lin Yee Chung Cemetery, Honolulu, Oahu, Hawaii; visited May 1975 by Jane Doe.</value>
        </citation>
        <source description="#S-1"/>
        <title>Grave Marker of WONG Aloiau, Lin Yee Chung Cemetery, Honolulu, Oahu, Hawaii</title>
    </sourceDescription>
    <sourceDescription about="#D-1" resourceType="http://gedcomx.org/DigitalArtifact" id="S-3">
        <citation>
            <value>WONG Aloiau gravestone (transcription), Lin Yee Chung Cemetery, Honolulu, Oahu, Hawaii; visited May 1975 by Jane Doe.</value>
        </citation>
        <source description="#S-2"/>
        <title>Transcription of Grave Marker of WONG Aloiau, Lin Yee Chung Cemetery, Honolulu, Oahu, Hawaii</title>
    </sourceDescription>
    <sourceDescription about="#D-2" resourceType="http://gedcomx.org/DigitalArtifact" id="S-4">
        <citation>
            <value>WONG Aloiau gravestone, Lin Yee Chung Cemetery, Honolulu, Oahu, Hawaii; visited May 1975 by Jane Doe. Translation by HANYU Pinyin 王大年.</value>
        </citation>
        <source description="#S-3"/>
        <title>Translation of Grave Marker of WONG Aloiau, Lin Yee Chung Cemetery, Honolulu, Oahu, Hawaii</title>
        <attribution>
            <contributor resource="#A-3"/>
            <modified>2014-04-04T00:00:00-06:00</modified>
        </attribution>
    </sourceDescription>
    <agent id="A-1">
        <email resource="mailto:example@example.org"/>
        <name>Jane Doe</name>
    </agent>
    <agent id="A-3">
        <email resource="mailto:example@example.org"/>
        <name>HANYU Pinyin 王大年</name>
    </agent>
    <agent id="A-2">
        <address>
            <city>Honolulu</city>
            <stateOrProvince>Hawaii</stateOrProvince>
        </address>
        <name>Lin Yee Chung Cemetery</name>
    </agent>
    <document xml:lang="zh" id="D-1">
        <source description="#S-2"/>
        <text>WONG ALOIAU
NOV. 22, 1848 – AUG. 3, 1920
中山  大字都  泮沙鄉
生  於  前  清 戊申 年 十一 月 廿二(日)子   時
終  於  民國  庚申 年     七月    十二 (日)    午    時
先考  諱 羅有  字 容康 王 府 君 之 墓</text>
    </document>
    <document id="D-2">
        <source description="#S-3"/>
        <text>WONG ALOIAU
NOV. 22, 1848 – AUG. 3, 1920 [lunar dates]
[Birthplace] [China, Guandong, ]Chung Shan, See Dai Doo, Pun Sha village
[Date of birth] Born at former Qing 1848 year 11th month 22nd day 23-1 hour.
[Life] ended at Republic of China year 1920 year 7th mo. 12th day 11-13 hour.
Deceased father avoid [mention of] Lo Yau also known as Young Hong Wong [noble]residence ruler’s grave.</text>
    </document>
    <document id="D-3">
        <text>...Jane Doe's analysis document...</text>
    </document>
</gedcomx>
JSON
{
  "attribution" : {
    "contributor" : {
      "resource" : "#A-1"
    },
    "modified" : 1395900000000
  },
  "persons" : [ {
    "names" : [ {
      "nameForms" : [ {
        "fullText" : "WONG Aloiau"
      } ]
    } ],
    "gender" : {
      "type" : "http://gedcomx.org/Male"
    },
    "facts" : [ {
      "type" : "http://gedcomx.org/Birth",
      "date" : {
        "original" : "former Qing 1848 year 11th month 22nd day 23-1 hour",
        "formal" : "+1848-11-22"
      },
      "place" : {
        "original" : "Pun Sha Village, See Dai Doo, Chung Shan, Guangdong, China"
      }
    }, {
      "type" : "http://gedcomx.org/Death",
      "date" : {
        "original" : "Republic of China year 1920 year 7th mo. 12th day 11-13 hour",
        "formal" : "+1920-08-03"
      }
    }, {
      "type" : "http://gedcomx.org/Burial",
      "place" : {
        "original" : "Lin Yee Chung Cemetery, Honolulu, Oahu, Hawaii"
      }
    } ],
    "extracted" : true,
    "sources" : [ {
      "description" : "#S-4"
    } ],
    "id" : "P-1"
  }, {
    "names" : [ {
      "nameForms" : [ {
        "fullText" : "Lo Yau"
      } ]
    }, {
      "type" : "http://gedcomx.org/AlsoKnownAs",
      "nameForms" : [ {
        "fullText" : "Young Hong Wong"
      } ]
    } ],
    "extracted" : true,
    "sources" : [ {
      "description" : "#S-4"
    } ],
    "id" : "P-2"
  }, {
    "evidence" : [ {
      "resource" : "#P-1"
    } ],
    "analysis" : {
      "resource" : "#D-3"
    },
    "id" : "C-1"
  } ],
  "relationships" : [ {
    "type" : "http://gedcomx.org/ParentChild",
    "person1" : {
      "resource" : "#P-2"
    },
    "person2" : {
      "resource" : "#P-1"
    }
  } ],
  "sourceDescriptions" : [ {
    "resourceType" : "http://gedcomx.org/PhysicalArtifact",
    "citations" : [ {
      "value" : "WONG Aloiau gravestone, Lin Yee Chung Cemetery, Honolulu, Oahu, Hawaii; visited May 1975 by Jane Doe."
    } ],
    "titles" : [ {
      "value" : "Grave Marker of WONG Aloiau, Lin Yee Chung Cemetery, Honolulu, Oahu, Hawaii"
    } ],
    "repository" : {
      "resource" : "#A-2"
    },
    "id" : "S-1"
  }, {
    "sources" : [ {
      "description" : "#S-1"
    } ],
    "resourceType" : "http://gedcomx.org/DigitalArtifact",
    "citations" : [ {
      "value" : "WONG Aloiau gravestone (digital photograph), Lin Yee Chung Cemetery, Honolulu, Oahu, Hawaii; visited May 1975 by Jane Doe."
    } ],
    "titles" : [ {
      "value" : "Grave Marker of WONG Aloiau, Lin Yee Chung Cemetery, Honolulu, Oahu, Hawaii"
    } ],
    "id" : "S-2"
  }, {
    "sources" : [ {
      "description" : "#S-2"
    } ],
    "resourceType" : "http://gedcomx.org/DigitalArtifact",
    "citations" : [ {
      "value" : "WONG Aloiau gravestone (transcription), Lin Yee Chung Cemetery, Honolulu, Oahu, Hawaii; visited May 1975 by Jane Doe."
    } ],
    "about" : "#D-1",
    "titles" : [ {
      "value" : "Transcription of Grave Marker of WONG Aloiau, Lin Yee Chung Cemetery, Honolulu, Oahu, Hawaii"
    } ],
    "id" : "S-3"
  }, {
    "sources" : [ {
      "description" : "#S-3"
    } ],
    "resourceType" : "http://gedcomx.org/DigitalArtifact",
    "citations" : [ {
      "value" : "WONG Aloiau gravestone, Lin Yee Chung Cemetery, Honolulu, Oahu, Hawaii; visited May 1975 by Jane Doe. Translation by HANYU Pinyin 王大年."
    } ],
    "about" : "#D-2",
    "titles" : [ {
      "value" : "Translation of Grave Marker of WONG Aloiau, Lin Yee Chung Cemetery, Honolulu, Oahu, Hawaii"
    } ],
    "attribution" : {
      "contributor" : {
        "resource" : "#A-3"
      },
      "modified" : 1395900000000
    },
    "id" : "S-4"
  } ],
  "agents" : [ {
    "names" : [ {
      "value" : "Jane Doe"
    } ],
    "emails" : [ {
      "resource" : "mailto:example@example.org"
    } ],
    "id" : "A-1"
  }, {
    "names" : [ {
      "value" : "HANYU Pinyin 王大年"
    } ],
    "emails" : [ {
      "resource" : "mailto:example@example.org"
    } ],
    "id" : "A-3"
  }, {
    "names" : [ {
      "value" : "Lin Yee Chung Cemetery"
    } ],
    "addresses" : [ {
      "city" : "Honolulu",
      "stateOrProvince" : "Hawaii"
    } ],
    "id" : "A-2"
  } ],
  "documents" : [ {
    "text" : "WONG ALOIAU\nNOV. 22, 1848 – AUG. 3, 1920\n中山  大字都  泮沙鄉\n生  於  前  清 戊申 年 十一 月 廿二(日)子   時\n終  於  民國  庚申 年     七月    十二 (日)    午    時\n先考  諱 羅有  字 容康 王 府 君 之 墓",
    "sources" : [ {
      "description" : "#S-2"
    } ],
    "lang" : "zh",
    "id" : "D-1"
  }, {
    "text" : "WONG ALOIAU\nNOV. 22, 1848 – AUG. 3, 1920 [lunar dates]\n[Birthplace] [China, Guandong, ]Chung Shan, See Dai Doo, Pun Sha village\n[Date of birth] Born at former Qing 1848 year 11th month 22nd day 23-1 hour.\n[Life] ended at Republic of China year 1920 year 7th mo. 12th day 11-13 hour.\nDeceased father avoid [mention of] Lo Yau also known as Young Hong Wong [noble]residence ruler’s grave.",
    "sources" : [ {
      "description" : "#S-3"
    } ],
    "id" : "D-2"
  }, {
    "text" : "...Jane Doe's analysis document...",
    "id" : "D-3"
  } ]
}

Code Examples

This Java code example, found in gedcomx-java repository demonstrates how to produce the above result.

Extra Credit

Here are some other elements that a GEDCOM X processor may want to provide. These items were left out of the above example for the sake of brevity.

  • Multiple values for different languages may be provided for the title and citation of a source. In such a case, the “lang” property on each title and citation may be used to specify the language of the text using BCP 47. For more information, see the section about Internationalization Considerations. See also the Source Description data type and its associated representations in XML and JSON.
  • In addition to the name of the repository, other information about the repository may be provided, such as address, web page, e-mail, phone number, etc. For more information, see the Agent data type and its associated representations in XML and JSON.
  • In addition to an analysis document for the researcher’s conclusions about WONG Aloiau, a researcher may also want to provide a document containing an analysis of the grave stone itself. For such purposes, the Source Description data type provides an analysis property that can resolve to an analysis document.
  • When providing a name of a person, the software may wish to prompt the user for the parts of a name in addition to (or instead of) the full text of the name. In such a case, the parts can be provided using the parts property of the Name data type.
  • When providing information about a place, the software may be able to prompt the user for specifics about the place, such as it’s jurisdictions, geo-coordinates, name variants, etc. In such a case, an instance of a Place Description can be provided in the document, which can be referenced using the descriptionRef property of the Place Reference data type.
  • When writing an analysis document, some software may allow the researcher to apply fonts, formatting and styles. In such a case, the text of the document can specify a textType property with the value of “xhtml”.