| commit | f09fc56873f87ccea0532319a7336ee1d47c4adc | [log] [tgz] |
|---|---|---|
| author | Akron <nils@diewald-online.de> | Wed Jan 11 08:47:21 2023 +0100 |
| committer | Akron <nils@diewald-online.de> | Wed Jan 11 08:47:21 2023 +0100 |
| tree | 4300748c285806578c29e0749915db28bfc0cdeb | |
| parent | fa8b85fd771785b0419adfef9d57dda1f18c0f25 [diff] |
Add Dockerfile Change-Id: I299a96042462b39abeaf2d0c9ea9c693528eb6e9
Kalamar-Plugin-ExternalResources is a web service that integrates in the plugin framework of Kalamar, to allow linking texts by their text sigle to external data providers, mainly for full text access.
Kalamar-Plugin-ExternalResources is meant to be a basic plugin and should demonstrate and evaluate the plugin capabilities of Kalamar.
Go 1.19 or later
To build the latest version of Kalamar-Plugin-ExternalResources, do ...
$ git clone https://github.com/KorAP/Kalamar-Plugin-ExternalResources $ cd Kalamar-Plugin-ExternalResources $ go test . $ go build .
The binary can be started without prerequisites. The templates folder has to be kept in the root directory.
Registration of the plugin in Kalamar is not yet officially supported. Registration works by passing the JSON blob generated at /plugin.json to the plugin registration handler.
To index further data, the mappings need to be stored in a csv-file, like
"WPD11/A00/00001","Wikipedia","http://de.wikipedia.org/wiki/Alan_Smithee" "WPD11/A00/00003","Wikipedia","http://de.wikipedia.org/wiki/Actinium" "WPD11/A00/00005","Wikipedia","http://de.wikipedia.org/wiki/Ang_Lee"
Then run the indexation with:
$ ./Kalamar-Plugin-Resources data.csv
The following environment variables can be set either as environment variables or via .env file.
KORAP_SERVER: The server URL of the hosting service.KORAP_EXTERNAL_RESOURCES_PORT: The port the service should be listen to.KORAP_EXTERNAL_RESOURCES: The exposed URL the service is hosted.Currently no official Docker image is provided. To build an image based on the provided Dockerfile, run
$ docker build \ -f Dockerfile \ -t korap/kalamar-plugin-externalresources .
To create a container based on the image with a mounted database in db and a configuration file, on Linux run
$ docker run \ --rm \ --network host \ -v ${PWD}/db/:/db/:z \ -v ${PWD}/.env:/.env korap/ \ kalamar-plugin-externalresources
Copyright (c) 2023, IDS Mannheim, Germany
Author: Nils Diewald
Kalamar-Plugin-ExternalResources is developed as part of the KorAP Corpus Analysis Platform at the Leibniz Institute for the German Language (IDS).
Kalamar-Plugin-ExternalResources is published under the BSD-2 License.