Skip to content

OpenTechSchool/django-101

master
Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?
Code

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
 
 
 
 
 
 

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
  • Views
  • Templates

The online version is available at http://opentechschool.github.com/django-101/.

Setup

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:

  • docutils
  • Pygments
  • Sphinx
  • Fabric

You also need Graphviz, a graph visualization software.

Build

The fabric script fabfile.py contains tasks making the build process very easy. The following commands have to be executed in the docs directory.

If you just want to render the HTML version, it's sufficient to run

fab build

This will create a directory _build inside the docs directory, 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.

fab build:singlehtml

Deploy

The Django 101 Tutorial is deployed as a GitHub Page. A good way to do that is described here. To simplify this process, you can use the fabric target setup.

fab setup

This creates a clone of the repository inside the _build folder. You can now run fab build, change into docs/_build/html, commit and push.

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages