pub.chive.review.entityLink

lexicons.governance.chive.pub

Documentation

Link from a text span in a preprint to a knowledge graph entity

main record

Link from a text span in a preprint to a knowledge graph entity

Record Key tid Timestamp-based ID

Properties

confidence integer Optional

Confidence score for the link (scaled by 1000 for 0.0-1.0 range)

minimum: 0maximum: 1000
createdAt string datetime Required

An RFC 3339 formatted timestamp.

eprintUri string at-uri Required

AT-URI of the eprint containing the linked text

schemaRevision integer Optional

Schema revision this record was created with. Absent means revision 1.

minimum: 1
View raw schema 
{
  "description": "Link from a text span in a preprint to a knowledge graph entity",
  "key": "tid",
  "record": {
    "properties": {
      "confidence": {
        "description": "Confidence score for the link (scaled by 1000 for 0.0-1.0 range)",
        "maximum": 1000,
        "minimum": 0,
        "type": "integer"
      },
      "createdAt": {
        "format": "datetime",
        "type": "string"
      },
      "eprintUri": {
        "description": "AT-URI of the eprint containing the linked text",
        "format": "at-uri",
        "type": "string"
      },
      "linkedEntity": {
        "description": "The entity being linked to",
        "refs": [
          "#graphNodeLink",
          "#externalIdLink",
          "#authorLink",
          "#eprintLink"
        ],
        "type": "union"
      },
      "schemaRevision": {
        "description": "Schema revision this record was created with. Absent means revision 1.",
        "minimum": 1,
        "type": "integer"
      },
      "target": {
        "description": "Text span being linked to an entity",
        "ref": "#textSpanTarget",
        "type": "ref"
      }
    },
    "required": [
      "eprintUri",
      "target",
      "linkedEntity",
      "createdAt"
    ],
    "type": "object"
  },
  "type": "record"
}
authorLink object

Link to an ATProto author

Properties

did string did Required

Author's DID

displayName string Required

Author's display name

handle string handle Optional

Author's handle

orcid string Optional

Author's ORCID (if available)

type string Required

No description available.

View raw schema 
{
  "description": "Link to an ATProto author",
  "properties": {
    "did": {
      "description": "Author's DID",
      "format": "did",
      "type": "string"
    },
    "displayName": {
      "description": "Author's display name",
      "type": "string"
    },
    "handle": {
      "description": "Author's handle",
      "format": "handle",
      "type": "string"
    },
    "orcid": {
      "description": "Author's ORCID (if available)",
      "type": "string"
    },
    "type": {
      "const": "author",
      "type": "string"
    }
  },
  "required": [
    "type",
    "did",
    "displayName"
  ],
  "type": "object"
}
eprintLink object

Link to another eprint/preprint

Properties

doi string Optional

DOI if available

title string Required

Eprint title

type string Required

No description available.

uri string at-uri Required

AT-URI of the eprint

View raw schema 
{
  "description": "Link to another eprint/preprint",
  "properties": {
    "doi": {
      "description": "DOI if available",
      "type": "string"
    },
    "title": {
      "description": "Eprint title",
      "type": "string"
    },
    "type": {
      "const": "eprint",
      "type": "string"
    },
    "uri": {
      "description": "AT-URI of the eprint",
      "format": "at-uri",
      "type": "string"
    }
  },
  "required": [
    "type",
    "uri",
    "title"
  ],
  "type": "object"
}
externalIdLink object

Link to an external identifier (Wikidata, ROR, ORCID, etc.)

Properties

identifier string Required

Identifier value (e.g., Q42 for Wikidata)

label string Required

Display label for the entity

system string Required

External identifier system

Known values: wikidata, ror, orcid, isni, viaf, lcsh, fast, credit, spdx, fundref, mesh, aat, gnd, anzsrc, arxiv, doi, pmid, pmcid
type string Required

No description available.

uri string uri Optional

Full URI for the external entity

View raw schema 
{
  "description": "Link to an external identifier (Wikidata, ROR, ORCID, etc.)",
  "properties": {
    "identifier": {
      "description": "Identifier value (e.g., Q42 for Wikidata)",
      "type": "string"
    },
    "label": {
      "description": "Display label for the entity",
      "type": "string"
    },
    "system": {
      "description": "External identifier system",
      "knownValues": [
        "wikidata",
        "ror",
        "orcid",
        "isni",
        "viaf",
        "lcsh",
        "fast",
        "credit",
        "spdx",
        "fundref",
        "mesh",
        "aat",
        "gnd",
        "anzsrc",
        "arxiv",
        "doi",
        "pmid",
        "pmcid"
      ],
      "type": "string"
    },
    "type": {
      "const": "externalId",
      "type": "string"
    },
    "uri": {
      "description": "Full URI for the external entity",
      "format": "uri",
      "type": "string"
    }
  },
  "required": [
    "type",
    "system",
    "identifier",
    "label"
  ],
  "type": "object"
}
graphNodeLink object

Link to a knowledge graph node (type or object, with optional subkind)

Properties

id string Optional

Node UUID identifier

kind string Required

Node kind: 'type' for classifications, 'object' for instances

Known values: type, object
label string Required

Display label for the node

slug string Optional

Human-readable slug (e.g., 'computer-science')

subkind string Optional

Subkind slug (e.g., 'field', 'facet', 'institution', 'contribution-type')

subkindUri string at-uri Optional

AT-URI of the subkind type node

type string Required

No description available.

uri string at-uri Required

AT-URI of the graph node

View raw schema 
{
  "description": "Link to a knowledge graph node (type or object, with optional subkind)",
  "properties": {
    "id": {
      "description": "Node UUID identifier",
      "type": "string"
    },
    "kind": {
      "description": "Node kind: 'type' for classifications, 'object' for instances",
      "knownValues": [
        "type",
        "object"
      ],
      "type": "string"
    },
    "label": {
      "description": "Display label for the node",
      "type": "string"
    },
    "slug": {
      "description": "Human-readable slug (e.g., 'computer-science')",
      "type": "string"
    },
    "subkind": {
      "description": "Subkind slug (e.g., 'field', 'facet', 'institution', 'contribution-type')",
      "type": "string"
    },
    "subkindUri": {
      "description": "AT-URI of the subkind type node",
      "format": "at-uri",
      "type": "string"
    },
    "type": {
      "const": "graphNode",
      "type": "string"
    },
    "uri": {
      "description": "AT-URI of the graph node",
      "format": "at-uri",
      "type": "string"
    }
  },
  "required": [
    "type",
    "uri",
    "label",
    "kind"
  ],
  "type": "object"
}
textPositionSelector object

W3C TextPositionSelector for character-based targeting

Properties

end integer Required

End character offset

minimum: 0
pageNumber integer Required

Page number in the document

minimum: 1
start integer Required

Start character offset

minimum: 0
type string Required

No description available.

View raw schema 
{
  "description": "W3C TextPositionSelector for character-based targeting",
  "properties": {
    "end": {
      "description": "End character offset",
      "minimum": 0,
      "type": "integer"
    },
    "pageNumber": {
      "description": "Page number in the document",
      "minimum": 1,
      "type": "integer"
    },
    "start": {
      "description": "Start character offset",
      "minimum": 0,
      "type": "integer"
    },
    "type": {
      "const": "TextPositionSelector",
      "type": "string"
    }
  },
  "required": [
    "type",
    "start",
    "end",
    "pageNumber"
  ],
  "type": "object"
}
textQuoteSelector object

W3C TextQuoteSelector for resilient text matching

Properties

exact string Required

The exact text to match

prefix string Optional

Text immediately before the match

maxLength: 32 bytes
suffix string Optional

Text immediately after the match

maxLength: 32 bytes
type string Required

No description available.

View raw schema 
{
  "description": "W3C TextQuoteSelector for resilient text matching",
  "properties": {
    "exact": {
      "description": "The exact text to match",
      "type": "string"
    },
    "prefix": {
      "description": "Text immediately before the match",
      "maxLength": 32,
      "type": "string"
    },
    "suffix": {
      "description": "Text immediately after the match",
      "maxLength": 32,
      "type": "string"
    },
    "type": {
      "const": "TextQuoteSelector",
      "type": "string"
    }
  },
  "required": [
    "type",
    "exact"
  ],
  "type": "object"
}
textSpanTarget object

W3C Web Annotation target for text spans

Properties

source string at-uri Required

AT-URI of the source document

View raw schema 
{
  "description": "W3C Web Annotation target for text spans",
  "properties": {
    "refinedBy": {
      "description": "Optional position selector for precise targeting",
      "ref": "#textPositionSelector",
      "type": "ref"
    },
    "selector": {
      "description": "Primary selector for resilient text matching",
      "ref": "#textQuoteSelector",
      "type": "ref"
    },
    "source": {
      "description": "AT-URI of the source document",
      "format": "at-uri",
      "type": "string"
    }
  },
  "required": [
    "source",
    "selector"
  ],
  "type": "object"
}

Lexicon Garden

@