在前面我们已经陆续学习了六个Django的实例，其中一个来自Django官方的文档，另外五个来自《Django Web开发指南》。舍得介绍的每一个实例，都是按照官方文档的标准，力求让大家在根据文章去做自己的实例时，能够按“文”索骥，轻松再现整个实例的制作过程。

接下来,舍得要介绍一个大型的实例，这个项目叫做Rango，它来自Django圈内口碑甚佳的《How to Tango with Django》一书。事实上，此书就是围绕Rango这一个实例来展开的，而且，作者在介绍实例的时候，尽可能按照官方实例的标准来介绍整个制作过程，对学习者帮助甚大。这个实例已被收入到官方的实例库中（见https://code.djangoproject.com/wiki/Tutorials）。

《How to Tango with Django》并没有正式出版，而是以在线文档的方式来分享，大家可以从这里阅读到这本书的内容：http://www.tangowithdjango.com/book/(这是适用于Django 1.5.4版的，Django 1.7版的可以看这里：http://www.tangowithdjango.com/book17/）。

由于市面上并无该书的PDF或Epub格式下载，舍得从作者的网站上抓取了html文件，重新整理了版面，将其制作成epub的格式电子书，解决因受网速影响而导致阅读不畅的问题。有兴趣的童鞋可以从这里下载：舍得学苑下载中心（此链接为1.7版电子书，据了解，该版本目前尚未正式完成，即仍处于草稿状态，介意的童鞋可下载1.5.4版）

《How to Tango with Django》中的实例显然要比舍得之前分享的六个实例要大得多，但是，不要被它的“大”吓到，它仍然只是一个适合初学者入门的实例。童鞋们可以通过这个实例，复习之前学过的内容，此外，还可以学到一些新的技巧，比如用户登录，Bootstrap，以及更实用的Ajax应用等等。

注意，本实例所用的Django版本为1.7.1,Python版本为3.2，操作系统为Win8。

1.创建项目和应用

我们先来创建本实例的项目，在dos命令提示符下转到Scripts文件夹(如“c:\python32\Scripts”），然后运行如下命令：

$ django-admin startproject rangoproject

然后在dos命令提示符下继续输入如下命令,进入项目文件夹：

cd rangoproject

接下来开始创建应用，在dos命令提示符下输入命令：

$ python manage.py startapp rango

命令执行完后，项目根文件夹下会出现一个叫rango的文件夹，应用创建完毕。

关于项目根文件夹：

当你创建好项目时，你会发现其文件夹的结构会是下面这样：

rangoproject/    manage.py    rangoproject/        __init__.py        settings.py        urls.py        wsgi.py

这里有两个rangoproject文件夹，我们把上面一个叫做项目根文件夹，下面一个（和manage.py并列的）叫做项目配置文件夹。

2.建立模型

编辑rango/models.py文件，改成下面这样：

rango/models.py：

from django.db import modelsclass Category(models.Model):    name = models.CharField(max_length=128, unique=True)    def __str__(self):        return self.nameclass Page(models.Model):    category = models.ForeignKey(Category)    title = models.CharField(max_length=128)    url = models.URLField()    views = models.IntegerField(default=0)    def __str__(self):        return self.title

首先修改rangoproject/settings.py这个文件，找到INSTALLED_APPS这段设置，把它改成下面这个样子：

rangoproject/settings.py：

INSTALLED_APPS = (    ‘django.contrib.admin‘,    ‘django.contrib.auth‘,    ‘django.contrib.contenttypes‘,    ‘django.contrib.sessions‘,    ‘django.contrib.messages‘,    ‘django.contrib.staticfiles‘,    ‘rango‘,)

编辑settings.py的时候，建议顺便修改一下语言和时区的设置，具体的方法请参考：《实战Django：官方实例Part1》

然后在dos命令提示符下运行如下命令：

$ python manage.py makemigrations rango

继续在dos命令提示符下运行命令：

$ python manage.py migrate

这样，数据库就建好了。我们在实例中（包括之前的六个实例）使用的是Django默认的Sqlite3数据库，数据库文件为db.sqlite3,存放在项目根文件夹下，这同样是默认的设置，你可以在settings.py的DATABASES设置中看到。

在dos命令提示符下运行如下命令：

$ python manage.py createsuperuser

然后依次输入admin,你的邮箱，输入两次密码，完成创建管理员的操作。

编辑rango/admin.py 文件，让它变成下面这个样子：

rango/admin.py：

from django.contrib import adminfrom rango.models import Category, Pageclass PageAdmin(admin.ModelAdmin):    list_display = (‘title‘, ‘category‘, ‘url‘)    admin.site.register(Category)admin.site.register(Page, PageAdmin)

6.启动服务器

在dos命令提示符下运行如下命令：

$ python manage.py runserver

http://127.0.0.1:8000/admin/

然后输入你刚才创建的管理员账号和密码，登录管理界面，你可以先尝试添加一些东西，或者，什么都不做。

编辑rangoproject/settings.py这个文件，在文件末加入以下内容：

rangoproject/settings.py：

STATIC_PATH = os.path.join(BASE_DIR, ‘static‘)STATICFILES_DIRS = (    STATIC_PATH,)TEMPLATE_PATH = os.path.join(BASE_DIR, ‘templates‘)TEMPLATE_DIRS = (    TEMPLATE_PATH,)MEDIA_URL = ‘/media/‘MEDIA_ROOT = os.path.join(BASE_DIR, ‘media‘)

其中，STATIC_PATH主要用来存放CSS、JS及图片文件，TEMPLATE_PATH用来存放模板文件（项目中所有的模板文件都放在这里，便于管理），MEDIA_ROOT则是用来存放用户上传的图片之类文件。

下面，我们一一创建上面讲到的文件夹，在项目根文件夹下：

• 创建static文件夹
• 创建templates文件夹
• 创建media文件夹

然后在static文件夹下：

• 创建img文件夹
• 创建js文件夹
• 创建css文件夹

我们来测试一下静态文件的配置，找一张jpg格式的文件，将其命名为rango.jpg（或直接下载这张图片：http://www.tangowithdjango.com/static/rango.jpg），把它放到static/img文件夹下，它的正确路径应该是：

rangoproject/static/img/rango.jpg

在浏览器地址栏内输入:

http://127.0.0.1:8000/static/img/rango.jpg

如果你能看到图片,说明静态文件配置成功了.

【未完待续】

本文版权归舍得学苑所有，欢迎转载，转载请注明作者和出处。谢谢！
作者：舍得
首发：舍得学苑@博客园

实战Django：Rango Part1