Requirements

Install docker and docker compose.

Starting

To download, intialize and run KorAP pointing to a certain directory index (in this example myindex in the local directory), run

$ INDEX=./myindex docker-compose up

This will make the frontend be available at localhost:64543.

Index conversion

Depending on the corpus data to be indexed, it must first be converted. In the case of a conversion from TEI p5/i5 format, the tools required for this have already been installed with the above command.

In the following we assume that an i5 file mycorpus.i5.xml is located in the local folder.

The command ...

$ docker run --rm -v ${PWD}:/data korap/kalamar tei2korapxml --input /data/mycorpus.i5.xml > mycorpus.zip

... will convert the i5 file into a KorAP-XML file using tei2korapxml.

To convert the KorAP-XML archive in a second step into individual Krill JSON, the following command ...

$ docker run --rm -u root \
  -v ${PWD}/:/kalamar/data/ korap/kalamar korapxml2krill archive \
  -z -i /kalamar/data/mycorpus.zip -o ./data/

... will use korapxml2krill.