Merge branch 'clean_and_fix'

INSTALL.md

@@ -1,21 +1,44 @@
+# 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.
 
-In a terminal, run the command
-
-    pip3 install lxml bibtexparser bs4
+	$ 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

README.md

@@ -57,7 +57,7 @@ See [doc/XSL.md](https://github.molgen.mpg.de/EditionOpenAccess/EOASkripts/blob/
 To install the whole toolchain, clone at least this repository as well
 as the 'advanced' branch of
 [EOA sample project](https://github.molgen.mpg.de/EditionOpenAccess/eoa_sample_project).
-Follow the installation instructions in [INSTALL.md](https://github.molgen.mpg.de/EditionOpenAccess/EOASkripts/blob/master/INSTALL.md).
+Follow the installation instructions in [INSTALL.md](./INSTALL.md).
 
 In `eoa_sample_project`, run `xelatex`, `biber` (the version included
 in your TeX distribution) and `xelatex` two more times. This will give
@@ -79,10 +79,4 @@ These scripts don't take any arguments and will produce output in the
 
 External dependencies
 ---------------------
-See [INSTALL.md](https://github.molgen.mpg.de/EditionOpenAccess/EOASkripts/blob/master/INSTALL.md) for details.
-
-- lxml (<https://pypi.org/project/lxml/>)
-- bibtexparser (<https://pypi.org/project/bibtexparser/>)
-- BeautifulSoup (<https://pypi.org/project/bs4/>)
-- pandoc (<https://pandoc.org/>)
-- pandoc-citeproc (<https://hackage.haskell.org/package/pandoc-citeproc>)
+See [INSTALL.md](./INSTALL.md) for details.