README.markdown

   1 Philo is a foundation for developing web content management systems.
   2
   3 Prerequisites:
   4
   5  * [Python 2.5.4+ &lt;http://www.python.org&gt;](http://www.python.org/)
   6  * [Django 1.3+ &lt;http://www.djangoproject.com/&gt;](http://www.djangoproject.com/)
   7  * [django-mptt e734079+ &lt;https://github.com/django-mptt/django-mptt/&gt;](https://github.com/django-mptt/django-mptt/)
   8  * (Optional) [django-grappelli 2.0+ &lt;http://code.google.com/p/django-grappelli/&gt;](http://code.google.com/p/django-grappelli/)
   9  * (Optional) [south 0.7.2+ &lt;http://south.aeracode.org/)](http://south.aeracode.org/)
  10  * (Optional) [recaptcha-django r6 &lt;http://code.google.com/p/recaptcha-django/&gt;](http://code.google.com/p/recaptcha-django/)
  11
  12 To contribute, please visit the [project website &lt;http://philo.ithinksw.org/&lt;](http://philo.ithinksw.org/). Feel free to join us on IRC at [irc://irc.oftc.net/#philo](irc://irc.oftc.net/#philo).
  13
  14 Using philo
  15 ===========
  16
  17 After installing philo and mptt on your python path, make sure to complete the following steps:
  18
  19 1. add 'philo.middleware.RequestNodeMiddleware' to settings.MIDDLEWARE_CLASSES.
  20 2. add 'philo' and 'mptt' to settings.INSTALLED_APPS.
  21 3. include 'philo.urls' somewhere in your urls.py file.
  22 4. Optionally add a root node to your current Site.
  23
  24 Philo should be ready to go!
  25
  26 If you are using philo.contrib.gilbert, you will additionally need to complete the following steps:
  27
  28 1. add 'django.core.context_processors.request' to settings.TEMPLATE_CONTEXT_PROCESSORS