TEI Journal Encoding Package
What is this?
Since the beginning of the Journal of the Text Encoding Initiative, article submissions have been accepted in TEI XML. However, since everyone's notion of how journal articles should be encoded in TEI is completely different, and the TEI Guidelines provide many different ways of encoding similar textual features, no two submissions have ever really resembled each other much, and every XML submission has needed substantial initial work to turn it into something our reviewers and copyeditors can work with.
The solution to this is, obviously, a constrained schema, and that's what this is, basically. The downloadable package includes a RelaxNG schema and an additional Schematron schema, which, in combination, provide a relatively simple and robust set of encoding rules for submitting TEI documents to the journal.
However, it's a little bit more than that. We've framed it in the form of an Oxygen project, which means that, if you're using Oxygen and you follow the basic instructions, you should be able to see, while you're encoding, a helpful CSS-based "author" view of the document, and also generate a word-processor version (in Open Document Format) for easy proofing.
There is also a complete ODD file with a lot of Guidelines-style documentation in HTML form generated from it. That's the best place to start.
Who is it for?
This is a beta release. The journal editors have been using the schemas for some time, but this is the first time we're releasing the package for outsiders to use when preparing submissions. We expect some problems, ambiguities and confusion, but we hope that even with this preliminary release, using the tools will make life easier for submitters than not using them.
How do I use it?
- Download the package Media:jtei-oxygen-dist.zip,
- unzip it into an empty folder,
- open the jtei.xpr project file with "Project / Open Project" in Oxygen,
- open schema/jtei.html in your web browser, and
- follow the instructions.
Who do I complain to?
The package is being developed by Ron Van den Branden and Martin Holmes. Write to mholmes@uvic.ca with any complaints, suggestions, questions and typos.
