Introduction

This page describes how to checkout the code and get to work testing and/or expanding the code.

To Get the Code

• The code lives here: http://open-scriptures.googlecode.com/svn/branches/django/
• Note that the last stable revision was r240, so please checkout this revision if you want to play with the models and the data in the SQL dump.
• To checkout into the desired directory, with svn, type: svn checkout -r 240 http://open-scriptures.googlecode.com/svn/branches/django/ openscriptures
• To update the code, simply type: svn up

Personal Settings

You must create a file named "local_settings.py" which lives in the same directory as "settings.py" which contains the following information:

   SECRET_KEY
   DATABASE_* constants
   TIME_ZONE 

Building

You may either build the system database from the raw manuscript data from scratch (it may take a few hours to import and merge all of the manuscripts), or you can populate the database with a SQL dump from a database already built (recommended).

To start from scratch, run the commands found in build.sh (or, just run build.sh):

> python manage.py syncdb
> cd data/manuscripts
> python import.py
> python merge.py

To use the SQL dump, download the SQL dump from http://openscriptures.org/files/supplemental_data.sql.zip, extract the contents, and run commands such as:

> python manage.py syncdb
> mysql -u root -p DBNAME < supplemental_data.sql 

Note: If you are getting an error when running python manage.py syncdb you may need make sure that the name of the folder in which the code lives is "openscriptures" and not something else.