1. Lukasz Balcerzak
  2. django-projector


Lukasz Balcerzak  committed 5f03745

Removed some not needed requirements and updated installation docs

  • Participants
  • Parent commits 0b148b3
  • Branches default

Comments (0)

Files changed (3)

File docs/installation.rst

View file
  • Ignore whitespace
 ``django-projector`` is aimed to work with Django 1.2 or later. Moreover, we
-strongly suggest to use ``virtualenv`` and ``virtualenvwrapper`` - great tools
+strongly suggest to use `virtualenv`_ and `virtualenvwrapper`_ - great tools
 for creating temporary environment to work on.
-Following packages are needed to get ``django-projector`` working:
+Requirements should be installed along with projector itself by the setuptools.
+There is also ``requirements.txt`` file at the root of source distribution with
+all needed packages. To install dependencies one should run pip [1]_ command::
-- `Django`_ >= 1.2
-- `django-autoslug`_
-- `django-celery`_
-- `django-extensions`_
-- `django-gravatar`_
-- `django-guardian`_
-- `django-pagination`_
-- `django-richtemplates`_
-- `django-sorting`_
-- `django-tagging`_
-- `django-treebeard`_
-- `celery`_
-- `vcs`_
-- `docutils`_
-- `Pygments`_
-- `Mercurial`_
+    pip install -r requirements.txt
+Trying it out
+``django-projector`` comes with boundled example project. It can be easily used
+- refer to :ref:`this document <example-project>` for more details.
 .. [1] `pip <http://pip.openplans.org/>`_ is tool similar to `easy_install
     <http://pypi.python.org/pypi/setuptools>`_ with some more power (like
     smooth integration with `virtualenv <http://virtualenv.openplans.org/>`_,
-    ``freeze`` command, package uninstallation and others.
+    ``freeze`` command, package uninstallation, search and others.
-.. _celery: http://pypi.python.org/pypi/celery/
-.. _django: http://www.djangoproject.com
-.. _django-autoslug: http://bitbucket.org/neithere/django-autoslug/
-.. _django-celery: http://pypi.python.org/pypi/django-celery/
-.. _django-extensions: http://code.google.com/p/django-command-extensions/
-.. _django-gravatar: http://github.com/DrMegahertz/django-gravatar
-.. _django-guardian: http://packages.python.org/django-guardian/
-.. _django-pagination: http://code.google.com/p/django-pagination/
-.. _django-richtemplates: http://bitbucket.org/lukaszb/richtemplates/
-.. _django-sorting: http://github.com/directeur/django-sorting
-.. _django-tagging: http://code.google.com/p/django-tagging/
-.. _django-treebeard: http://bitbucket.org/tabo/django-treebeard/
-.. _docutils: http://docutils.sourceforge.net/
-.. _pygments: http://pygments.org/
-.. _mercurial: http://mercurial.selenic.com/
-.. _vcs: http://bitbucket.org/marcinkuzminski/vcs/
+.. _virtualenv: http://pypi.python.org/pypi/virtualenv
+.. _virtualenvwrapper: http://pypi.python.org/pypi/virtualenvwrapper

File docs/usage/example_project.rst

View file
  • Ignore whitespace
 Before we can run example project we need to include media files. Thanks to
 `django-richtemplates`_ this is as easy as running one management command::
-   python manage.py import_media richtemplates projector
+    python manage.py import_media richtemplates projector
 This would fetch all necessary media files and put them into ``MEDIA_ROOT``
 defined at settings module.
 Now we need to create database (we use ``sqlite3`` backend for sample project).
 Type following command::
-   python manage.py syncdb
+    python manage.py syncdb
-Step 3 - finalize
+Step 3 - fire up a worker
+We need to run a celery worker for some heavy jobs to be done asynchronously.
+As we use celery_ we need to start it at one terminal::
+    python manage.py celeryd -l DEBUG
+Step 4 - finalize
-In fact there is no step 3 - simply run development server::
+In fact there is no step 4 - simply run development server::
-   python manage.py runserver
+    python manage.py runserver
 ... and open ``http://localhost:8000`` location in a browser.
+.. _celery: http://celeryproject.org/
 .. _django-richtemplates: http://bitbucket.org/lukaszb/django-richtemplates/

File example_project/settings.py

View file
  • Ignore whitespace
     # External
-    'debug_toolbar',
-    'djangodblog',
-    'tagging',