The Homer Multitext project archive Integrating contributions from more than 100 scholars

HMT archive

The github repository at https://github.com/homermultitext/hmt-archive is the central repository for archival data from the Homer Multitext project (HMT).

Unified publication system

Beginning in 2018, we are releasing published versions of the HMT archive as a single plain-text file in CEX format. These are committed in the releases-cex directory.

The CEX-format releases are automatically assembled from source files in the archive directory. Working with CITE architecture code libraries that can directly serialize our data models to CEX format, we assemble CEX files for individual parts of our work (e.g., catalogs of binary images, models of ordered pages in a codex, an diplomatic editions of texts). CEX allows us simply to concatenate the individual CEX files into a single, syntactically valid composite.

Building a release

Prerequisites: sbt

Update library.cex in the archive directory for each published release.

From from the root directory of this repository, open an sbt console (sbt console). Load the interactive script for generating releases:

:load release.sc

You can then use the release function to generate a new release like this:

release("RELEASE_NAME")

The value of RELEASE_NAME should be the version identifier for this release’s URN as given in library.cex. E.g., to publish a release of urn:cite2:hmt:publications.cex.2018a:all, use 2018a as the value for RELEASE_NAME.

This function writes two files to the the releases-cex directory:

  1. a composite CEX file named hmt-RELEASE_NAME.cex with the full contents of the archive
  2. a composite markdown file named hmt-RELEASE_NAME-corrigenda.md with a full catalog of machine-identified corrigenda

Layout of the archive

See details about file system organization and formats of archival files used to build CEX publications.

Earlier build systems

Prior to 2018, we used a gradle build system for assembling packages of published material that has passed final editorial review and verification into a unified representation in RDF. That system is no longer used but vestigial documentation is available here.