Documentation on effectively using Django for building web applications.
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
_build @ 52bdd85
_static
_templates
handouts
scratchpad
src @ 1685ced
tutorial
.gitignore
.gitmodules
.nojekyll
CNAME
LICENSE
Makefile
README.rst
acknowledgments.rst
classbasedviews.rst
conf.py
forms.rst
further-reading.rst
index.rst
intro.rst
middleware.rst
orm.rst
requirements.txt
settings.py
testing.rst

README.rst

Effective Django

This is the repository for the text Effective Django, an ongoing work in progress by Nathan Yergler. The sample code is maintained in the effective-django-tutorial repository.

Effective Django is authored using ReStructured Text and Sphinx. If you're interested in building HTML, PDF, ePub, or other generated formats, you can do so by:

  1. If you want to build PDF or ePub output, make sure LaTeX is installed on your machine. If you only care about HTML output, you can skip this step.

    For Macs, it is recommended you use MacTeX

    $ brew install Caskroom/cask/mactex
    

    If you're building on Ubuntu, you should install the texlive and texlive-latex-extra packages.

    $ sudo apt-get install texlive texlive-latex-extra
    
  2. Check out this repository:

    $ git clone --recursive https://github.com/nyergler/effective-django.git
    

    Note that in order to build Effective Django, the sample code must be cloned into the src submodule. Using --recursive will accomplish that.

  3. Create a virtualenv and install the dependencies:

    $ virtualenv .
    $ . bin/activate
    $ pip install -r requirements.txt
    
  4. Run make:

    $ make all
    

    The output will be in the _build sub-directory.

    To only build HTML, specify the target explicitly:

    $ make html
    

Run make without any parameters for a list of possible targets.