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:
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 |
|
||||||||||||||||
| 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
analysisproperty 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
partsproperty 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
descriptionRefproperty 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
textTypeproperty with the value of “xhtml”.