Skip to content
forked from ecds/readux

Django web application to display, annotate, and export digitized books.

License

Notifications You must be signed in to change notification settings

saracarl/readux

 
 

Repository files navigation

Readux

Readux is a platform developed by the Emory Center for Digital Scholarship which allows users to read, take notes on, and publish with digitized texts from libraries’ archival collections. With Readux, users are able to:

  • browse digitized page images,
  • search and select the texts of these digitized books,
  • annotate text or illustrations in these works, and then
  • publish digital copies of the texts with their annotations. Administrators can organize digitized books into collections, facilitating user access to digitized books available through the platform. Since its release, Readux has proved to be an innovative research and pedagogy tool for scholars and faculty at Emory University and beyond, with an array of use-cases ranging from teaching to publishing.

Motivation

...

Deployment

...

Build status

Build Status

Installation (development)

Requirements

  1. Python 3
  2. PostgreSQL

Set up development environment

  1. Clone this repository.
  2. Navigate to the readux directory.
  3. Create virtual environment and activate it.
python3 -m venv venv
source venv/bin/activate
  1. Install the dependencies.
pip install -r requirements/local
  1. Copy and set up your local settings.
cp config/settings/local.dst config/settings/local.py
  1. Add your database settings to the local.py file or set an environment variable. For example:
export DATABASE_URL=postgres://<database user>:<database password>@127.0.0.1:5432/<database name>
  1. Run the migrations and load the example data.
python manage.py migrate
python manage.py loaddata apps/fixtures/dump.json

Running local development server

Run the development under https to avoid mix content errors. Note: this will generate a self-signed certificate. There are ways to tell your browser to trust these certs, but that is beyond the scope of this README.

python manage.py runserver_plus --cert-file cert.crt  0.0.0.0:3000

Running the tests

Coverage Status

Readux uses Django's default test framework, but is configured to use pytest. To run the tests, simply run:

pytest

Readux is configured to use Travis CI. Any push will trigger build.

Contribute

We use the Git-Flow branching model. Please submit pull requests against the develop branch.

Code of conduct

Code of Conduct

Tech/framework used

Build with Cookiecutter Django

Mirador for displaying and annotating IIIF images.

??? for exporting.

License

This software is distributed under the Apache 2.0 License.

About

Django web application to display, annotate, and export digitized books.

Resources

License

Code of conduct

Stars

Watchers

Forks

Packages

No packages published

Languages

  • JavaScript 82.4%
  • CSS 10.5%
  • Python 5.1%
  • HTML 1.8%
  • Shell 0.2%