ROMA(1)

📦 version 2.11, in opensuse-leap 16.0

💅 ROMA(1) — bestie edition 🎀

ok so real talk, this is the General Commands Manual version of roma, and the full title is ROMA(1) if you're keeping score at home. let's get into it ✨

🌸 NAME 🌸

roma — compile a TEI ODD specification into schemas and dtd

like... it takes your ODD and turns it into schemas. iconic behaviour honestly 🫶

🦋 SYNOPSIS 🦋

roma [options] oddfile outputdir

⭐ DESCRIPTION ⭐

bestie, heads up: this manual page is not meant to be exhaustive. there's more info in the help files for the web version of Roma, and plenty of background data about ODDs in the TEI Guidelines. iykyk 💅

so what does roma actually do? it generates XML RelaxNG or W3C schemas and DTDs from the ODD source in oddfile, and (optionally) some documentation to go with them. that's the whole vibe. slay. 🔥

✨ OPTIONS ✨

roma accepts the following options — and yes, we're going through all of them, no skipping, no cap:

  • --xsl URL — location of TEI XSLT stylesheets. default is /usr/share/xml/tei/stylesheet 💖
  • --teiserver URL — location of the TEI eXist database server. default is http://tei.oucs.ox.ac.uk/Query/ 🌈
  • --doc — create expanded documented ODD 📝
  • --nodtd — suppress DTD creation 🙈
  • --norelax — suppress RelaxNG creation 🙈
  • --noxsd — suppress W3C XML Schema creation 🙈
  • --debug — leave temporary files, etc. lowkey useful when things get messy 💀

💀 BUGS 💀

ok this is the part where we get real. 😭

if the ODD specification is internally inconsistent — for example, some element has been deleted on which another element depends — then you may get a Relax NG schema which is apparently OK, but which cannot be translated into W3C schema. so it looks fine and then it isn't. it's giving fake friend energy.

and because the conversions to DTD and Relax are maintained separately, some constructs may cause one to fail but not the other. no consistency guarantee, bestie, sorry 🫶

also: no attempt is made to trap error messages from trang, which is used to make W3C schemas. it'll just... do its thing. 🙈

🔍 SEE ALSO 🔍

and that's the whole page, bestie!! this absolute icon of a manpage is from TEI, dated 9th May 2005, and it's ROMA(1) all the way down. periodt. 💅🎀💖

📦 where this page comes from