Diff for "ObpLovelyPython/AbtDjango" - Woodpecker Wiki for CPUG

Differences between revisions 4 and 5
Rendering of reStructured text is not possible, please install Docutils.

:status: 草稿 ;HuangYi; 80%;

.. contents::

=======================
开门见山 Django快速体验
=======================

开门见山
========

Python 世界最火爆的 web 框架。提倡将 project 分解成可重有的 app。
存在大量开源的 app 可以直接拿来用，以迅雷不及掩耳之势搭建复杂的 web 应用。

下载安装
=========

从官方网站（http://www.djangoproject.com/）下载最新版本，解压，执行 python setup.py install 。然后旅程开始。

快速起步
=========

安装完django后，就该创建项目了。打开一个命令行窗口，找个目录，然后跟我输命令吧。
::

  创建项目：
  >django-admin.py startproject simple_wiki
  进入项目的目录：
  >cd simple_wiki
  启动测试服务器：
  \simple_wiki>manage.py runserver
  Validating models...
  0 errors found
  ...

现在打开个浏览器访问 http://localhost:8000/ ，就可以看到一个欢迎页面了：

<截图>

OK，我们先把这个命令行窗口留着别关，里面启动着 django 的开发web服务器呢。

下面我们得配置下数据库先，图方便，我们就直接使用python2.5自带的数据库引擎 sqlite 吧。编辑 settings.py ，设置以下两项： ::

  DATABASE_ENGINE = 'sqlite3'
  DATABASE_NAME = 'data.db'

如果你恰好和我一样，在中国大陆并且母语汉语，那就顺便再设置这样两项： ::

  TIME_ZONE = 'Asia/Shanghai'
  LANGUAGE_CODE = 'zh-CN'

再把自带的 admin app 启用了，找到 INSTALLED_APPS ，在里面加一行如下： ::

  INSTALLED_APPS = (
      ...
      'django.contrib.admin',
  )

我们再给自动的 admin 后台管理界面设置一个访问的入口，也就是 url。编辑 urls.py 文件，去掉第三、四行和倒数第二行的注释即可： ::

  ...
  from django.contrib import admin
  admin.autodiscover()
  ...
      (r'^admin/(.*)', admin.site.root),
  )

然后，创建下数据库。打开一个新的命令行窗口并切换到 simple_wiki 目录，执行命令： ::

  \simple_wiki>manage.py syncdb
  Creating table auth_permission
  ...

注意：中间需要你输入一个超级用户名、EMail和密码，请记住用户名和密码，等下登陆管理后台有用的。如果忘了可以 data.db 删掉，重新生成下数据库。

现在打开浏览器，访问 http://localhost:8000/admin/ ，就可以欣赏 django 自带的 admin 后台管理模块了，后面你会看到，你还可以很轻松地往里面添加你自己 app 的后台管理。

建立Model
============

配置完成后，我们就写个超级简单的 wiki 试试吧。由于对于 django 来说，一个 project 就是一堆 app 的组合，在我们编写功能前，需要先建一个 app ： ::

  \simple_wiki>manage.py startapp wiki

然后我们在配置里面启用这个 app ，修改 settings.py 在 INSTALLED_APPS 里面增加一行： ::

  'simple_wiki.wiki',

然后修改 wiki\models.py ，填充如下代码（model api：TODO url）： ::

  # coding: utf-8
  from django.db import models

  # 代表 wiki 页面的 Model
  class WikiPage(models.Model):
      title = models.CharField(u'页面标题', maxlength=255)
      content = models.TextField(u'页面内容')
      class Meta:
    # 在显示在管理后台中名字
    verbose_name = verbose_name_plural = u'Wiki页面'

  from django.contrib import admin
  # 注册到管理后台
  admin.site.register(WikiPage)

记得要保存成 utf-8 编码的文件，本教程中所有文件一律保存成 utf-8 编码的。

然后创建相应的数据表。执行命令： ::

  \simple_wiki>manage.py syncdb
  Creating table wiki_wikipage

现在再去看下 http://localhost:8000/admin/ ，是不是发现里面有了Wiki页面的管理后台了？哈哈，爽吧。
（定制admin：URL）

现在不妨利用这个管理后台在里面添加一个标题为 FrontPage 的页面。

《截图》

展示页面
=========

现在我们再写点代码把数据库里的 wiki 页面展示出来。修改 wiki\views.py ，填充以下内容 ： ::

  # coding: utf-8
  from django.shortcuts import render_to_response, get_object_or_404
  from simple_wiki.wiki.models import WikiPage

  def view_page(request, title='FrontPage'):
      # 根据 title 查询页面数据，如果不存在自动显示 404 错误页面。
      page = get_object_or_404(WikiPage, title=title)
      # 渲染模板。
      return render_to_response('page_view.html', {'page':page})

现在，MTV 的 M（Model）和V（View）都有了，下面我们就增加个 T（Template），在 wiki 目录下面创建目录 templates ，在里面创建模板文件 page_view.html ，内容如下： ::

  <html>
    <head>
      <title>{{ page.title }}</title>
    </head>
    <body>
      {{ page.content }}
    </body>
  </html>

模板文件中使用 {{ }} 表示把中间的对象的值填充在相应的位置。模板中还有许多其他的语法，比如分支、循环、继承等，详见文档（）。

最后我们再给页面展示设置一个 url，修改 urls.py ，增加一条 url 映射规则如下： ::

  urlpatterns = patterns('',
      ...
      (r'^simple_wiki/(\w+?)/?$', 'simple_wiki.wiki.views.view_page'),
      ...


然后访问 http://localhost:8000/simple_wiki/FrontPage ，就可以看到刚才在后台里面添加的那个页面了。

处理表单
=========

现在如果我们访问一个不存在的 wiki 页面，比如 http://localhost:8000/simple_wiki/Python ，会得到一个 404 页面。这显然还不够好，应该提示用户去创建相应的页面。修改 wiki/views.py 页面如下： ::

  # coding: utf-8
  from django.shortcuts import render_to_response, get_object_or_404
  from django import forms
  from simple_wiki.wiki.models import WikiPage

  # 让 django 从 WikiPage 这个 model 自动产生的 form，然后把 title 的 widget 改成隐藏表单。
  class WikiPageForm(forms.ModelForm):
      title = forms.CharField(widget=forms.HiddenInput())
      class Meta:
    model = WikiPage

  def view_page(request, title='FrontPage'):
      try:
    page = WikiPage.objects.get(title=title) # 查询一个页面对象
      except WikiPage.DoesNotExist:
    # 如果数据不存在，显示内容提示用户创建相应页面
    return render_to_response('page_empty.html', {title:title})
      else:
    # 页面存在，则显示这个页面。
    return render_to_response('page_view.html', {'page':page})

在 wiki\templates 目录下再添加一个模板 page_empty.html，内容如下： ::

  <html>
    <head>
      <title>页面{{ title }}不存在</title>
    </head>
    <body>
      <h1>页面{{ title }}不存在，<a href="{{ title }}/edit">创建该页面</a></h1>
    </body>
  </html>

然后访问 http://localhost:8000/simple_wiki/Python ，是不是发现有了一个提醒用户创建页面的链接。

不过现在链接后面还没有真正创建页面的功能。下面我们继续编写代码，由于创建页面和编辑页面之间很相似，两个功能可以一起完成。在 wiki/views.py 文件顶部增加一行导入： ::

  # HttpResponseRedirect 继承自 HttpResponse，代表页面跳转的 response
  from django.http import HttpResponseRedirect

再添加一个 view 函数 edit_page 如下： ::

  def edit_page(request, title):
      if request.method == 'GET':
          # 如果是 GET 请求，输出编辑框
          try:
              # 根据 tite 查询 wiki页面
              page = WikiPage.get(title=title)
          except WikiPage.DoesNotExists:
              # 如果不存在该页面，则显示一个创建表单
              form = WikiPageForm()
          else:
              # 否则，显示一个编辑表单
              form = WikiPageForm(instance=page)
          return render_to_response('page_edit.html', {'form':form})
      else:
          # 如果是表单提交，则保存相应的wiki页面数据
          form = WikiPageForm(request.POST)
          if form.errors:
              # 表单验证失败，需要提示用户修改输入内容
              return render_to_response('page_edit.html', {'form':form})
          page = form.save()
          # 数据保存成功，跳转到展示页面的地址
          return HttpResponseRedirect('/simple_wiki/'+page.title)

在 wiki\templates 目录下增加显示页面编辑表单的模板 page_edit.html ，内容如下： ::

  <html>
    <head>
      <title>创建页面{{ title }}</title>
    </head>
    <body>
      <form method="post" action="">
        {{ form }}
        <br/>
        <input type="submit" value="提交"/>
      </form>
    </body>
  </html>

最后在 urls.py 中配置页面编辑的 url： ::

  (r'^simple_wiki/(\w+?)/edit/?$', 'simple_wiki.wiki.views.edit_page'),

现在访问一个不存在 wiki 页面，比如： http://localhost:8000/simple_wiki/Python ，点击创建页面链接，填写表单，点击提交，然后跳转到展示的页面。

到这里，这个 wiki 就算是顺利完工了！

但是在这最后的最后，我还是忍不住要再向您展示一次 django 的非凡魅力。假如，您在这个时候突然发现需要做一点小改动，比如说，每个 wiki 页面还应该记录下它的创建者的邮箱，以便后期管理。