HTML Generation Overview

All TEI manuscript files are converted to one (or more) HTML files. The HTML files are then included into Wordpress pages with the File Includer plugin.

XSLT Transformations

Capitularia VMCronMakefilemss-header.xslmss-transcription.xslmss-footer.xslManuscript files(XML+TEI)publ/mssManuscript files(HTML)publ/cache/mss

Data flow during HTML generation

The Makefile is run by cron on the Capitularia VM at regular intervals.

The Makefile knows all the dependencies between the files and runs the appropriate tools to keep the HTML files up-to-date with the manuscript files.

The HTML files are stored in the cache directory.

User Delivery

ApacheWordpressDatabase(mysql)FootnotesPost-Processor(PHP)File Includer Plugin(PHP)Manuscript files(HTML)publ/cache/mssUser-Agent

Data flow during user access

When a user accesses a manuscript page, Wordpress finds a shortcode for the File Includer plugin in it. Control is passed to the File Includer plugin which checks the date of the filum includendum. If the file is newer than the data stored in the database it refreshes the database. Then it inserts the file’s content into the page, which is finally sent to the user.

Note

The Footnotes Post-Processor is still written in PHP. We plan to rewrite it in Python. (Nov. 2019)