Overview

In this article, I will attempt to customize TEI ODD (One Document Does-it-all) using a web application called Roma.

https://romabeta.tei-c.org/

For more about TEI ODD, please refer to the official site below. I must admit that I do not fully understand it myself due to limited study.

https://wiki.tei-c.org/index.php/ODD

However, one use case is that in TEI-based projects, you can restrict the tags used (specifically, those that receive assistance and validation).

This can help alleviate the challenge of being overwhelmed by the large number of TEI tags available.

In this article, I will customize the ODD/RNG files using Roma, assuming the tags used in the workflow for creating TEI/XML from Excel introduced in the following article.

Tags Used

In this use case, the following tags are used:

  • Text-related

    • pb
    • ab
    • lb
    • seg
    • choice
    • orig
    • note
    • reg

  • Image-related

    • facsimile
    • surface
    • label
    • zone

We will create ODD/RNG files restricted to the above tags.

Using Roma

Access Roma.

https://romabeta.tei-c.org/

Under “SELECT ODD,” select “TEI Minimal.”

On the settings screen, modify the Title and other fields. In particular, I recommend setting the two Language-related items to Japanese.

Select only the tags used in each project, such as the ab tag.

When editing is complete, select “RelaxNG schema” and download it.

I also recommend downloading “Customization as ODD.” By uploading this ODD file from the form on Roma’s top page, you can make additional edits.

Adding to an XML File

If the downloaded tei_excel.rng file is placed in the same directory as the XML file being edited, add <?xml-model ... ?> as follows:

<<<??T<xxEtTmmIetEllieI-xHi>vmmeHeolaerdndasesedil=reo">rnhh>=rt"et1fp.=:0"/"t/eweiwn_wce.oxtdceieinl-g.c=r."nougrt"gf/-sn8cs"h/?e1>m.a0t"y>pens="http://relaxng.org/ns/structure/1.0"type="application/xml"?>

Alternatively, if uploaded to a server such as GitHub, you can specify it in URL format as follows:

<<<??T<xxEtTmmIetEllieI-xHi>vmmeHeolaerdndasesedil=reo">rnhh>=rt"et1fp.=:0"/"h/twetwnpwcs.o:td/ei/inr-gac=w.".ougrtigft/-hn8us"b/?u1>s.e0r"c>ontent.com/nakamura196/test2021/main/tei_excel.rng"schematypens="http://relaxng.org/ns/structure/1.0"type="application/xml"?>

Editing XML Files

In this state, when typing < directly under the body tag, the following options are displayed. Only the tags selected in Roma appear.

For reference, here is an example of the options when tei_all.rng is configured. More tags such as addSpan and alt are displayed.

In this way, by using Roma to restrict the tags used in each project, you can reduce the complexity of tag input.

Summary

ODD and Roma should be capable of much more, but for now, I was able to create ODD/RNG files restricted to only the tags used in the project.

I hope this article serves as a helpful reference for customizing ODD files and using Roma.