RomaJS - roma.tei-c.org
RomaJS is a web app for creating and editing ODD documents to customize and generate schemata for the Text Encoding Initiative.
This web app is written in React/Redux and is designed to be easily compiled and deployed as a static site. Some key transformations are handled online via the API provide by TEIGarage, a TEI maintained online service. TEI data comes from the TEI Vault.
Download the latest build from the release page. Serve the static site from a simple server. You will need to set up a rewrite to index.html to make sure URL routes will work. For example in Apache 2:
RewriteEngine On
RewriteCond %{REQUEST_FILENAME} !-f
RewriteRule ^(.*)$ index.html [L,QSA]
You can also deploy it via Docker.
Make sure node.js is installed then:
$ npm install --legacy-peer-deps
RomaJS was largely developed between 2017-2018 using technology available at the time. While we have little concerns about the longevity of the compiled tool, over time there will be issues with using outdated libraries when developing new features or fixing bugs. We will try to fix ostensibly broken dependencies, but otherwise will stick to the versions that worked when this tool was developed.
We are currently pinned to React 16 and Webpack 3 (See #163).
In particular, adding or fixing HTML components can be tricky: we used an early version of the Material Components Web library (v 0.43.0). The closest documentation is currently available here (Wayback machine link).
$ npm test
$ npm start
$ npm run build
Edit src/utils/urls.js and rebuild.
Alternatively, these variables can also be overridden from the Docker configuration.