====================
Platforma Redakcyjna
====================
Opis projektu
=============
Platforma to serwis służący do grupowej edycji książek na potrzeby serwisu WolneLektury.pl.
Wymagania
=========
* `Django 1.1 `_
* `django-piston 0.2.3rc1 `_
* `librarian 1.2 `_
* `lxml 2.2.2 `_
* `Mercurial 1.3.1 `_
* `PIL 1.1.6 `_ (wymagane przez skrypt imgconv.py)
* `pngnq `_ (wymagane przez skrypt imgconv.py)
* `zuber/django-cas-consumer `_ (wymagane do autoryzacji przez CAS)
Instalacja i użycie
===================
#. Ściągnij i zainstaluj `pip `_
#. Przejdź do katalogu serwisu w konsoli
#. Zainstaluj wymagane biblioteki (patrz sekcja wymagania_) komendą::
pip install -r requirements.txt
#. Wypełnij bazę danych (Django poprosi o utworzenie pierwszego użytkownika)::
./project/manage.py syncdb
#. Skopiuj zawartość pliku `project/localsettings.sample` do `project/localsettings.py` i zmień go zgodnie ze swoimi potrzebami.
#. Uruchom serwer deweloperski::
./project/manage.py runserver
#. Zalecane jest serwowanie aplikacji przez `modwsgi `_ na serwerze `Apache2 `_ przy pomocy załączonego skryptu `dispatch.fcgi`. Inne strategie wdrożeniowe opisane są w `Dokumentacji Django `_.
Wdrożenie
=========
#. Ściągnij i zainstaluj `fabric `_
#. Przejdź do katalogu serwisu w konsoli
#. Aby wdrożyć serwis na serwer deweloperski wpisz komendę::
fab staging deploy
Aby wdrożyć serwis na serwer produkcyjny wpisz::
fab production deploy