667c4548a2
|
||
|---|---|---|
| .pytest_cache/v/cache | ||
| blueprints | ||
| dist/js | ||
| seed_data | ||
| src | ||
| templates | ||
| tests | ||
| .babelrc | ||
| .gitignore | ||
| JoyceEditor_Mock.pdf | ||
| README.md | ||
| TODO.txt | ||
| application.py | ||
| package.json | ||
| pytest.ini | ||
| requirements.txt | ||
| setup.py | ||
| test_joyce.py | ||
| webpack.common.js | ||
| webpack.dev.js | ||
| webpack.prod.js | ||
README.md
Joyce
A Reader and Editor for Hypertext
Joyce is a web app for reading and annotating texts. It was designed to power The Joyce Project, a website to help introduce James Joyce's Ulysses to new readers with the full-text and detailed annotations.
Joyce uses Python and Flask for the backend, Elasticsearch for the datastore, and React and Bootstrap for the front end, bundled with Webpack. The text editor is built on DraftJS.
Setup
This assumes you have Node, npm, pip and optionall virtualenv installed.
Install Elasticsearch:
brew install elasticsearch
Joyce requires Python 2.7:
virtualenv -p /usr/bin/python2.7 joyce_flask
source bin/activate
Install the Python backend:
pip install -r requirements.txt
Install the Javascript frontend:
npm install
Setup the Elasticsearch indexes:
python setup.py
Run Locally
Start Elasticsearch:
elasticsearch
Start Webpack in watch mode:
npm run watch
Start Python application:
python application.py
You should now find Joyce running locally at:
localhost:5000