my personal blog written with django
JavaScript Python Shell
Switch branches/tags
Nothing to show
Pull request Compare This branch is 15 commits ahead, 35 commits behind brosner:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
apps
cron
deploy
docs
sql
themes
.gitignore
README.rst
TODO
__init__.py
local_settings.py
manage.py
requirements.txt
settings.py
urls.py
views.py

README.rst

title:oebfare README
slug:oebfare_README
Authors: brosner
daonb
active:True
tags:oebfare, docs

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.

License

This source code is licensed under the BSD license.

Dependancies

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!

Installing

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 virtualenvwrapper:

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!

Configuration

All settings should be provided in a local_settings.py file. This file is imported by 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:

  • LOCAL_DEVELOPMENT
  • DEBUG
  • DATABASE_ENGINE
  • DATABASE_HOST
  • DATABASE_NAME
  • DATABASE_PASSWORD
  • DATABASE_PORT
  • DATABASE_USER
  • EMAIL_HOST
  • EMAIL_HOST_PASSWORD
  • EMAIL_HOST_USER
  • EMAIL_PORT
  • EMAIL_SUBJECT_PREFIX
  • EMAIL_USE_TLS
  • MEDIA_URL
  • THEME

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.

Notice the LOCAL_DEVELOPMENT settings. This setting is used to control whether the media in /themes/THEME/static is served up at MEDIA_URL by default when running 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 your browser at http://localhost:8000/. The blog is going to look remarkably like the one at http://oebfare.com/. Welcome to the oebfare world!

First Run

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.

Supported Services

  • github
  • flickr
  • digg
  • wakoopa
  • last.fm
  • DjangoPeople