This program is inspired by Clyde Pharr's edition of Vergil, which presented the Latin text along with English vocabulary on the same page to facilitate reading and avoid time spent looking up the more obscure vocabulary words in a dictionary.

The idea is to format a text and add glosses for infrequently used words. Currently, the program adds glosses for any word that appears five times or fewer in the text.

Currently, only Latin texts that are available from either Perseus or the Latin Library are available.

Credit to the CLTK and Luke Hollis/Archimedes Digital for the Open Words code that I used to make this project.

Also thanks to Perseus and the Latin Library for use of their texts, including the Lewis & Short dictioanry.

The program requires the CLTK and Open Words. The virtual environment that I used to create the program is included in the venv folder in this repo. To enable the environment, create a directory and clone the repo. Then run python3 -m venv dir/pharr_format/venv. You can use any Python environment compatible with CLTK (Python 3.7+)

Clone the two required repos into a project folder and add steadman.py. Users will have to unzip the dictionary file in the lexica folder.

Operation is relatively simple:

# instantiate class

steadman = steadman.PharrBuilder('latin_text_latin_library') # or 'latin_text_perseus' 

cat = steadman.catalog

cat[cat['author'].str.contains('vergil')] # look at available texts by Vergil

text = 'vergil/aen6.txt' # I use the CLTK file system to grab the texts, so the `source` column of the catalog is required 

steadman.get_texts(text)

steadman.create_document(title = 'vergil_aeneid_6_.docx', output_format='poetry')

Other methods available in the PharrBuilder class include word counts for lexical analysis and vocabulary lists based on frequency. The .docx files included in the repository are samples of the final output.

• Improvements to the parser. There are a few bugs in the parser used to add word definitions that result in errant definitions (for example, glossing fido fidere fisus as chord, instrument string, constellation Lyra, stringed instrument (pl.), lyre)

• Support for Greek

• Options to control paragraph length and other printing options

• Direct to PDF option

• Adding a full vocabulary list of all words in a text to the end of the document