A Django-based digital humanities application for analyzing and presenting manuscript variations of historical texts, developed by the Roy Rosenzweig Center for History and New Media.
- Manuscript Management: Track and compare textual variations across multiple manuscript sources
- Line Code System: Hierarchical numbering system for precise text referencing (Book.Stanza.Line format)
- Translation Support: Multi-language manuscript versions with variant tracking
- Image Viewer: Integrated Tify viewer for manuscript images
- Geographic Data: Location tracking for manuscript origins and holdings
- Content Management: Wagtail CMS for managing static pages and content
- Backend: Django 5.0.2 with Python 3.11
- Database: PostgreSQL
- Frontend: Django templates with Tailwind CSS
- CMS: Wagtail
- Authentication: Django Allauth
- API: Django REST Framework
- Python 3.11+
- PostgreSQL
- Node.js (for Tailwind CSS)
- Poetry
-
Clone the repository:
git clone <repository-url> cd lasfera-app
-
Install dependencies:
poetry install poetry shell
Note: In Poetry version 2+, it is required to install the shell plugin before using
poetry shell. -
Set up environment variables:
cp .env.example .env # Edit .env with your database and other settings -
Run migrations:
python manage.py migrate
-
Create a superuser:
python manage.py createsuperuser
-
Start the development server:
python manage.py runserver
-
In another terminal, install NPM dependencies and start Tailwind CSS watcher:
npm install cd theme/static_src npm install cd ../.. python manage.py tailwind start
Visit http://localhost:8000 to see the application.
For detailed development documentation, see DEVNOTES.rst.
Database schema documentation is available at: https://dbdocs.io/hepplerj/lasfera
This project is developed for academic research purposes at the Roy Rosenzweig Center for History and New Media.