hbz/digitalisiertedrucke

h1. About

Work in progress: transformation and web access for hbz's "digitalisiertedrucke.de":http://www.digitalisiertedrucke.de "data":https://datahub.io/dataset/hbz-zvdd.

h1. Build

Prerequisites: Java 8, Maven 3; verify with @mvn -version@

Create and change into a folder where you want to store the projects:

Build the hbz metafacture-core fork:

Get @digitalisiertedrucke@, set up the Play application, and run the tests:

@git clone https://github.com/hbz/digitalisiertedrucke.git@
@cd ~ ; wget http://downloads.typesafe.com/typesafe-activator/1.3.10/typesafe-activator-1.3.10-minimal.zip@
@unzip typesafe-activator-1.3.10-minimal.zip@
@cd git/digitalisiertedrucke ; ~/activator-1.3.10-minimal/bin/activator test@

See the @.travis.yml@ file for details on the CI config used by Travis.

h1. Data import

To transform the bzipped Marc-XML source data to JSON and index into an embedded Elasticsearch index, run:

@~/activator-1.3.10-minimal/bin/activator "runMain ImportData"@

Metadata transformations are implemented with "Metafacture":https://github.com/culturegraph/metafacture-documentation.

h1. Web app

h2. Development mode

To start the web app in development mode, run:

@~/activator-1.3.10-minimal/bin/activator run@

h2. Production mode

Customize @conf/application.conf@, set:

@play.crypto.secret@ to a custom value
@index.location@ to the absolute path of the deployed repo, e.g. @"/home/sol/git/digitalisiertedrucke"@
@index.host@ to the host name of the deployment machine, e.g. @"quaoar1.hbz-nrw.de"@

Then start the app in production mode, with the port to run on:

@~/activator-1.3.10-minimal/bin/activator "start 6000"@

h1. Eclipse setup

To generate an Eclipse project (import in Eclipse as existing project), run:

@~/activator-1.3.10-minimal/bin/activator compile "eclipse with-source=true"@

hbz / digitalisiertedrucke