forked from scotu/mightylemon
-
Notifications
You must be signed in to change notification settings - Fork 1
/
README
110 lines (79 loc) · 3.14 KB
/
README
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
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
------------
* Django 1.0.1+
* docutils
* markdown
* pygments
* django-comment-utils (http://github.com/jezdez/django-comment-utils/tree/master)
* django-tagging
* django-mailer
* django-gravatar
* django-elsewhere
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
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_ROOT``
* ``MEDIA_URL``
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 ``MEDIA_ROOT`` 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!