X-Git-Url: https://git.mdrn.pl/redakcja.git/blobdiff_plain/759c804d6c3b8db0ad99dcd5d155396b29ebedd7..afdb8fd05511c5280e8ee251389cb893786eb810:/README.rst?ds=inline diff --git a/README.rst b/README.rst index 8ddf4123..47fad0c8 100644 --- a/README.rst +++ b/README.rst @@ -1,38 +1,40 @@ +==================== Platforma Redakcyjna ==================== Opis projektu -************* +============= Platforma to serwis sÅuÅ¼Ä cy do grupowej edycji ksiÄ Å¼ek na potrzeby serwisu WolneLektury.pl. -Wymagania -********* -* `Django 1.1 <http://djangoproject.com/>`_ -* `django-piston 0.2.3rc1 <http://bitbucket.org/jespern/django-piston/>`_ -* `librarian 1.2 <http://redmine.nowoczesnapolska.org.pl/projects/show/librarian>`_ -* `lxml 2.2.2 <http://codespeak.net/lxml/>`_ -* `Mercurial 1.3.1 <http://www.selenic.com/mercurial/>`_ -* `PIL 1.1.6 <http://www.pythonware.com/products/pil/>`_ (wymagane przez skrypt imgconv.py) -* `pngnq <http://pngnq.sourceforge.net/>`_ (wymagane przez skrypt imgconv.py) -* `zuber/django-cas-consumer <http://github.com/zuber/django-cas-consumer>`_ (wymagane do autoryzacji przez CAS) +Instalacja i użycie +=================== +#. ÅciÄ gnij i zainstaluj `pip <http://pypi.python.org/pypi/pip>`_ +#. Przejdź do katalogu serwisu w konsoli +#. Zainstaluj wymagane biblioteki komendÄ :: + + pip install -r requirements.txt + +#. WypeÅnij bazÄ danych (Django poprosi o utworzenie pierwszego użytkownika):: -Instalacja -********** -1. ÅciÄ gnij i zainstaluj `pip <http://pypi.python.org/pypi/pip>`_ -2. Przejdź do katalogu serwisu w konsoli -3. Zainstaluj wymagane biblioteki (patrz sekcja wymagania_) komendÄ :: + ./project/manage.py syncdb - pip install -f http://redmine.nowoczesnapolska.org.pl/projects/librarian/files -r requirements.txt +#. Skopiuj zawartoÅÄ pliku `project/localsettings.sample` do `project/localsettings.py` i zmieÅ go zgodnie ze swoimi potrzebami. -4. WypeÅnij bazÄ danych (Django poprosi o utworzenie pierwszego użytkownika):: +#. Uruchom serwer deweloperski:: - ./manage.py syncdb + ./project/manage.py runserver -5. Skopiuj zawartoÅÄ pliku `project/localsettings.sample` do `project/localsettings.py` i zmieÅ go zgodnie ze swoimi potrzebami. +#. Zalecane jest serwowanie aplikacji przez `modwsgi <http://code.google.com/p/modwsgi/>`_ na serwerze `Apache2 <http://httpd.apache.org/>`_ przy pomocy zaÅÄ czonego skryptu `dispatch.fcgi`. Inne strategie wdrożeniowe opisane sÄ w `Dokumentacji Django <http://docs.djangoproject.com/en/dev/howto/deployment/#howto-deployment-index>`_. -6. Uruchom serwer deweloperski:: +Wdrożenie +========= +#. ÅciÄ gnij i zainstaluj `fabric <http://docs.fabfile.org/>`_ +#. Przejdź do katalogu serwisu w konsoli +#. Aby wdrożyÄ serwis na serwer deweloperski wpisz komendÄ:: - ./manage.py runserver + fab staging deploy + + Aby wdrożyÄ serwis na serwer produkcyjny wpisz:: -7. Zalecane jest serwowanie aplikacji przez `modwsgi <http://code.google.com/p/modwsgi/>`_ na serwerze `Apache2 <http://httpd.apache.org/>`_ przy pomocy zaÅÄ czonego skryptu `dispatch.fcgi`. Inne strategie wdrożeniowe opisane sÄ w `Dokumentacji Django <http://docs.djangoproject.com/en/dev/howto/deployment/#howto-deployment-index>`_. + fab production deploy