Skip to content
InterlineaDocs
MCP serverget_textDocs menu

Read a text

Read a section of a Latin or Greek work, or a graded passage, in the original.

TOOLget_text

A work on its own returns its opening section; a citation inside a section returns the whole section. The answer has the text, its citation, canonical url, CTS URN, the edition's credit and licence, and prev and next links: pass next.url as ref to keep reading. include adds the stored word analysis (analysis) and context notes (context).

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.

includearray of stringOptionalExtra parts to add. Each costs tokens.

Items: one of analysis, context. Default []. Up to 2 items.

Output

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

Output fields
NameDescription
kindstringsection: a reading section of a library work. passage: a graded passage.

One of section, passage.

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

One of la, grc.

languagestring
titlestring"Aeneid 1.1-11" for a section; the passage title for a graded passage.
citationstring"Virgil, Aeneid 1.1-11": quote this when you cite the text.
refstring or nullThe section's first citation, as used in its URL. Null for a graded passage.
levelinteger or nullGraded passages: difficulty 1 to 5.
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).
urlstringCanonical page.
apistringAbsolute URL.
markdownstring or nullThe same text as Markdown.
authorobject
2 fields
author fields
namestring
urlstring or nullAbsolute URL.
workobject
3 fields
work fields
titlestring
urlstring or nullAbsolute URL.
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).
verseboolean
wordsinteger
textstringPlain text; verse keeps its line breaks.
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 nullFollow next.api to read on without searching again.
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.

analysisobjectOptionalOnly with include=analysis.
5 fields
analysis fields
analysedintegerSentences with a stored analysis.
totalintegerSentences in the text.
licensestringThe analyses adapt CC BY-SA text, so they are share-alike.

Always CC BY-SA 4.0.

notestring
sentencesarray of object
4 fields
sentences fields
indexinteger0-based sentence index in the text.
textstring
translationstring or nullNull when the sentence has no stored analysis yet.
wordsarray of object or nullNull when the sentence has no stored analysis yet.
11 fields
words fields
iinteger1-based index of the word in its sentence.
formstringThe word as printed.
lemmastringDictionary headword; Latin with macrons, Greek polytonic.
entrystring or nullDictionary entry: principal parts, or genitive and gender.
uposstringUniversal Dependencies part of speech.
featsstringUniversal Dependencies features, e.g. "Case=Acc|Gender=Neut|Number=Plur"; "_" if none.
headintegerIndex of the word this one depends on; 0 for the root.
deprelstringUniversal Dependencies relation to its head: nsubj, obj, amod, …
glossstringMeaning in this sentence, 1 to 4 words.
notestring or nullOne sentence on the word's role.
encliticobjectOptionalPresent only when an enclitic rides on the word, e.g. -que "and".
2 fields
enclitic fields
formstring
glossstring
contextobjectOptionalOnly with include=context.
3 fields
context fields
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/text, with the same shape.

Example call

{
  "ref": "Virgil, Aeneid 1.46"
}

Example output

structuredContent
{
  "kind": "section",
  "lang": "la",
  "language": "Latin",
  "title": "Aeneid 1.46-86",
  "citation": "Virgil, Aeneid 1.46-86",
  "ref": "1.46",
  "level": null,
  "urn": "urn:cts:latinLit:phi0690.phi003.perseus-lat2:1.46-1.86",
  "url": "https://interlinea.aeterna-institute.org/library/latin/virgil/aeneid/1.46",
  "api": "https://interlinea.aeterna-institute.org/api/v1/library/latin/virgil/aeneid/1.46",
  "markdown": "https://interlinea.aeterna-institute.org/library/latin/virgil/aeneid/1.46.md",
  "author": {
    "name": "Virgil",
    "url": "https://interlinea.aeterna-institute.org/library/latin/virgil"
  },
  "work": {
    "title": "Aeneid",
    "url": "https://interlinea.aeterna-institute.org/library/latin/virgil/aeneid",
    "urn": "urn:cts:latinLit:phi0690.phi003"
  },
  "verse": true,
  "words": 276,
  "text": "Ast ego, quae divom incedo regina, Iovisque\net soror et coniunx, una cum gente tot annos\nbella gero! Et quisquam numen Iunonis adoret\npraete…",
  "prev": {
    "citation": "Aeneid 1.1-45",
    "label": "Lines 1.1-1.45",
    "url": "https://interlinea.aeterna-institute.org/library/latin/virgil/aeneid/1.1",
    "api": "https://interlinea.aeterna-institute.org/api/v1/library/latin/virgil/aeneid/1.1"
  },
  "next": {
    "citation": "Aeneid 1.87-130",
    "label": "Lines 1.87-1.130",
    "url": "https://interlinea.aeterna-institute.org/library/latin/virgil/aeneid/1.87",
    "api": "https://interlinea.aeterna-institute.org/api/v1/library/latin/virgil/aeneid/1.87"
  },
  "credit": {
    "text": "Virgil, Aeneid, ed. J. B. Greenough. Text: the Perseus Digital Library, canonical-latinLit, CC BY-SA 4.0. Changes: apostrophes normalised an…",
    "license": "CC BY-SA 4.0",
    "licenseUrl": "https://creativecommons.org/licenses/by-sa/4.0/",
    "source": "https://github.com/PerseusDL/canonical-latinLit/blob/master/data/phi0690/phi003/phi0690.phi003.perseus-lat2.xml",
    "quality": "proofread"
  }
}