This post is part of an initiative to improve the available documentation of GEDCOM X. This particular post describes how marriage-like information found during a research activity might be represented using GEDCOM X. This post is also available at gedcomx.org, where you will find a link to propose edits or updates.
Summary
During research for Samuel Ham of Honiton, Devon, England a researcher visits the Family History Library at Salt Lake City, Utah to view a published parish register from Wilton, Somerset, England. The parish register provides information about the marriage of one Samuel Ham to one Elizabeth Spiller in 1828. The source is described by providing a title, citation, and other metadata. A transcription of the record is provided. Information about the names of the persons and the marriage is extracted from the record. The extracted information is assembled together with information extracted from other records to aggregate what is presumed to be known about Samuel Ham.
Gathering the Information
A researcher visits the Family History Library at Salt Lake City, Utah and takes a finds a copy of a parish register from Wilton, Somerset, England. The following is a digital image of the record:
Describing the Source
The source is described with the following information:
| name | value | provided by |
|---|---|---|
| Source Title | Marriage entry for Samuel Ham and Elizabeth Spiller, Parish Register, Wilton, Somerset, England | User |
| Text Description of Source | Marriage entry for Samuel Ham and Elizabeth in a copy of the registers of the baptisms, marriages, and burials at the church of St. George in the parish of Wilton : adjoining Taunton, in the county of Somerset from A.D. 1558 to A.D. 1837. | User |
| Source Citation | Joseph Houghton Spencer, transcriber, Church of England, Parish Church of Wilton (Somerset). A copy of the registers of the baptisms, marriages, and burials at the church of St. George in the parish of Wilton : adjoining Taunton, in the county of Somerset from A.D. 1558 to A.D. 1837; Marriage entry for Samuel Ham and Elizabeth Spiller (3 November 1828), (Taunton: Barnicott, 1890), p. 224, No. 86. | User, possibly aided by software. |
| Repository Name | Family History Library, Salt Lake City | User |
| Source Type | Physical Artifact | User |
| Source Id | S-1 | Software |
Transcribing the Source
The record is transcribed as follows:
Samuel Ham of the parish of Honiton and Elizabeth Spiller were married this 3rd day of November 1828 by David Smith Stone, Pl Curate, In the Presence of Jno Pain. R.G. Halls. Peggy Hammet. No. 86.
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 marriage entry for Samuel Ham and Elizabeth Spiller, Parish Register, Wilton, Somerset, England | User |
| Text Description of Source | Transcription of marriage entry for Samuel Ham and Elizabeth in a copy of the registers of the baptisms, marriages, and burials at the church of St. George in the parish of Wilton : adjoining Taunton, in the county of Somerset from A.D. 1558 to A.D. 1837. | User |
| Source Citation | Joseph Houghton Spencer, transcriber, Church of England, Parish Church of Wilton (Somerset). A copy of the registers of the baptisms, marriages, and burials at the church of St. George in the parish of Wilton : adjoining Taunton, in the county of Somerset from A.D. 1558 to A.D. 1837; Marriage entry for Samuel Ham and Elizabeth Spiller (3 November 1828), (Taunton: Barnicott, 1890), p. 224, No. 86. | User, possibly aided by software. |
| Source Type | Digital Artifact | User |
| ID of Source of the Source | S-1 | User, possibly aided by software. |
| Source Id | S-2 | Software |
Extracting the Information
The researcher extracts the following information from the translation:
| description | value |
|---|---|
| Event Type | Marriage |
| Event Date | 3 November 1828 |
| Event Place | Wilton St George, Wilton, Somerset, England |
| Groom’s Name | Samuel Ham |
| Groom’s Residence | parish of Honiton, Devon, England |
| Groom's Gender | Male |
| Bride’s Name | Elizabeth Spiller |
| Bride’s Residence | parish of Wilton, Somerset, England |
| Bride's Gender | Female |
| Witness’s Name | Jno. Pain |
| Witness’s Name | R.G. Halls |
| Witness’s Name | Peggy Hammet |
| Officiator’s Name | David Smith Stone |
Analyzing the Information
The researcher analyzes the record within the context of the other records of Samuel Ham she has found. She writes an analysis document that details her conclusions of the identity of Samuel Ham.
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-25T00: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" : 1398405600000
},
...
"agents" : [ {
"names" : [ {
"value" : "Jane Doe"
} ],
"emails" : [ {
"resource" : "mailto:example@example.org"
} ],
"id" : "A-1"
}, ... ],
...
}
The Record
The record is described by providing an instance of the
SourceDescription
data type in the root document. The following snippet demonstrates how the source is described in both XML and JSON. The source
description includes a title, a citation, and a reference to the Family History Library, which is represented using an
Agent.
XML
<gedcomx xmlns="http://gedcomx.org/v1/">
...
<sourceDescription resourceType="http://gedcomx.org/PhysicalArtifact" id="S-1">
<citation>
<value>Joseph Houghton Spencer, transcriber, Church of England, Parish Church of Wilton (Somerset). <cite>A copy of the registers of the baptisms, marriages, and burials at the church of St. George in the parish of Wilton : adjoining Taunton, in the county of Somerset from A.D. 1558 to A.D. 1837</cite>; Marriage entry for Samuel Ham and Elizabeth Spiller (3 November 1828), (Taunton: Barnicott, 1890), p. 224, No. 86.</value>
</citation>
<title>Marriage entry for Samuel Ham and Elizabeth Spiller, Parish Register, Wilton, Somerset, England</title>
<description>Marriage entry for Samuel Ham and Elizabeth in a copy of the registers of the baptisms, marriages, and burials at the church of St. George in the parish of Wilton : adjoining Taunton, in the county of Somerset from A.D. 1558 to A.D. 1837.</description>
<repository resource="#A-2"/>
</sourceDescription>
...
<agent id="A-2">
<address>
<city>Salt Lake City</city>
<stateOrProvince>Utah</stateOrProvince>
</address>
<name>Family History Library</name>
</agent>
...
</gedcomx>
JSON
{
...
"sourceDescriptions" : [ {
"description" : [ {
"value" : "Marriage entry for Samuel Ham and Elizabeth in a copy of the registers of the baptisms, marriages, and burials at the church of St. George in the parish of Wilton : adjoining Taunton, in the county of Somerset from A.D. 1558 to A.D. 1837."
} ],
"resourceType" : "http://gedcomx.org/PhysicalArtifact",
"citations" : [ {
"value" : "Joseph Houghton Spencer, transcriber, Church of England, Parish Church of Wilton (Somerset). A copy of the registers of the baptisms, marriages, and burials at the church of St. George in the parish of Wilton : adjoining Taunton, in the county of Somerset from A.D. 1558 to A.D. 1837; Marriage entry for Samuel Ham and Elizabeth Spiller (3 November 1828), (Taunton: Barnicott, 1890), p. 224, No. 86."
} ],
"titles" : [ {
"value" : "Marriage entry for Samuel Ham and Elizabeth Spiller, Parish Register, Wilton, Somerset, England"
} ],
"repository" : {
"resource" : "#A-2"
},
"id" : "S-1"
}, ... ],
"agents" : [ ..., {
"names" : [ {
"value" : "Family History Library"
} ],
"addresses" : [ {
"city" : "Salt Lake City",
"stateOrProvince" : "Utah"
} ],
"id" : "A-2"
} ],
...
}
The Transcription
The transcription of the record is provided as an instance of the
Document
data type in the root document. The language of the document is described as English, using the “en” 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 record is cited as a source.
XML
<gedcomx xmlns="http://gedcomx.org/v1/">
...
<sourceDescription about="#D-1" resourceType="http://gedcomx.org/DigitalArtifact" id="S-2">
<citation>
<value>Joseph Houghton Spencer, transcriber, Church of England, Parish Church of Wilton (Somerset). <cite>A copy of the registers of the baptisms, marriages, and burials at the church of St. George in the parish of Wilton : adjoining Taunton, in the county of Somerset from A.D. 1558 to A.D. 1837</cite>; Marriage entry for Samuel Ham and Elizabeth Spiller (3 November 1828), (Taunton: Barnicott, 1890), p. 224, No. 86.</value>
</citation>
<source description="#S-1"/>
<title>Transcription of marriage entry for Samuel Ham and Elizabeth Spiller, Parish Register, Wilton, Somerset, England</title>
<description>Transcription of marriage entry for Samuel Ham and Elizabeth in a copy of the registers of the baptisms, marriages, and burials at the church of St. George in the parish of Wilton : adjoining Taunton, in the county of Somerset from A.D. 1558 to A.D. 1837.</description>
</sourceDescription>
...
<document type="http://gedcomx.org/Transcription" xml:lang="en" id="D-1">
<source description="#S-1"/>
<text>Samuel Ham of the parish of Honiton and Elizabeth Spiller
were married this 3rd day of November 1828 by David Smith
Stone, Pl Curate,
In the Presence of
Jno Pain.
R.G. Halls. Peggy Hammet.
No. 86.</text>
</document>
...
</gedcomx>
JSON
{
...
"sourceDescriptions" : [ ..., {
"description" : [ {
"value" : "Transcription of marriage entry for Samuel Ham and Elizabeth in a copy of the registers of the baptisms, marriages, and burials at the church of St. George in the parish of Wilton : adjoining Taunton, in the county of Somerset from A.D. 1558 to A.D. 1837."
} ],
"sources" : [ {
"description" : "#S-1"
} ],
"resourceType" : "http://gedcomx.org/DigitalArtifact",
"citations" : [ {
"value" : "Joseph Houghton Spencer, transcriber, Church of England, Parish Church of Wilton (Somerset). A copy of the registers of the baptisms, marriages, and burials at the church of St. George in the parish of Wilton : adjoining Taunton, in the county of Somerset from A.D. 1558 to A.D. 1837; Marriage entry for Samuel Ham and Elizabeth Spiller (3 November 1828), (Taunton: Barnicott, 1890), p. 224, No. 86."
} ],
"about" : "#D-1",
"titles" : [ {
"value" : "Transcription of marriage entry for Samuel Ham and Elizabeth Spiller, Parish Register, Wilton, Somerset, England"
} ],
"id" : "S-2"
} ],
...
"documents" : [ {
"type" : "http://gedcomx.org/Transcription",
"text" : "Samuel Ham of the parish of Honiton and Elizabeth Spiller\nwere married this 3rd day of November 1828 by David Smith\nStone, Pl Curate,\nIn the Presence of\nJno Pain.\nR.G. Halls. Peggy Hammet.\nNo. 86.",
"sources" : [ {
"description" : "#S-1"
} ],
"lang" : "en",
"id" : "D-1"
}, ... ]
}
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.
An instance of Event
is also provided in order to associate the witnesses and officiator of the event to the bride and groom.
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 marriage information is included on the relationship, which also cites the translation as a source. An event
is provided with references to each person as instances of
EventRole. The
EventRole also specifies a type, which specifies the type of role the person played in the event.
XML
<gedcomx xmlns="http://gedcomx.org/v1/">
...
<person extracted="true" id="P-1">
<source description="#S-2"/>
<gender type="http://gedcomx.org/Male"/>
<name>
<nameForm>
<fullText>Samuel Ham</fullText>
</nameForm>
</name>
<fact type="http://gedcomx.org/Residence">
<date>
<original>3 November 1828</original>
<formal>+1828-11-03</formal>
</date>
<place>
<original>parish of Honiton, Devon, England</original>
</place>
</fact>
</person>
<person extracted="true" id="P-2">
<source description="#S-2"/>
<gender type="http://gedcomx.org/Female"/>
<name>
<nameForm>
<fullText>Elizabeth Spiller</fullText>
</nameForm>
</name>
<fact type="http://gedcomx.org/Residence">
<date>
<original>3 November 1828</original>
<formal>+1828-11-03</formal>
</date>
<place>
<original>parish of Wilton, Somerset, England</original>
</place>
</fact>
</person>
<person extracted="true" id="P-3">
<source description="#S-2"/>
<name>
<nameForm>
<fullText>Jno. Pain</fullText>
</nameForm>
</name>
</person>
<person extracted="true" id="P-4">
<source description="#S-2"/>
<name>
<nameForm>
<fullText>R.G. Halls</fullText>
</nameForm>
</name>
</person>
<person extracted="true" id="P-5">
<source description="#S-2"/>
<name>
<nameForm>
<fullText>Peggy Hammet</fullText>
</nameForm>
</name>
</person>
<person extracted="true" id="P-6">
<source description="#S-2"/>
<name>
<nameForm>
<fullText>David Smith Stone</fullText>
</nameForm>
</name>
</person>
...
<relationship extracted="true" type="http://gedcomx.org/Couple">
<person1 resource="#P-1"/>
<person2 resource="#P-2"/>
<fact type="http://gedcomx.org/Marriage">
<date>
<original>3 November 1828</original>
<formal>+1828-11-03</formal>
</date>
<place>
<original>Wilton St George, Wilton, Somerset, England</original>
</place>
</fact>
</relationship>
...
<event type="http://gedcomx.org/Marriage" extracted="true" id="E-1">
<date>
<original>3 November 1828</original>
<formal>+1828-11-03</formal>
</date>
<place>
<original>Wilton St George, Wilton, Somerset, England</original>
</place>
<role type="http://gedcomx.org/Principal">
<person resource="#P-1"/>
</role>
<role type="http://gedcomx.org/Principal">
<person resource="#P-2"/>
</role>
<role type="http://gedcomx.org/Witness">
<person resource="#P-3"/>
</role>
<role type="http://gedcomx.org/Witness">
<person resource="#P-4"/>
</role>
<role type="http://gedcomx.org/Witness">
<person resource="#P-5"/>
</role>
<role type="http://gedcomx.org/Official">
<person resource="#P-6"/>
</role>
</event>
...
</gedcomx>
JSON
{
...
"persons" : [ {
"names" : [ {
"nameForms" : [ {
"fullText" : "Samuel Ham"
} ]
} ],
"gender" : {
"type" : "http://gedcomx.org/Male"
},
"facts" : [ {
"type" : "http://gedcomx.org/Residence",
"date" : {
"original" : "3 November 1828",
"formal" : "+1828-11-03"
},
"place" : {
"original" : "parish of Honiton, Devon, England"
}
} ],
"extracted" : true,
"sources" : [ {
"description" : "#S-2"
} ],
"id" : "P-1"
}, {
"names" : [ {
"nameForms" : [ {
"fullText" : "Elizabeth Spiller"
} ]
} ],
"gender" : {
"type" : "http://gedcomx.org/Female"
},
"facts" : [ {
"type" : "http://gedcomx.org/Residence",
"date" : {
"original" : "3 November 1828",
"formal" : "+1828-11-03"
},
"place" : {
"original" : "parish of Wilton, Somerset, England"
}
} ],
"extracted" : true,
"sources" : [ {
"description" : "#S-2"
} ],
"id" : "P-2"
}, {
"names" : [ {
"nameForms" : [ {
"fullText" : "Jno. Pain"
} ]
} ],
"extracted" : true,
"sources" : [ {
"description" : "#S-2"
} ],
"id" : "P-3"
}, {
"names" : [ {
"nameForms" : [ {
"fullText" : "R.G. Halls"
} ]
} ],
"extracted" : true,
"sources" : [ {
"description" : "#S-2"
} ],
"id" : "P-4"
}, {
"names" : [ {
"nameForms" : [ {
"fullText" : "Peggy Hammet"
} ]
} ],
"extracted" : true,
"sources" : [ {
"description" : "#S-2"
} ],
"id" : "P-5"
}, {
"names" : [ {
"nameForms" : [ {
"fullText" : "David Smith Stone"
} ]
} ],
"extracted" : true,
"sources" : [ {
"description" : "#S-2"
} ],
"id" : "P-6"
}, ... ],
"relationships" : [ {
"type" : "http://gedcomx.org/Couple",
"extracted" : true,
"facts" : [ {
"type" : "http://gedcomx.org/Marriage",
"date" : {
"original" : "3 November 1828",
"formal" : "+1828-11-03"
},
"place" : {
"original" : "Wilton St George, Wilton, Somerset, England"
}
} ],
"person1" : {
"resource" : "#P-1"
},
"person2" : {
"resource" : "#P-2"
}
} ],
...
"events" : [ {
"type" : "http://gedcomx.org/Marriage",
"date" : {
"original" : "3 November 1828",
"formal" : "+1828-11-03"
},
"place" : {
"original" : "Wilton St George, Wilton, Somerset, England"
},
"roles" : [ {
"type" : "http://gedcomx.org/Principal",
"person" : {
"resource" : "#P-1"
}
}, {
"type" : "http://gedcomx.org/Principal",
"person" : {
"resource" : "#P-2"
}
}, {
"type" : "http://gedcomx.org/Witness",
"person" : {
"resource" : "#P-3"
}
}, {
"type" : "http://gedcomx.org/Witness",
"person" : {
"resource" : "#P-4"
}
}, {
"type" : "http://gedcomx.org/Witness",
"person" : {
"resource" : "#P-5"
}
}, {
"type" : "http://gedcomx.org/Official",
"person" : {
"resource" : "#P-6"
}
} ],
"extracted" : true,
"id" : "E-1"
} ],
...
}
The Analysis
Following good research process practices, the researcher writes up a document that describes her analysis of the information about Samuel Ham that was discovered. Presumably, other sources in addition to the parish register 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-2"/>
<evidence resource="#P-1"/>
</person>
...
<document id="D-2">
<text>...Jane Doe's analysis document...</text>
</document>
</gedcomx>
JSON
{
...
"persons" : [ ..., {
"evidence" : [ {
"resource" : "#P-1"
} ],
"analysis" : {
"resource" : "#D-2"
},
"id" : "C-1"
} ],
...
"documents" : [ ..., {
"text" : "...Jane Doe's analysis document...",
"id" : "D-2"
} ]
}
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-25T00:00:00-06:00</modified>
</attribution>
<person extracted="true" id="P-1">
<source description="#S-2"/>
<gender type="http://gedcomx.org/Male"/>
<name>
<nameForm>
<fullText>Samuel Ham</fullText>
</nameForm>
</name>
<fact type="http://gedcomx.org/Residence">
<date>
<original>3 November 1828</original>
<formal>+1828-11-03</formal>
</date>
<place>
<original>parish of Honiton, Devon, England</original>
</place>
</fact>
</person>
<person extracted="true" id="P-2">
<source description="#S-2"/>
<gender type="http://gedcomx.org/Female"/>
<name>
<nameForm>
<fullText>Elizabeth Spiller</fullText>
</nameForm>
</name>
<fact type="http://gedcomx.org/Residence">
<date>
<original>3 November 1828</original>
<formal>+1828-11-03</formal>
</date>
<place>
<original>parish of Wilton, Somerset, England</original>
</place>
</fact>
</person>
<person extracted="true" id="P-3">
<source description="#S-2"/>
<name>
<nameForm>
<fullText>Jno. Pain</fullText>
</nameForm>
</name>
</person>
<person extracted="true" id="P-4">
<source description="#S-2"/>
<name>
<nameForm>
<fullText>R.G. Halls</fullText>
</nameForm>
</name>
</person>
<person extracted="true" id="P-5">
<source description="#S-2"/>
<name>
<nameForm>
<fullText>Peggy Hammet</fullText>
</nameForm>
</name>
</person>
<person extracted="true" id="P-6">
<source description="#S-2"/>
<name>
<nameForm>
<fullText>David Smith Stone</fullText>
</nameForm>
</name>
</person>
<person id="C-1">
<analysis resource="#D-2"/>
<evidence resource="#P-1"/>
</person>
<relationship extracted="true" type="http://gedcomx.org/Couple">
<person1 resource="#P-1"/>
<person2 resource="#P-2"/>
<fact type="http://gedcomx.org/Marriage">
<date>
<original>3 November 1828</original>
<formal>+1828-11-03</formal>
</date>
<place>
<original>Wilton St George, Wilton, Somerset, England</original>
</place>
</fact>
</relationship>
<sourceDescription resourceType="http://gedcomx.org/PhysicalArtifact" id="S-1">
<citation>
<value>Joseph Houghton Spencer, transcriber, Church of England, Parish Church of Wilton (Somerset). <cite>A copy of the registers of the baptisms, marriages, and burials at the church of St. George in the parish of Wilton : adjoining Taunton, in the county of Somerset from A.D. 1558 to A.D. 1837</cite>; Marriage entry for Samuel Ham and Elizabeth Spiller (3 November 1828), (Taunton: Barnicott, 1890), p. 224, No. 86.</value>
</citation>
<title>Marriage entry for Samuel Ham and Elizabeth Spiller, Parish Register, Wilton, Somerset, England</title>
<description>Marriage entry for Samuel Ham and Elizabeth in a copy of the registers of the baptisms, marriages, and burials at the church of St. George in the parish of Wilton : adjoining Taunton, in the county of Somerset from A.D. 1558 to A.D. 1837.</description>
<repository resource="#A-2"/>
</sourceDescription>
<sourceDescription about="#D-1" resourceType="http://gedcomx.org/DigitalArtifact" id="S-2">
<citation>
<value>Joseph Houghton Spencer, transcriber, Church of England, Parish Church of Wilton (Somerset). <cite>A copy of the registers of the baptisms, marriages, and burials at the church of St. George in the parish of Wilton : adjoining Taunton, in the county of Somerset from A.D. 1558 to A.D. 1837</cite>; Marriage entry for Samuel Ham and Elizabeth Spiller (3 November 1828), (Taunton: Barnicott, 1890), p. 224, No. 86.</value>
</citation>
<source description="#S-1"/>
<title>Transcription of marriage entry for Samuel Ham and Elizabeth Spiller, Parish Register, Wilton, Somerset, England</title>
<description>Transcription of marriage entry for Samuel Ham and Elizabeth in a copy of the registers of the baptisms, marriages, and burials at the church of St. George in the parish of Wilton : adjoining Taunton, in the county of Somerset from A.D. 1558 to A.D. 1837.</description>
</sourceDescription>
<agent id="A-1">
<email resource="mailto:example@example.org"/>
<name>Jane Doe</name>
</agent>
<agent id="A-2">
<address>
<city>Salt Lake City</city>
<stateOrProvince>Utah</stateOrProvince>
</address>
<name>Family History Library</name>
</agent>
<event type="http://gedcomx.org/Marriage" extracted="true" id="E-1">
<date>
<original>3 November 1828</original>
<formal>+1828-11-03</formal>
</date>
<place>
<original>Wilton St George, Wilton, Somerset, England</original>
</place>
<role type="http://gedcomx.org/Principal">
<person resource="#P-1"/>
</role>
<role type="http://gedcomx.org/Principal">
<person resource="#P-2"/>
</role>
<role type="http://gedcomx.org/Witness">
<person resource="#P-3"/>
</role>
<role type="http://gedcomx.org/Witness">
<person resource="#P-4"/>
</role>
<role type="http://gedcomx.org/Witness">
<person resource="#P-5"/>
</role>
<role type="http://gedcomx.org/Official">
<person resource="#P-6"/>
</role>
</event>
<document type="http://gedcomx.org/Transcription" xml:lang="en" id="D-1">
<source description="#S-1"/>
<text>Samuel Ham of the parish of Honiton and Elizabeth Spiller
were married this 3rd day of November 1828 by David Smith
Stone, Pl Curate,
In the Presence of
Jno Pain.
R.G. Halls. Peggy Hammet.
No. 86.</text>
</document>
<document id="D-2">
<text>...Jane Doe's analysis document...</text>
</document>
</gedcomx>
JSON
{
"attribution" : {
"contributor" : {
"resource" : "#A-1"
},
"modified" : 1398405600000
},
"persons" : [ {
"names" : [ {
"nameForms" : [ {
"fullText" : "Samuel Ham"
} ]
} ],
"gender" : {
"type" : "http://gedcomx.org/Male"
},
"facts" : [ {
"type" : "http://gedcomx.org/Residence",
"date" : {
"original" : "3 November 1828",
"formal" : "+1828-11-03"
},
"place" : {
"original" : "parish of Honiton, Devon, England"
}
} ],
"extracted" : true,
"sources" : [ {
"description" : "#S-2"
} ],
"id" : "P-1"
}, {
"names" : [ {
"nameForms" : [ {
"fullText" : "Elizabeth Spiller"
} ]
} ],
"gender" : {
"type" : "http://gedcomx.org/Female"
},
"facts" : [ {
"type" : "http://gedcomx.org/Residence",
"date" : {
"original" : "3 November 1828",
"formal" : "+1828-11-03"
},
"place" : {
"original" : "parish of Wilton, Somerset, England"
}
} ],
"extracted" : true,
"sources" : [ {
"description" : "#S-2"
} ],
"id" : "P-2"
}, {
"names" : [ {
"nameForms" : [ {
"fullText" : "Jno. Pain"
} ]
} ],
"extracted" : true,
"sources" : [ {
"description" : "#S-2"
} ],
"id" : "P-3"
}, {
"names" : [ {
"nameForms" : [ {
"fullText" : "R.G. Halls"
} ]
} ],
"extracted" : true,
"sources" : [ {
"description" : "#S-2"
} ],
"id" : "P-4"
}, {
"names" : [ {
"nameForms" : [ {
"fullText" : "Peggy Hammet"
} ]
} ],
"extracted" : true,
"sources" : [ {
"description" : "#S-2"
} ],
"id" : "P-5"
}, {
"names" : [ {
"nameForms" : [ {
"fullText" : "David Smith Stone"
} ]
} ],
"extracted" : true,
"sources" : [ {
"description" : "#S-2"
} ],
"id" : "P-6"
}, {
"evidence" : [ {
"resource" : "#P-1"
} ],
"analysis" : {
"resource" : "#D-2"
},
"id" : "C-1"
} ],
"relationships" : [ {
"type" : "http://gedcomx.org/Couple",
"extracted" : true,
"facts" : [ {
"type" : "http://gedcomx.org/Marriage",
"date" : {
"original" : "3 November 1828",
"formal" : "+1828-11-03"
},
"place" : {
"original" : "Wilton St George, Wilton, Somerset, England"
}
} ],
"person1" : {
"resource" : "#P-1"
},
"person2" : {
"resource" : "#P-2"
}
} ],
"sourceDescriptions" : [ {
"description" : [ {
"value" : "Marriage entry for Samuel Ham and Elizabeth in a copy of the registers of the baptisms, marriages, and burials at the church of St. George in the parish of Wilton : adjoining Taunton, in the county of Somerset from A.D. 1558 to A.D. 1837."
} ],
"resourceType" : "http://gedcomx.org/PhysicalArtifact",
"citations" : [ {
"value" : "Joseph Houghton Spencer, transcriber, Church of England, Parish Church of Wilton (Somerset). A copy of the registers of the baptisms, marriages, and burials at the church of St. George in the parish of Wilton : adjoining Taunton, in the county of Somerset from A.D. 1558 to A.D. 1837; Marriage entry for Samuel Ham and Elizabeth Spiller (3 November 1828), (Taunton: Barnicott, 1890), p. 224, No. 86."
} ],
"titles" : [ {
"value" : "Marriage entry for Samuel Ham and Elizabeth Spiller, Parish Register, Wilton, Somerset, England"
} ],
"repository" : {
"resource" : "#A-2"
},
"id" : "S-1"
}, {
"description" : [ {
"value" : "Transcription of marriage entry for Samuel Ham and Elizabeth in a copy of the registers of the baptisms, marriages, and burials at the church of St. George in the parish of Wilton : adjoining Taunton, in the county of Somerset from A.D. 1558 to A.D. 1837."
} ],
"sources" : [ {
"description" : "#S-1"
} ],
"resourceType" : "http://gedcomx.org/DigitalArtifact",
"citations" : [ {
"value" : "Joseph Houghton Spencer, transcriber, Church of England, Parish Church of Wilton (Somerset). A copy of the registers of the baptisms, marriages, and burials at the church of St. George in the parish of Wilton : adjoining Taunton, in the county of Somerset from A.D. 1558 to A.D. 1837; Marriage entry for Samuel Ham and Elizabeth Spiller (3 November 1828), (Taunton: Barnicott, 1890), p. 224, No. 86."
} ],
"about" : "#D-1",
"titles" : [ {
"value" : "Transcription of marriage entry for Samuel Ham and Elizabeth Spiller, Parish Register, Wilton, Somerset, England"
} ],
"id" : "S-2"
} ],
"agents" : [ {
"names" : [ {
"value" : "Jane Doe"
} ],
"emails" : [ {
"resource" : "mailto:example@example.org"
} ],
"id" : "A-1"
}, {
"names" : [ {
"value" : "Family History Library"
} ],
"addresses" : [ {
"city" : "Salt Lake City",
"stateOrProvince" : "Utah"
} ],
"id" : "A-2"
} ],
"events" : [ {
"type" : "http://gedcomx.org/Marriage",
"date" : {
"original" : "3 November 1828",
"formal" : "+1828-11-03"
},
"place" : {
"original" : "Wilton St George, Wilton, Somerset, England"
},
"roles" : [ {
"type" : "http://gedcomx.org/Principal",
"person" : {
"resource" : "#P-1"
}
}, {
"type" : "http://gedcomx.org/Principal",
"person" : {
"resource" : "#P-2"
}
}, {
"type" : "http://gedcomx.org/Witness",
"person" : {
"resource" : "#P-3"
}
}, {
"type" : "http://gedcomx.org/Witness",
"person" : {
"resource" : "#P-4"
}
}, {
"type" : "http://gedcomx.org/Witness",
"person" : {
"resource" : "#P-5"
}
}, {
"type" : "http://gedcomx.org/Official",
"person" : {
"resource" : "#P-6"
}
} ],
"extracted" : true,
"id" : "E-1"
} ],
"documents" : [ {
"type" : "http://gedcomx.org/Transcription",
"text" : "Samuel Ham of the parish of Honiton and Elizabeth Spiller\nwere married this 3rd day of November 1828 by David Smith\nStone, Pl Curate,\nIn the Presence of\nJno Pain.\nR.G. Halls. Peggy Hammet.\nNo. 86.",
"sources" : [ {
"description" : "#S-1"
} ],
"lang" : "en",
"id" : "D-1"
}, {
"text" : "...Jane Doe's analysis document...",
"id" : "D-2"
} ]
}
Code Examples
This Java code example,
found in the 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 Samuel Ham, a researcher may also want to provide a document containing an
analysis of the copy of parish record. 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”.