Rewrite to Django from scratch. Now it's much more user-friendly.
[cookbook.git] / README
1 Cookbook is a recipe manager written in Python_ using the Django_
2 framework.
3
4 Install
5 =======
6
7 Download
8 --------
9
10 Cookbook is published as a Git_ repository.  See `cookbook's web
11 interface`__ for more information.
12
13 __ cookbook_
14
15 Dependencies
16 ------------
17
18 Outside of Django_ and the Python_ standard libraries, the only
19 required dependency is `django-taggit`_ (docs__).
20
21 __ dt2-docs_
22
23 Quick-start
24 ===========
25
26 If you don't have a Django project and you just want to run cookbook as
27 a stand-alone service, you can use the example project written up in
28 `example`.  Set up the project (once)::
29
30   $ python example/manage.py syncdb
31
32 See the `Django documentation`_ for more details.
33
34 Run
35 ===
36
37 Run the app on your local host (as many times as you like)::
38
39   $ python example/manage.py runserver
40
41 You may need to add the current directory to `PYTHONPATH` so `python`
42 can find the `cookbook` package.  If you're running `bash`, that will
43 look like
44
45   $ PYTHONPATH=".:$PYTHONPATH" python example/manage.py runserver
46
47 Hacking
48 =======
49
50 This project was largely build following the `Django tutorial`_.
51 That's a good place to start if you're new to Django.
52
53 .. _Python: http://www.python.org/
54 .. _Django: https://www.djangoproject.com/
55 .. _Git: http://git-scm.com/
56 .. _cookbook: http://physics.drexel.edu/~wking/code/git/gitweb.cgi?p=cookbook.git
57 .. _django-taggit: https://github.com/alex/django-taggit
58 .. _dt2-docs: http://django-taggit.readthedocs.org/en/latest/
59 .. _Django documentation: https://docs.djangoproject.com/
60 .. _Django tutorial: https://docs.djangoproject.com/en/1.3/intro/tutorial01/