Skip to main content

XTriples Documentation

Convert TEI to CIDOC CRM​

There are two ways to create TEI documents that XTriples can convert to CIDOC CRM:

  1. Create CIDOC CRM from LEAF-Writer Files: Create documents using LEAF-Writer’s entity template files (records about people, places, organisations, or events) or LEAF-Writer’s Letter, Poem, and Prose templates with reconciled references to people.
  2. Create CIDOC CRM directly from TEI 'ographies: Transform your existing reconciled TEI to match the CWRC entity templates.

Currently, XTriples converts placeographies and personographies, but will convert bibliographies, eventographies, orgographies, letters, poems, and prose to CIDOC CRM by then of the summer of 2023.

Create CIDOC CRM from LEAF-Writer Files​

Once you have filled in template files (currently available for records about people and places) for your project in LEAF-Writer, upload them to LINCS XTriples (beta):

  1. Click upload and select the entity type that corresponds to your template file type (e.g., select "Placeography reconciled in LEAF-Writer" from the dropdown menu if you are converting place records created in LEAF-Writer).
  2. Choose the serialisation (XML or TTL) that you would like your output to be in. Both output options are CIDOC CRM representations of your TEI data.
note

The LINCS triplestore takes TTL as an input. If you are publishing your data with LINCS, choose TTL as your output. If you are planning to use the output in your own project, choose either XML or TTL as your output.

  1. Click download and save the output on your own computer.
  2. [optional] Submit your CIDOC CRM TTL to LINCS.

Create CIDOC CRM directly from TEI 'ographies​

LINCS XTriples can process any TEI 'ography files that conform to the LINCS entity templates. If you have experience writing eXtensible Stylesheet Transformations (XSLTs), you can transform your TEI to match the LINCS templates in LEAF-Writer. By the end of the summer of 2023 this documentation guide will contain XSLTs that you can modify and run to convert your project’s 'ographies into the LINCS 'ography TEI. If your TEI does not contain URIs, load your converted ’ography files into LEAF-Writer for reconciliation, and follow the steps in Create CIDOC CRM from LEAF-Writer Files.

Notes​

The following notes outline which TEI elements and attributes LINCS XTriples uses to create CIDOC CRM from your TEI, and how to add these TEI elements, attributes, and values in LEAF-Writer.

Person URI​

XTriples pulls the cannonical authority record URI from the @ref value of the first child <persName> inside <person>. In LEAF-Writer click on the Find Person icon to have LEAF-Writer reconcile the person's name against authority records on the Web. Select the authority URI that matches the person for whom you are creating a TEI record.

If you are editing your TEI in another editor add a @ref attribute to <persName> and paste the authority URI for your person into the @source value. Add a @type="standard" attribute and value pair to the <persName>.

Occupation​

The LINCS CIDOC CRM representation of occupation draws on the <occupation> @source value. We recommend using the occupation URI from the LINCS Occupation Vocabulary, but you may use URIs from other vocabularies (for example, the Art & Architecture Thesaurus occupations vocabulary).

In LEAF-Writer, right click on Preferred Occupation Term in the template and select Edit Tag. Choose the @source attribute, and paste in the occupation URI then click OK to save your changes.

If you are editing your TEI in an other editor, add a @source attribute to <occupation> and paste the occupation URI into the @source value.

Gender​

The LINCS XTriples CIDOC CRM representation of gender draws on the <sex> @source value in the LINCS person template. We recommend using a gender URI from the Vocabulary Browser > Canadian Writing Research Collaboratory Vocabulary > Gender > Narrower Concepts but you may use URIs from other vocabularies (for example Homosaurus)

In LEAF-Writer, right click on sex in the template and select Edit Tag to cut and paste the gender URI into the @source value.

If you are editing your TEI in another editor add a @source attribute to <sex> and paste the gender URI into the @source value.

The LEAF-Writer templates will eventually be updated to reflect the latest TEI encoding guidelines for sex and gender.

Nationality​

LINCS XTriples does not currently process the <nationality> element.