labasi

a python/django based version of cfdb

Install

1. clone the repo
2. create a virtual environment and run install the required packages pip install > requirements
3. adapt default.env to your needs and run set_env_varibales.sh (or copy default.env to secret.env if you use other db-credentials than the postgres default ones; make sure to adapt set_env_varibales.sh to your needs)
4. makemigrations and migrate python manage.py makemigrationsand python manage.py migrate
5. start the dev-server python manage.py runserver
6. browse to http://127.0.0.1:8000/

Docker

At the ACDH-CH we use a centralized database-server. So instead of spawning a database for each service our services are talking to a database on this centralized db-server. This setup is reflected in the dockerized setting as well, meaning it expects an already existing database (either on your host, e.g. accessible via 'localhost' or some remote one)

building the image

• docker build -t labasi:latest .
• docker build -t labasi:latest --no-cache .

running the image

To run the image you should provide an .env file to pass in needed environment variables; see example below:

• docker run -it -p 8020:8020 --rm --env-file docker.env --name labasi labasi:latest

ARCHE

prepare ARCHE (Meta)Data

To create ARCHE metadata, zip glyph and sign images and serialize tablet data as tei run

python manage.py zip_images
python manage.py save_teis
python manage.py arche

Those scripts populate https://labasi.acdh.oeaw.ac.at/to-ingest/ with the zipped images and TEIs as well as an arche.ttl

ingest

run

fetch_data.sh

to download binaries and metadata

to ingest metadata run

./arche__ingest_md.sh 

and to ingest binaries run

./arche__ingest_binaries.s