实战Django:Rango Part2
在这一节,我们将学习如何用自动脚本来添加内容,然后给我们的应用添加首页和一个内容页。
9.Part1练习答案
除了加入views和likes两个字段,这里我们需要思考一个问题,用户将如何来访问我们的页面?用/rango/category/1/ 或 /rango/category/2/?他们怎么知道1代表哪个分类,2又代表哪个分类?有没有更直接一点的方法呢?
我想还是直接用分类名称来作为链接的一部分会比较好一些,比如用/rango/category/Python/来访问Python分类这样子。但碰到带空格的分类名称时,链接中的空格会被自动转义,因此,用一个别名来作为链接更为理想。
Django中有一个slugify的方法,它可以把帮助我们自动处理别名,比如我们的分类名是”how do i create a slug in django“,slugify会把它变成”how-do-i-create-a-slug-in-django“。
编辑rango/models.py文件,修改Category类:
rango/models.py:
from django.template.defaultfilters import slugify class Category(models.Model): name = models.CharField(max_length=128, unique=True) views = models.IntegerField(default=0) likes = models.IntegerField(default=0) slug = models.SlugField(unique=True) def save(self, *args, **kwargs): self.slug = slugify(self.name) super(Category, self).save(*args, **kwargs) def __str__(self): return self.name
然后依次在dos命令提示符下运行如下命令:
$ python manage.py makemigrations rango
$ python manage.py migrate
注意:在model.py中对模型中的字段进行修改后,必须执行上述命令才能把数据库跟着改动。
加入slug字段后,我们希望在管理界面中输入分类名称时,自动生成slug字段,这个可以通过修改admin.py来实现。
编辑rango/admin.py 文件,让它变成下面这个样子:
rango/admin.py:
from django.contrib import admin from rango.models import Category, Page class PageAdmin(admin.ModelAdmin): list_display = ('title', 'category', 'url') class CategoryAdmin(admin.ModelAdmin): prepopulated_fields = {'slug':('name',)} admin.site.register(Category, CategoryAdmin) admin.site.register(Page, PageAdmin)
10.创建自动化脚本
这一次我们不再手动输入内容,而是采用自动化脚本的形式:用一个脚本来自动添加内容。
在项目根文件夹下创建populate_rango.py,加入如下内容:
rangoproject/populate_rango.py:
#!/usr/bin/env python import os import django def populate(): python_cat = add_cat('Python') add_page(cat=python_cat, title="Official Python Tutorial", url="http://docs.python.org/3/tutorial/") add_page(cat=python_cat, title="How to Think like a Computer Scientist", url="http://www.greenteapress.com/thinkpython/") add_page(cat=python_cat, title="Learn Python in 10 Minutes", url="http://www.korokithakis.net/tutorials/python/") django_cat = add_cat("Django") add_page(cat=django_cat, title="Official Django Tutorial", url="https://docs.djangoproject.com/en/1.7/intro/tutorial01/") add_page(cat=django_cat, title="Django Rocks", url="http://www.djangorocks.com/") add_page(cat=django_cat, title="How to Tango with Django", url="http://www.tangowithdjango.com/") frame_cat = add_cat("Other Frameworks") add_page(cat=frame_cat, title="Bottle", url="http://bottlepy.org/docs/dev/") add_page(cat=frame_cat, title="Flask", url="http://flask.pocoo.org") # 输出我们添加的内容. for c in Category.objects.all(): for p in Page.objects.filter(category=c): print ("- {0} - {1}".format(str(c), str(p))) def add_page(cat, title, url, views=0): p = Page.objects.get_or_create(category=cat, title=title, url=url, views=views)[0] return p def add_cat(name): c = Category.objects.get_or_create(name=name, defaults=None)[0] return c # 开始执行! if __name__ == '__main__': print ("开始执行Rango自动化脚本...") os.environ.setdefault('DJANGO_SETTINGS_MODULE', 'rangoproject.settings') django.setup() from rango.models import Category, Page populate()
我们来运行这个脚本,在dos命令提示符下输入命令:
python populate_rango.py
你会看到象这样的提示:
开始执行Rango自动化脚本... - Python - Official Python Tutorial - Python - How to Think like a Computer Scientist - Python - Learn Python in 10 Minutes - Django - Official Django Tutorial - Django - Django Rocks - Django - How to Tango with Django - Other Frameworks - Bottle - Other Frameworks - Flask
这个脚本自动往数据库里添加了三个分类,并在各个分类下添加了数量不等的页面数据。
我们来看一下这些数据添加后的效果。重新启动Django服务器,然后在浏览器地址栏里输入:
http://127.0.0.1:8000/admin/
按回车进入登录页面,输入账号和密码,登录成功后,点击链接“Pages”,可看到如下页面:
写这样一个脚本虽然要花上一点时间,但你若是在一个团队中做这个项目,你可以把这个脚本分发给团队中的其他人,那样,他们就可以很快创建好数据库。此外,这个脚本在测试中亦会派上用场。
11.在首页上显示分类
我们来回顾一下,要完成某页面显示,需要做哪些操作?
- 编写视图
- 创建模板
- 设计URL
下面我们来一一完成。先编辑rango/views.py 文件,让它变成下面这样:
rango/views.py:
from django.shortcuts import render from rango.models import Category def index(request): # 查询数据库中的所有分类; # 用likes字段排序; # 只显示前5个字段; # 把列表存入context_dict字典,再把这个字典传给模板引擎; category_list = Category.objects.order_by('-likes')[:5] context_dict = {'categories': category_list} # 把context_dict字典传给模板引擎; return render(request, 'rango/index.html', context_dict)
接下来我们来编辑首页模板,在templates文件夹(位于项目根文件夹下)中创建一个rango文件夹,然后在该文件夹下新建一个index.html文件,加入如下内容:
rangoproject/templates/rango/index.html:
<!DOCTYPE html> <html> <head> <title>Rango</title> </head> <body> <h1>欢迎来到Rango!</h1> {% if categories %} <ul> {% for category in categories %} <li>{{ category.name }}</li> {% endfor %} </ul> {% else %} <strong>目前还没有可用分类。</strong> {% endif %} </body> </html>
Tips:建议把所有的模板文件储存为UTF-8编码。
在{% if categories %} 这个语句中的categories ,就是我们视图里context_dict字典的数据,“if”是用来判断它是否存在。若存在,则用“for”语句把它逐条取出来——因为categories 是一个列表。
最后我们来设计URL,在rango文件夹下创建一个叫url.py的文件,然后添加如下内容:
rango/urls.py :
from django.conf.urls import patterns, url from rango import views urlpatterns = patterns('', url(r'^$', views.index, name='index'))
编辑rangoproject/urls.py 文件,让它变成下面这样:
rangoproject/urls.py :
from django.conf.urls import patterns, include, url from django.contrib import admin urlpatterns = patterns('', url(r'^admin/', include(admin.site.urls)), url(r'^rango/', include('rango.urls')), )
好了,让我们在浏览器中访问一下http://127.0.0.1:8000/rango/,你会看到这样的页面:
12.创建内容页
现在,分类是显示出来了,我们还希望用户进入分类后,能看到每个分类里的内容。
先编写视图,编辑rango/views.py 文件,先在头部加入一行:
rango/views.py:
from rango.models import Page
然后加入如下内容:
rango/views.py:
def category(request, category_name_slug): # 定义要传递给模板引擎的context_dict字典。 context_dict = {} try: # 是否能匹配到给定的分类别名? # 如果匹配不到,.get() 方法会提交一个DoesNotExist的异常; # 匹配到的话,我们就用它来在Page表中检索出该分类的数据; category = Category.objects.get(slug=category_name_slug) context_dict['category_name'] = category.name # 获取该分类下的所有页面; pages = Page.objects.filter(category=category) # 把获取到的数据存入context_dict; context_dict['pages'] = pages # 我们把分类名称也加入到context_dict中,这个值可用来在模板中校验分类是否存在。 context_dict['category'] = category except Category.DoesNotExist: # 如果找不到分类,那么啥都不做; # 模板会显示“没有分类”的信息; pass return render(request, 'rango/category.html', context_dict)
现在我们来创建模板,在templates/rango文件夹下新建一个category.html文件,加入如入内容:
rangoproject/templates/rango/category.html:
<!DOCTYPE html> <html> <head> <title>Rango</title> </head> <body> <h1>{{ category_name }}</h1> {% if category %} {% if pages %} <ul> {% for page in pages %} <li><a href="{{ page.url }}">{{ page.title }}</a></li> {% endfor %} </ul> {% else %} <strong>当前分类下尚无可用页面.</strong> {% endif %} {% else %} 指定的分类名称 {{ category_name }} 不存在! {% endif %} </body> </html>
接下来我们重新设计URL,编辑rango/url.py的文件,把它变成下面这样:
rango/urls.py :
from django.conf.urls import patterns, url from rango import views urlpatterns = patterns('', url(r'^$', views.index, name='index'), url(r'^category/(?P<category_name_slug>[\w\-]+)/$', views.category, name='category'), )
除了这些,我们还需要修改一下首页的模板,让分类名称加上链接。编辑index.html,把它改成这样:
rangoproject/templates/rango/index.html:
<!DOCTYPE html> <html> <head> <title>Rango</title> </head> <body> <h1>欢迎来到Rango!</h1> {% if categories %} <ul> {% for category in categories %} <!-- 下面这行给分类加入了超链接 --> <li><a href="/rango/category/{{ category.slug }}">{{ category.name }}</a></li> {% endfor %} </ul> {% else %} <strong>目前还没有可用分类。</strong> {% endif %} </body> </html>
我们来检查一下工作成果
我们先访问首页,你会看到首页中列出了当前所有的分类,这些分类都是超链接。我们点击“Django”分类,这样,Django分类中的所有页面都显示出来了,点击“Official Django Tutorial”链接,它将会把我们带到Django官方实例的页面。
13.练习
1)创建一个”about”视图,关联的模板文件为about.html;
2)模板的标题叫“关于Rango”,可自由添加一些文字,但需要插入一个叫rango.jpg的图片(图片下载地址请看part1),图片存放在static文件夹下。
【未完待续】
本文版权归舍得学苑所有,欢迎转载,转载请注明作者和出处。谢谢!
作者:舍得
首发:舍得学苑@博客园