Overview

Ervin
=====

Installing
----------

Requirements
~~~~~~~~~~~~

Django 1.0 or later.

Noid. http://search.cpan.org/dist/Noid/

Solr & solango, for search.

Django atompub, for feeds.

All requirements are installed in the following steps.

Steps
~~~~~

Preliminaries
=============

Install Django 1.1.1 in an appropriate way.

Install Noid::

 $ sudo perl -MCPAN -e "install Noid" # change sudo for your platform as necessary

::

 $ export $PROJECT_DIR=... # fill in the blanks!

 $ cd `dirname $PROJECT_DIR` && django-admin.py startproject `basename $PROJECT_DIR`

 $ cd $PROJECT_DIR && mkdir packages && mkdir lib

Install Ervin
=============

::

 $ cd $PROJECT_DIR/packages && bzr co lp:~egh/ervin/trunk ervin

Setup Noid
==========

::

 $ cd $PROJECT_DIR && noid dbcreate .reeeeek


Install django-atompub
======================

::

 $ cd $PROJECT_DIR/packages && svn co http://django-atompub.googlecode.com/svn/trunk/ django-atompub


Link up
=======

 $ cd $PROJECT_DIR/lib

 $ ln -s ../packages/ervin/ervin

 $ ln -s ../packages/django-atompub/atompub/

To the beginning of ``settings.py``, add the following::

  import os, sys

  sys.path.append(os.path.join(os.path.dirname(os.path.realpath(__file__)), 'lib'))

Use your editor to configure the database in ``settings.py``. Add
``ervin`` and ``django.contrib.admin`` to ``INSTALLED_APPS``, e.g.::

 INSTALLED_APPS = (
     'django.contrib.auth',
     'django.contrib.admin',
     'django.contrib.contenttypes',
     'django.contrib.sessions',
     'django.contrib.sites',
     'ervin'
 )

Edit ``urls.py`` appropriately. For instance::

  from django.conf.urls.defaults import *

  from django.contrib import admin
  admin.autodiscover()

  urlpatterns = patterns('',
      (r'^admin/', include(admin.site.urls)),
      (r'', include('ervin.urls')),
  )

::

 $ python manage.py syncdb

 $ python manage.py runserver

Visit http://localhost:8000/admin and begin adding data!

Search
======

Install::

::

 $ cd $PROJECT_DIR/packages && svn co http://django-solr-search.googlecode.com/svn/trunk/ django-solr-search

 $ cd $PROJECT_DIR/lib && ln -s ../packages/django-solr-search/solango/ .

Add ``solango`` to ``INSTALLED_APPS``::

  INSTALLED_APPS = (
    ...
    'solango'
  )

Tip: Filter by directory path e.g. /media app.js to search for public/media/app.js.
Tip: Use camelCasing e.g. ProjME to search for ProjectModifiedEvent.java.
Tip: Filter by extension type e.g. /repo .js to search for all .js files in the /repo directory.
Tip: Separate your search with spaces e.g. /ssh pom.xml to search for src/ssh/pom.xml.
Tip: Use ↑ and ↓ arrow keys to navigate and return to view the file.
Tip: You can also navigate files with Ctrl+j (next) and Ctrl+k (previous) and view the file with Ctrl+o.
Tip: You can also navigate files with Alt+j (next) and Alt+k (previous) and view the file with Alt+o.