A revival of Django Book, the comprehensive guide to Django, overhauling it for Django 1.4 compatibility
Python CSS Perl JavaScript Shell
Pull request Compare This branch is 42 commits ahead, 23 commits behind mariuz:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
ODT
bin
en
extra
site
.gitignore
LICENSE
Makefile
README.rst
notes-matt.txt
notes-orignal.txt

README.rst

Django Book Revival

A revival of Django Book, the comprehensive guide to Django.

I learned Django from this book originally and felt it was a great resource. Now that Django has (finally) moved on, it would be great to bring the book back up to date.

A current work in progress. If you'd like to help, please do. There's plenty of work to be done!

Goals

The goal is to overhaul this book with Django 1.5 compatibility and hopefully keep it up to date with Django 1.5 and beyond!

  • Update content and project idioms to be Django 1.5 compatible
  • Approach Django advice with a pragmatic attitude, that respects the times and tools currently available.
  • Remove deprecated Django 1.2 and 1.3 content/idioms
  • Work toward a release that is peer reviewed before Django 1.6 launches
  • Repeat for Django 1.7 and beyond!

Current Status

The latest version is always available at ReadTheDocs: http://django-book.readthedocs.org/en/latest/

See the project issues for more current status: https://github.com/askedrelic/django-book/issues

Errata

This book is a fork from the original source code used in the Djagno 1.0 book. Multiple forks exist and code/advice may be in different states of progress.

Development

Assuming you have Python installed, the only dependency is sphinx, available via pip:

pip install sphinx

Build from the top directory:

make build

And now the latest HTML documentation will be waiting in en/_build/html/

Contribute

Want to contribute some changes?

Pull requests or discussion is pretty open right now, submit what you think will help via GitHub.

License

From http://djangobook.com/, the original First Edition of The Django book content was released under the GNU Free Documentation License.

Since the Second Edition, which this project was created from, was also released on http://djangobook.com/, assuming the same license, this project is also released under the GNU Free Documentation License.

Meta