Django 101 Tutorial
The Django 101 Tutorial is an adaption of http://www.django-workshop.de for the OpenTechSchool PyCoaches workshops. While creating a cookbook application, you will get to know following aspects of Django:
- Django setup/configuration
- Models and object-relational mapping
- Django's admin interface
- URL routing
The online version is available at http://opentechschool.github.com/django-101/.
The Django 101 Tutorial is written in the reStructuredText format. The
.rst files can be edited with a normal text editor.
It can be rendered to several output formats using Sphinx. To do that, you need to have the following Python packages installed:
You also need Graphviz, a graph visualization software.
The fabric script
fabfile.py contains tasks making the build process very
easy. The following commands have to be executed in the
If you just want to render the HTML version, it's sufficient to run
This will create a directory
_build inside the
containing the HTML version.
Other builders can be
passed as argument. For instance use
singlehtml to render the whole
tutorial into a single HTML file.
This creates a clone of the repository inside the
_build folder. You can
fab build, change into
docs/_build/html, commit and push.