JSON-LD context

TextRefs records are plain JSON that becomes linked data through a published JSON-LD context. The context maps TextRefs terms onto a small TextRefs ontology namespace (tr:) plus established vocabularies — SKOS for labels, schemes, and mapping relations, Dublin Core Terms for dates and provenance, schema.org for URLs and providers, and XSD for date typing.

The v1 context is served at:

https://textrefs.org/contexts/v1.jsonld

Vocabularies

Prefix	Namespace	Used for
`tr`	`https://textrefs.org/ontology#`	TextRefs object types, keys, and TextRefs-specific metadata
`skos`	`http://www.w3.org/2004/02/skos/core#`	Labels, schemes (`inScheme`), and mapping relations
`dcterms`	`http://purl.org/dc/terms/`	`created`, `modified`, `source`, `language`, `license`
`schema`	`https://schema.org/`	`url`, `provider`, `edition`, `creator`, `familyName`, `givenName`, `name`
`xsd`	`http://www.w3.org/2001/XMLSchema#`	`xsd:date` typing for `created` / `modified` / `last_checked`

Mapping relations

The MVP mapping relations map directly onto SKOS:

exactMatch → skos:exactMatch
closeMatch → skos:closeMatch

Use exactMatch only when the mapped object identifies the same reference with sufficient precision. If there is uncertainty about segmentation, edition, translation, coverage, or locator alignment, use closeMatch. See Specification §10.

The context document

{
  "@context": {
    "tr": "https://textrefs.org/ontology#",
    "skos": "http://www.w3.org/2004/02/skos/core#",
    "dcterms": "http://purl.org/dc/terms/",
    "schema": "https://schema.org/",
    "xsd": "http://www.w3.org/2001/XMLSchema#",
    "id": "@id",
    "type": "@type",
    "Work": "tr:Work",
    "CitationSystem": "tr:CitationSystem",
    "CanonicalReference": "tr:CanonicalReference",
    "MappingAssertion": "tr:MappingAssertion",
    "key": "tr:key",
    "preferred_label": "skos:prefLabel",
    "creators": "schema:creator",
    "kind": "tr:creatorKind",
    "family": "schema:familyName",
    "given": "schema:givenName",
    "name": "schema:name",
    "inScheme": { "@id": "skos:inScheme", "@type": "@id" },
    "work_key": "tr:workKey",
    "citation_system_key": "tr:citationSystemKey",
    "locator": "tr:locator",
    "normalization_version": "tr:normalizationVersion",
    "status": "tr:status",
    "source": "dcterms:source",
    "created": { "@id": "dcterms:created", "@type": "xsd:date" },
    "modified": { "@id": "dcterms:modified", "@type": "xsd:date" },
    "relation": "tr:relation",
    "exactMatch": { "@id": "skos:exactMatch", "@type": "@id" },
    "closeMatch": { "@id": "skos:closeMatch", "@type": "@id" },
    "subject": { "@id": "tr:subject", "@type": "@id" },
    "target": "tr:target",
    "target_kind": "tr:targetKind",
    "identifier": { "@id": "tr:identifier", "@type": "@id" },
    "resolver_targets": "tr:resolverTargets",
    "provider": "schema:provider",
    "url": { "@id": "schema:url", "@type": "@id" },
    "language": "dcterms:language",
    "edition": "schema:bookEdition",
    "access": "tr:access",
    "license": "dcterms:license",
    "license_url": { "@id": "dcterms:license", "@type": "@id" },
    "last_checked": { "@id": "tr:lastChecked", "@type": "xsd:date" },
    "locator_regex": "tr:locatorRegex",
    "examples": "tr:examples",
    "valid": "tr:validExample",
    "invalid": "tr:invalidExample"
  }
}

key, work_key, and citation_system_key are plain strings in the core JSON format. Rich bibliographic and authority data — catalogue records, edition histories, subject classifications — belongs in external systems and is connected to TextRefs records through MappingAssertions. The one in-record exception is the optional Work.creators array, which carries minimal authorship for citation rendering (see Specification §6). The license term carries an SPDX identifier string; license_url (optional fallback) carries an IRI. MappingAssertion.source is a plain string in v0.1 — a structured W3C PROV-O mapping (prov:wasDerivedFrom) is reserved for a later context version.