oebfare is the source code that runs the blog at http://oebfare.com. The code is freely available for you to use however you want.
This source code is licensed under the BSD license.
- Django 1.0.1+
- django-comment-utils (http://github.com/jezdez/django-comment-utils/tree/master)
Checking out the source
The source code for oebfare is hosted on GitHub. To clone the code run:
git clone git://github.com/brosner/oebfare.git
There is a mirror of the source code available at oebfare itself:
git clone git://oebfare.com/oebfare.git
You're all set!
To get yourself up and running with oebfare you have two options. Install the dependancies (listed above) manually or grab pip. The preferred way of setting things up is to work with pip and virtualenv. For the former, you are on your own. If you don't have pip or virtualenv here is a quick setup guide:
sudo easy_install pip sudo pip install virtualenv
You don't have to use
sudo, but I did to show you it really should be
installed globally. The last thing I highly recommend is using Doug Hellman's
sudo pip install virtualenvwrapper
Head to http://pypi.python.org/pypi/virtualenvwrapper/ and read the quick setup to get virtualenvwrapper going for yourself. I will assume that is done correctly.
Set up yourself a virtualenv for working with the oebfare code (you can use any env name below):
mkvirtualenv oebfare easy_install pip
Now you are ready to install the dependancies using pip. Make sure you in the root of the oebfare source tree:
pip install -r requirements.txt
You are all set!
All settings should be provided in a
local_settings.py file. This file is
settings.py to override any already defined settings. The only
disadvantage to this method is you don't have access to the original values
to append or modify in place (this shouldn't be a big deal). The most common
settings you should likely need to configure are:
This is by no means a complete list. The most important settings are going to be the database settings. Make sure you set them correctly.
LOCAL_DEVELOPMENT settings. This setting is used to control
whether the media in
/themes/THEME/static is served up at
MEDIA_URL by default
runserver. This is handy for testing, but please do not use it
in production. The setting name should hopefully defer that.
Once you have your database settings configured go ahead and syncdb:
python manage.py syncdb
And finally you can run the development server:
python manage.py runserver
Point the browser to the admin interface at http://localhost:8000/admin/authors/userprofile/add/ to set your personal details. Oebfare supports just one author for now, so make sure
User points to the first user. In
Nickname, enter the account name used in the supported services.