Introduction
============

Pathagar is a simple book server.  It uses the OPDS spec:

http://opds-spec.org

Books can be added via the admin interface, as well as via the command
line, in batch (using CSV files, JSON files or a directory with EPUB
files), through the command:

  python manage.py addbooks
            OR
  python manage.py addepub

Format of CSV file
==================

To add books from a CSV file:

  python manage.py addbooks books.csv

The format of the CSV file is like:
  "Path to ebook file","Title","Author","Description"

If you need to add more fields, please use the JSON file.

Format of JSON file
===================

To add books from a JSON file:
  
  python manage.py addbooks --json books.json

The format of the JSON file is like::
  [
    {
      "book_path": "Path to ebook file",
      "a_title": "Title",
      "a_author": "Author",
      "a_status": "Published",
      "a_summary": "Description",
      "tags": "set, of, tags"
    },
    ...
  ]

You can add more fields.  Please refer to the Book model.

Dependencies
============

* django-tagging
* django-sendfile

Quickstart
==========

* Install Django.  Pathagar is known to be working in Django 1.3,
  but it may work in 1.2.  This should work:

    easy_install Django

* Install dependencies,

    easy_install django-tagging
    easy_install django-sendfile

* In the Pathagar folder edit settings.py to suite your needs and
  environment.

* In the Pathagar folder, run

    python manage.py syncdb

  You will be asked to create an admin user during this stage.

* To run the server, run

   python manage.py runserver

  This starts a server listening on localhost, port 8000

* With your browser, access http://localhost:8000 and see if the index
  page comes up. If it comes up, click on "Add books" in the footer to
  start adding books. You will be asked for a username/password. This is
  the admin username/password you supplied while running syncdb.

  NOTE: You can also mass add books via the command line through CSV files
        or by simply pointing to a directory with a set of EPUB files.

* To run the server in a production environment, look at Django deployment
  docs at : http://docs.djangoproject.com/en/1.1/howto/deployment/