12 octobre 2023

TEI Stylesheets

[works also with Linux]

This is a family of XSLT 2.0 stylesheets to transform TEI XML documents to various formats, including XHTML, LaTeX, XSL Formatting Objects, ePub, plain text, RDF, JSON; and to/from Word OOXML (docx) and OpenOffice (odt). They concentrate on the core TEI modules which are used for simple transcription and “born digital” writing.

MacOs Install

For your information, here are the changes made to the original makefile

  • variable PREFIX : /usr > /tmp/tei

    • NB /tmp directory is cleaned up by macOS every 3 days by default see apple forum

  • line cp --preserve=timestamps bin/transformtei ${PREFIX}/bin > cp -p bin/transformtei ${PREFIX}/bin

  • line cp --preserve=timestamps source/p5subset.xml ${PREFIX}/source > cp -p source/p5subset.xml ${PREFIX}/source

  • line perl -p -i -e 's+^APPHOME=.*+APPHOME=/usr/share/xml/tei/stylesheet+' ${PREFIX}/bin/transformtei > perl -p -i -e 's+^APPHOME=.*+APPHOME=${PREFIX}/share/xml/tei/stylesheet+' ${PREFIX}/bin/transformtei

  • Go to stylesheets folder: cd path/to/local/Stylesheets and install: make install

    • if the Make command doesn’t run, it’s likely that the Xcode command line is missing, to install it: xcode-select --install
    • if needed you chan change a variable for the installation: make PREFIX=destination/path/for/installation install

  • add binaries to the $PATH in your ~/.zshrc: export PATH=$PATH:/tmp/tei/bin/

Add custom profile

Create a profile in the Stylesheets/profile subdirectory with the following pattern: profiles/$PROFILENAME/$FORMAT/(from.xsl or to.xsl) for example: profiles/local/docx/from.xsl

to import the default transformation, add an xsl:import rule to the custom xslt stylesheet, for example: <xsl:import href="../../default/docx/from.xsl" />.

Complete sample:

<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" 
  xmlns:xs="http://www.w3.org/2001/XMLSchema"
  xmlns:w="http://schemas.openxmlformats.org/wordprocessingml/2006/main"
  xmlns:wne="http://schemas.microsoft.com/office/word/2006/wordml"
  xmlns:wp="http://schemas.openxmlformats.org/drawingml/2006/wordprocessingDrawing"
  xmlns="http://www.tei-c.org/ns/1.0"
  exclude-result-prefixes="xs w"
  version="2.0">
  <xsl:import href="../../default/docx/from.xsl"/>
  <!-- nouvelles règles-->
  <xsl:template match="/">[…]</xsl:template>
</xsl:stylesheet>

Then you need to reinstall the tei stylesheets: cd path/to/tei/Stylesheets ; make install

Transform

  • to call a XSLT just: docxtotei inputFile outputFile.
  • to call a XSLT with a custom profile: docxtotei --profile=$PROFILENAME inputFile outputFile for example docxtotei --profile=local inputFile outputFile.

NOTA BENE