WIP, unpublished work. Mind map. PoC of working with Lakesuperior. https://grayspread.net
|Stefano Cossu 0482b4b511 Initial ontology.||5 months ago|
|bin||1 year ago|
|config||1 year ago|
|data||5 months ago|
|doc||1 year ago|
|grayspread||11 months ago|
|migrate||1 year ago|
|.gitignore||1 year ago|
|CODE_OF_CONDUCT||1 year ago|
|LICENSE||1 year ago|
|README.md||1 year ago|
|load_env.sh||1 year ago|
|requirements.txt||1 year ago|
|start.sh||1 year ago|
|start_iipsrv.sh||1 year ago|
This is the code powering the grayspread.net website, which is to date an unpublished WIP. This application uses the Lakesuperior Linked Data repository as a back end and can be used as a real-world example on how to use the Lakesuperior Python API.
[TODO MORE INFO]
A Docker image allowing to avoid all the setup steps listed below may be made available in the future.
It is advised to clone this repo as a subfolder of a dedicated project folder, e.g.:
mkdir grayspread cd grayspread git clone <remote> src
A virtual environment must be installed in order to use the autostart scripts.
python3 -m venv venv
in the parent directory of the git repo root.
Install Python Dependencies
cd src source ./load_env pip install -r requirements.txt
config/.env to the parent folder of git repo root and change it to fit
At the end of this process, you should have the following folder layout:
grayspread/ | `- .env | `- src/ | `- venv/
IIPImage, or iipsrv, is a high-performance, IIIF-compliant image server. Grayspread uses it to generate derivatives on the fly.
https://github.com/ruven/iipsrv repository, compile the source
code, and place
iipsrv.fcgi in the
You need an Nginx instance running to serve images via the iipsrv FCGI. Copy
config/iipsrv.conf to your Nginx configuration, edit if needed, and start
or reload Nginx.
Any other webserver similarly set up to listen to FCGI should be fine.
start.sh script starts a
multiwatch process that spawns and
iipsrv instances, and a Flask process for the web app in
load_env.sh can be sourced in a separate shell to load the virtual
An initial data set is provided in the form of CSV files that are parsed by a conversion script. [TODO Resolve issue with source images]