Difference between revisions of "Roma"

From TEIWiki
Jump to navigation Jump to search
(Documentation: also need texlive-full)
(moved installation instructions to proper section, clarified different approaches to installation)
Line 17: Line 17:
  
 
== Documentation ==
 
== Documentation ==
For instructions on installing the command-line version under Mac OS X, see [http://www.wwp.brown.edu/outreach/seminars/_current/handouts/roma_CLI_MacOS_X.html Roma CLI Instructions].  Besides this, just see the Debian packaging. '''For many of those commands, you might need to run them as sudo.'''
+
For instructions on installing the command-line version under Mac OS X, see [http://www.wwp.brown.edu/outreach/seminars/_current/handouts/roma_CLI_MacOS_X.html Roma CLI Instructions].  Besides this, just see the Debian packaging.
 
 
# Download the source from Subversion: <code>svn co https://tei.svn.sourceforge.net/svnroot/tei/trunk/ /path/to/local/directory/</code>
 
# Install P5 (required in order to install Roma):
 
## Put roma2.sh into the right place (since P5 installation requires it): <code>cp roma2.sh /usr/bin/roma2</code>
 
## Install texlive-full (includes xelatex, which is required to install P5)
 
## <code>cd /path/to/local/directory/P5/</code>
 
## <code>make install</code>
 
# Install Roma:
 
## <code>cd ../Roma/</code>
 
## <code>make install</code>
 
  
 
For the web version, see [http://www.tei-c.org/Guidelines/Customization/use_roma.xml Customizing the TEI with Roma].
 
For the web version, see [http://www.tei-c.org/Guidelines/Customization/use_roma.xml Customizing the TEI with Roma].
Line 48: Line 38:
  
 
== How to download or buy ==
 
== How to download or buy ==
 +
 +
There are three options.
 +
 +
=== Download the zip file ===
 +
 
[https://sourceforge.net/projects/tei/files/Roma/ Sourceforge download] – a shell utility (requires [http://xmlsoft.org/XSLT/xsltproc2.html xsltproc], [http://thaiopensource.com/relaxng/trang.html trang] and  [[wikipedia:perl|perl]])
 
[https://sourceforge.net/projects/tei/files/Roma/ Sourceforge download] – a shell utility (requires [http://xmlsoft.org/XSLT/xsltproc2.html xsltproc], [http://thaiopensource.com/relaxng/trang.html trang] and  [[wikipedia:perl|perl]])
 +
 +
=== Install the Debian package ===
 +
 +
Install the appropriate [http://tei.oucs.ox.ac.uk/teideb/ Debian package] (which one?).
 +
 +
=== Get from Subversion ===
 +
 +
'''For many of those commands, you might need to run them as sudo.'''
 +
 +
# Download the source from Subversion: <code>svn co https://tei.svn.sourceforge.net/svnroot/tei/trunk/ /path/to/local/directory/</code>
 +
# Install P5 (required in order to install Roma):
 +
## Put roma2.sh into the right place (since P5 installation requires it): <code>cp roma2.sh /usr/bin/roma2</code>
 +
## Install texlive-full (includes xelatex, which is required to install P5)
 +
## <code>cd /path/to/local/directory/P5/</code>
 +
## <code>make install</code>
 +
# Install Roma:
 +
## <code>cd ../Roma/</code>
 +
## <code>make install</code>
  
 
== Additional notes ==
 
== Additional notes ==

Revision as of 16:08, 24 February 2011

Synopsis

Roma is the TEI tool (a suite of XSLT stylesheets) for creating schemas and customisations from P5 ODD specifications. It was written by Arno Mittelbach and is maintained by Sebastian Rahtz.

Features

User commentary

Please sign all comments.

System requirements

Source code and licensing

Support for TEI

Language(s)

Documentation

For instructions on installing the command-line version under Mac OS X, see Roma CLI Instructions. Besides this, just see the Debian packaging.

For the web version, see Customizing the TEI with Roma.

As Sebastian wrote on TEI-L on 2009-12-21, "Always remember when considering Roma and friends that the variation is in the XSL stylesheets which it uses. So 99% of error reports and bug fixes are to do with the behaviour of odd2odd.xsl and odd2relax.xsl (etc). The XSL package changes much more frequently than Roma."

Tech support

Report problems either at the TEI-L list or in the SourceForge bug tracker.

User community

Sample implementations

http://www.tei-c.org/Roma/

Current version number and date of release

  • 3.7 (2009-01-31)

History of versions

https://sourceforge.net/projects/tei/files/Roma/

How to download or buy

There are three options.

Download the zip file

Sourceforge download – a shell utility (requires xsltproc, trang and perl)

Install the Debian package

Install the appropriate Debian package (which one?).

Get from Subversion

For many of those commands, you might need to run them as sudo.

  1. Download the source from Subversion: svn co https://tei.svn.sourceforge.net/svnroot/tei/trunk/ /path/to/local/directory/
  2. Install P5 (required in order to install Roma):
    1. Put roma2.sh into the right place (since P5 installation requires it): cp roma2.sh /usr/bin/roma2
    2. Install texlive-full (includes xelatex, which is required to install P5)
    3. cd /path/to/local/directory/P5/
    4. make install
  3. Install Roma:
    1. cd ../Roma/
    2. make install

Additional notes

Also see Vesta.

Sebastian wrote to TEI-L on 2009-12-21, "I expect to do some fixes next year to allow the ODD processing to be carried out by web services, based on the EGE (http://dl.psnc.pl/software/EGE/). When that is working, my idea is to redo Roma to use the web services to do all its backoffice work, and so not need any local software at all."