INSTALL.md

# Installation instructions

## Python Dependencies

All programs require the installation of Python 3, which can be
obtained at <https://www.python.org/downloads/> or through package
managers (depending on the operating system). Current installations
already include `pip` which is used to install further packages.

	$ pip install -r requirements.txt

to install the required packages.

## Runtime Dependencies

Additionally, you will need these extra tools installed ( = in your systems $PATH ):
* [graphicsmagick](http://www.graphicsmagick.org/)
* [tralics](https://www-sop.inria.fr/marelle/tralics/)
* [pandoc](https://pandoc.org/)
- [pandoc-citeproc](https://hackage.haskell.org/package/pandoc-citeproc)
* curl
* from your latex distribution:

	- pdfcrop
	- xelatex

For a successful run of the whole conversion you will also need a
slightly older version (Version 2.1) of the biber tool. You can
download the source and/or binaries at
https://sourceforge.net/projects/biblatex-biber/files/biblatex-biber/2.1/

In order to run the xsl scripts found in the
[data](https://github.molgen.mpg.de/EditionOpenAccess/EOASkripts/tree/master/data)
directory, an XSL processor like
[Saxon](http://saxon.sourceforge.net/) is required. See
[doc/XSL.md](https://github.molgen.mpg.de/EditionOpenAccess/EOASkripts/blob/master/doc/XSL.md)
for details.

In later versions, the file format was changed. We still need to adapt
to the new format.

## TEI components
Clone the repositories
- https://github.com/TEIC/TEI.git
- https://github.com/TEIC/Stylesheets.git

`Stylesheets` contains the tools for conversion.

See <http://www.tei-c.org/release/doc/tei-xsl/> for further documentation.