Skip to content
InterlineaDocs
MCP serverget_contextDocs menu

Context notes

Stored notes on where a text sits in its work: what happened before, what happens here (never a translation), the people, gods and places named, what comes next, and a few lines about the work.

TOOLget_context

Hand-written for graded passages. For library sections they exist only once a reader has opened Context in Interlinea; otherwise section is null. Never generated here.

Input

Input
NameDescription
refstringRequiredWhat to read: an Interlinea URL (https://interlinea.aeterna-institute.org/library/latin/virgil/aeneid/1.46, or /read/latin/virgil-aeneid for a graded passage), a CTS URN (urn:cts:latinLit:phi0690.phi003.perseus-lat2:1.46) or a citation ("Virgil, Aeneid 1.46", "Iliad 1.1").

Up to 500 characters.

Output

structuredContent has these fields, and content repeats the same JSON as one text item.

Output fields
NameDescription
kindstring

One of section, passage.

langstringLanguage code: la (Latin) or grc (Ancient Greek).

One of la, grc.

languagestring
citationstring
urnstring or nullCTS URN, e.g. urn:cts:latinLit:phi0690.phi003.perseus-lat2:1.1-1.11. Null when the edition has none (The Latin Library's own numbering).
urlstringAbsolute URL.
apistringAbsolute URL.
prevobject or null
4 fields
prev fields
citationstring"Aeneid 1.12-33"
labelstring"Book 1, lines 12-33"
urlstringAbsolute URL.
apistringThe same resource as JSON.
nextobject or null
4 fields
next fields
citationstring"Aeneid 1.12-33"
labelstring"Book 1, lines 12-33"
urlstringAbsolute URL.
apistringThe same resource as JSON.
creditobject
5 fields
credit fields
textstringCredit line for the edition: author, work, editor, source, licence and changes. Quote it when you reuse the text.
licensestringCC BY-SA 4.0, CC BY 3.0, Used with permission (The Latin Library), or a public-domain note.
licenseUrlstring or null
sourcestringWhere the edition comes from.
qualitystringocr: an unproofread scan.

One of proofread, ocr.

machineWrittenbooleanFalse for the graded passages' hand-written notes.
sectionobject or nullNull until someone has opened Context for this part in the reader.
4 fields
section fields
soFarstring or nullWhat has happened in the work before this part.
herestring or nullWhat happens in this part, never a translation.
peoplearray of objectPeople, gods and places named here.
4 fields
people fields
namestring
notestring
formsarray of stringThe words in the text that name them.
wikipediastring or nullEnglish Wikipedia article title, when certain.
nextstring or nullWhat comes next.
workobject or nullA few lines about the work.
2 fields
work fields
introstring or null
notestring or null

The same reads as GET /api/v1/context, with the same shape.

Example call

{
  "ref": "/read/latin/virgil-aeneid"
}

Example output

structuredContent
{
  "kind": "passage",
  "lang": "la",
  "language": "Latin",
  "citation": "Virgil, Aeneid 1.1–11",
  "urn": "urn:cts:latinLit:phi0690.phi003.perseus-lat2:1.1-1.11",
  "url": "https://interlinea.aeterna-institute.org/read/latin/virgil-aeneid",
  "api": "https://interlinea.aeterna-institute.org/api/v1/passages/latin/virgil-aeneid",
  "prev": {
    "citation": "Metamorphoses 1.1–9",
    "label": "Bodies Changed",
    "url": "https://interlinea.aeterna-institute.org/read/latin/ovid-metamorphoses",
    "api": "https://interlinea.aeterna-institute.org/api/v1/passages/latin/ovid-metamorphoses"
  },
  "next": {
    "citation": "Odes 1.11",
    "label": "Seize the Day",
    "url": "https://interlinea.aeterna-institute.org/read/latin/horace-carpe-diem",
    "api": "https://interlinea.aeterna-institute.org/api/v1/passages/latin/horace-carpe-diem"
  },
  "credit": {
    "text": "Virgil, Aeneid 1.1–11. CC BY-SA 4.0. Perseus Digital Library (Tufts University), PerseusDL/canonical-latinLit; edition: J. B. Greenough, Gin…",
    "license": "CC BY-SA 4.0",
    "licenseUrl": "https://creativecommons.org/licenses/by-sa/4.0/",
    "source": "https://scaife.perseus.org/reader/urn:cts:latinLit:phi0690.phi003.perseus-lat2:1.1-1.11/",
    "quality": "proofread"
  },
  "machineWritten": false,
  "section": {
    "soFar": null,
    "here": "The opening lines announce the subject: a man driven by fate from Troy to Italy, battered on land and sea by Juno’s anger, who must fight a…",
    "people": [
      {
        "name": "Troy",
        "note": "The city in Asia Minor destroyed by the Greeks, where Aeneas comes from.",
        "forms": [
          "Troiae"
        ],
        "wikipedia": "Troy"
      },
      {
        "name": "Italy",
        "note": "Where fate is sending Aeneas.",
        "forms": [
          "Italiam"
        ],
        "wikipedia": null
      },
      {
        "name": "Lavinium",
        "note": "The town Aeneas will found in Latium, named after his future wife Lavinia.",
        "forms": [
          "Lavinia"
        ],
        "wikipedia": "Lavinium"
      },
      // 5 more
    ],
    "next": "Virgil names Carthage, the city Juno loves, and the old grudges behind her anger. Then the story opens at sea, with the Trojans sailing from…"
  },
  "work": {
    "intro": "Virgil’s epic in twelve books follows Aeneas, a Trojan prince, from the fall of Troy to Italy, where his descendants will found Rome. The fi…",
    "note": "Written in Augustus’ Rome in dactylic hexameter, the metre of Homer, it answers the Iliad and the Odyssey in Latin. It became the central po…"
  }
}