BookTranslator
BookTranslator

How to Read the Perseus Digital Library: Editions, Translations, and Exports

Use the Perseus Scaife Viewer without mixing editions, translations, notes, or passage ranges—and know when a source file is ready for another language workflow.

BookTranslator

BookTranslator Team

8 min read

To read a Greek or Latin work in Perseus, identify the work, choose the exact edition or translation, and then choose the passage range. Those are three different decisions. A familiar English title is not enough: two records can represent the same work while differing in language, editor, translator, notes, and text.

The practical rule is to save the version identifier with every quotation or export. In the Scaife Viewer, that identifier is a CTS URN. It lets you distinguish Xenophon's Anabasis as a work from a particular Greek edition, a particular English translation, and a range such as 1.1.1-1.1.5.

This guide uses Perseus's official Scaife documentation and two actual TEI XML files from the Perseus source repository. We did not live-test the current Scaife interface; the UI steps below come from the official guide published September 6, 2024, so labels or placement may have changed. The file inspection checks structure, identifiers, notes, license metadata, and hashes. It does not rate the translation or proofread the full text.

Start with Work, Version, and Passage

Perseus organizes texts with Canonical Text Services URNs. Read them from broadest to narrowest:

LayerExampleWhat it identifies
Text groupurn:cts:greekLit:tlg0032Xenophon within the Greek literature collection
Workurn:cts:greekLit:tlg0032.tlg006Anabasis, independent of one edition or translation
Versionurn:cts:greekLit:tlg0032.tlg006.perseus-grc2One specific Greek edition
Passageurn:cts:greekLit:tlg0032.tlg006.perseus-grc2:1.1.1-1.1.5A range inside that edition

If your purpose is reading, the work title may be sufficient at first. If you will quote, cite, compare, export, or process the text, record the version and passage too. Otherwise, a later reader cannot tell which wording, spelling, or annotation layer you used.

The Scaife Viewer Quick Start Guide, published September 6, 2024, recommends starting from Browse Library. It explains that the library can be sorted by text group, CTS URN, or work, and that hovering over a work reveals available versions. It also warns that migration from the older Perseus interface is incomplete, so a missing Scaife result does not prove that Perseus has no copy of the text.

Choose an Edition or Translation Deliberately

Language codes help, but they do not settle the version question. In the Scaife examples, grc identifies Ancient Greek and eng identifies English. A work can have multiple versions in the same language, so also inspect the attribution and source information shown for the selected version.

Use this decision sequence:

  1. Confirm the author and work, not just a translated title.
  2. Check whether the selected version is an edition or a translation.
  3. Record its full CTS URN.
  4. Inspect attribution, editor or translator, source repository, and release data.
  5. Decide whether notes and other supplemental material are part of the reading job.

This matters because a translation is not merely the same character stream in another language. It can contain translator notes, supplied explanations, and different editorial decisions. Those differences can affect copying, comparison, and downstream processing even when the passage hierarchy appears identical.

Add a Parallel Version for Reading, Not as Proof of Alignment

When a compatible parallel version is available, Scaife's documented Add parallel version control can place an edition and translation side by side. That is useful for moving between a source passage and a readable translation without losing the citation range.

Do not infer more than the interface establishes. Side-by-side display does not prove sentence-level alignment, equal note coverage, or equivalent wording. The two versions may share book, chapter, and section labels while differing internally.

For example, we downloaded these two official Perseus source files on September 14, 2026:

VersionFile sizeStructure foundNotes inside the body
Greek edition perseus-grc2887,224 bytes7 books, 51 chapters, 1,469 sections0
English translation perseus-eng21,101,217 bytes7 books, 51 chapters, 1,469 sections319

Both files were well-formed XML and declared a CC BY-SA 4.0 license in their TEI headers. Their matching counts make passage navigation practical, but the English file's 319 body notes show why equal section counts are not equal content. At 1.1.1, the English translation already contains a note while the Greek edition does not.

The SHA-256 hashes inspected were 5bf59352cab3dec763ecff9f4061385b8307146d2501432a5f5b178d6f31a4c2 for the Greek file and f4c88203196a4f2ed315d47642d10f9515c568374139ba1e25e7934312586ea7 for the English file. These hashes identify the downloaded artifacts; they are not quality scores.

Use Passage Ranges to Keep the Comparison Honest

The reader displays a passage range rather than an abstract whole work. Perseus's guide uses Anabasis 1.1.1-1.1.5 as an example and shows how ancestors such as book and chapter provide context for the currently displayed sections.

Before copying or comparing text, record:

  • the version URN for each column;
  • the displayed start and end references;
  • whether notes are visible or included;
  • whether you copied plain text or XML; and
  • the date of access or repository revision when reproducibility matters.

This prevents a common comparison error: taking five source sections, six translated sections, and an attached translator note, then treating the resulting word counts as if the ranges were equivalent.

Scaife also distinguishes search inside the displayed text from collection-wide search. Use the local search when you already know the version and want a form in that text. Use collection search when you are still locating occurrences across authors or works. The official guide says lemma search is available for Greek; a form search and a lemma search answer different questions.

Export the Displayed Passage, Not an Assumed Whole Book

The documented Export Passage control captures the displayed portion as plain text or XML. Read that wording literally. It does not establish that every version offers a one-click whole-work export.

Choose the output by the next job:

Next jobBetter starting outputCheck before using it
Quote or annotate a short passagePlain textVersion URN, range, Unicode characters, and notes
Preserve structural markupXMLNamespace, hierarchy, notes, and downstream parser support
Cite a passage onlineScaife reader URLVersion and exact range in the URL
Inspect or reproduce the source dataRepository TEI XMLLicense header, release, completeness, and file hash
Read an entire work comfortablyExisting edition or translationNavigation, completeness, device support, and rights

Do not rename XML to .txt or .epub and assume the format has changed. The current BookTranslator frontend accepts .xml files, but we did not upload either Perseus TEI file for this article or inspect a translated output. Treat technical acceptance as an intake fact, not evidence that TEI hierarchy, notes, identifiers, or scholarly conventions will survive a particular workflow.

A Five-Field Record Prevents Most Version Mistakes

For each text you use, keep one compact record:

  1. Work: author and canonical work title.
  2. Version: full CTS URN plus edition or translation status.
  3. Passage: exact start and end reference.
  4. Material: plain text, XML, reader URL, and whether notes are included.
  5. Provenance: repository or viewer URL, license, access date, and hash for downloaded files.

This is more useful than saving a screenshot with no version information. It also makes later corrections manageable: if Perseus updates one version, you can identify which notes or passages need to be checked again.

When Another Translation Is Actually Necessary

First use an existing version if it already meets the reading need. Scaife's parallel view can be enough for source comparison, and a published translation may be more appropriate than generating another full book.

If the desired modern language is unavailable, separate source acquisition from translation. Confirm the exact edition and obtain a complete file that you are permitted to process. Preserve the original TEI, then test a representative passage in the intended workflow before processing the complete file. The book-preparation checklist covers that source-file decision. If you need source and target text together, plan the review structure with the bilingual EPUB workflow.

For a permitted EPUB, PDF, DOCX, TXT, XML, or other currently supported file, BookTranslator can provide a complete-file translated draft and show the price before checkout. That does not establish that an Ancient Greek edition is handled to scholarly standards or that a repository TEI file's structure will be preserved. Test a representative passage, compare the actual output with the source hierarchy and notes, preserve the source citation, and arrange language-appropriate review before relying on the result.

If the existing Perseus translation is sufficient, stop there. The correct outcome is a clearly identified, readable version—not an unnecessary new file.

Matsalwa lama fambelanaka

How to Read the Perseus Digital Library: Editions, Translations, and Exports