Difference between revisions of "Tei-xsl"

From TEIWiki
Jump to navigation Jump to search
(How to download or buy: installing Debian package is also an option)
(Documentation: added section for converting from DOCX)
Line 46: Line 46:
  
 
Note that if your <code>$FORMAT</code> is docx, this directory must contain a file <code>template.docx</code> which is used to create .docx files from. See the sample in the default profile.
 
Note that if your <code>$FORMAT</code> is docx, this directory must contain a file <code>template.docx</code> which is used to create .docx files from. See the sample in the default profile.
 +
 +
=== Converting from DOCX format ===
 +
 +
Word has two kinds of styles: paragraph styles and character styles.  According to Sebastian, "The basic rule of the conversion is that if named [character] styles are used, they take precedence over manual formatting."  That is, if text (even a whole paragraph) has a character style applied but is also marked in Word as being italicized, the italics will not come through in the conversion separate from the character style.
  
 
== Tech support ==
 
== Tech support ==

Revision as of 15:46, 1 June 2011


Synopsis

"This is a set of XSLT 2.0 specifications to transform TEI XML documents to XHTML, to LaTeX, to XSL Formatting Objects, to/from OOXML (docx), to/from OpenOfice (odt) and to ePub format. [. . .] They concentrate on the simpler TEI modules, but adding support for other modules is fairly easy. In the main, the setup has been used on ‘new’ documents, ie reports and web pages that have been authored from scratch, rather than traditional TEI-encoded existing material."<ref>http://www.tei-c.org/Tools/Stylesheets/</ref>

Features

User commentary

Please sign all comments.


System requirements

"The XSL FO style sheets were developed for use with PassiveTeX (http://projects.oucs.ox.ac.uk/passivetex/), a system using XSL formatting objects to render XML to PDF via LaTeX. They have not been extensively tested with the other XSL FO implementations."<ref>http://www.tei-c.org/Tools/Stylesheets/</ref>

You also need Saxon 9.2 or later. If using Debian or Ubuntu, you can get it from http://tei.oucs.ox.ac.uk/teideb/ .

Source code and licensing

Freely available.

Support for TEI

Language(s)

Documentation is in English.

Documentation

These two pages should be identical and therefore equally authoritative:

Creating a custom profile

To create a profile for converting to/from a format and TEI XML, create either or both as needed:

profiles/$PROFILENAME/$FORMAT/to.xsl

profiles/$PROFILENAME/$FORMAT/from.xsl

Start by copying the files in profiles/default/$FORMAT/ and then adding your own overrides.

Note that if your $FORMAT is docx, this directory must contain a file template.docx which is used to create .docx files from. See the sample in the default profile.

Converting from DOCX format

Word has two kinds of styles: paragraph styles and character styles. According to Sebastian, "The basic rule of the conversion is that if named [character] styles are used, they take precedence over manual formatting." That is, if text (even a whole paragraph) has a character style applied but is also marked in Word as being italicized, the italics will not come through in the conversion separate from the character style.

Tech support

User community

Sample implementations

Current version number and date of release

5.42 (2010-10-17)

History of versions

See https://sourceforge.net/projects/tei/files/Stylesheets/ .

How to download or buy

There are three options:

Download zip file

Download the latest zip file (below all of the folders) from https://sourceforge.net/projects/tei/files/Stylesheets/ .

Install the Debian package

Install the appropriate Debian package (which one?).

Get from Subversion

svn co https://tei.svn.sourceforge.net/svnroot/tei/trunk/ /path/to/local/directory/

Then, if you want to add these to /usr/ (which you will need to do in order to use the command-line shell scripts), you can do the following:

cd /path/to/local/directory/Stylesheets/

make install

but note the following:

  • You should not download just the stylesheets module (using svn co https://tei.svn.sourceforge.net/svnroot/tei/trunk/Stylesheets/ ) because Stylesheets/Makefile requires that other modules be present.
  • You will need to run make install as a user with write permission to /usr/ . So if using Ubuntu, for example, you will need to instead do sudo make install .

Additional notes

Notes

<references/>