这篇应该是2017年的最后一篇博客了，在这里首先祝大家元旦快乐！

从这篇博客开始，将会介绍Blogs App的功能实现，包括数据模型的建立、相关功能的视图函数的实现、前端页面的设计等，这意味着我们即将可以书写真正的博客了。

首先来建立我们的Blogs App，方法同建立Users App，即在manage.py目录下输入以下命令：

python3 manage.py startapp blogs

在建立了Blogs App后，我们首先要建立它的数据模型。Blogs App包括三张表：Blog、Comment和Category。Blog表包括博客的标题、作者等主要信息；Comment存储博客的评论内容，而Category是博客的分类。Blog表的model如下：

# blogs/models.py

# -*- coding=utf-8 -*-

from django.db import models

from users.models import Users

from ckeditor_uploader.fields import RichTextUploadingField

from django.utils import timezone

class Blog(models.Model):

    title = models.CharField(max_length=32,verbose_name=u'标题')

    auther = models.ForeignKey(Users,default='')

    category = models.ForeignKey(Category,null=True)

    content = RichTextUploadingField(verbose_name=u'内容')

    createdate = models.DateTimeField('Create time',default=timezone.now())

    modifydate = models.DateTimeField('Modify time',default=timezone.now())

    readcount = models.IntegerField(default=0)

    # Add comment count

    commentcount = models.IntegerField(default=0,null=True,blank=True)

    draft = models.BooleanField(default=True)

    @classmethod

    def create(cls,title,authername,category,content,createdate,modifydate):

        blog = cls(title=title,auther=authername,category=category,content=content,createdate=createdate,modifydate=modifydate)

        return blog

    def __unicode__(self):

        return self.title

Blog model的字段如下：

title: 博客标题，最长32

auther： 作者，是Users的外键

category： 类别，是Category的外键

content： 博客的正文。这里使用了CKeditor编辑器提供的富文本域来存储博客的正文，以便之后的图文混排操作。CKeditor的部分将在后面介绍。

createdate： 博客的发表时间，这里的时间用的是timezone.now()，即使用settings.py中定义的时区来决定当前的时间。

modifydate： 博客的修改时间

readcount： 博客的阅读数

commentcount： 博客拥有的评论数

draft： 草稿标记，当为True时表示博客为草稿状态，将不会在主页出现；当为False时博客为正文状态，将在正文出现。

下面是Category model和Comment model:

# blogs/models.py

# ...

class Category(models.Model):

    categoryname = models.CharField(max_length=8,unique=True)

    blogcount = models.IntegerField()

    def __unicode__(self):

        return self.categoryname

class Comment(models.Model):

    attachedblog = models.ForeignKey(Blog)

    content = models.TextField()

    auther = models.ForeignKey(Users,default='')

    createtime = models.DateTimeField('Comment Create time')

    @classmethod

    def create(cls,attachedblog,content,authername,createtime):

        comment = cls(attachedblog=attachedblog,auther=authername,content=content,createtime=createtime)

        return comment

    def __unicode__(self):

        return self.content

Category model比较简单，只有两个字段：categoryname类别名和blogcount博客数量。

Comment model相对复杂一些：

attachedblog：每篇评论都要属于一篇博客，该字段表明评论属于哪篇博客

content：评论内容

auther：评论的作者

createtime：评论的发表时间

在建立好这些model后，和Users App一样，我们来做一些基本的配置工作：在blogs/apps.py和blogs/admin.py中注册这些model和App，并将Blogs App加入到myblog/settings.py中。

# blogs/apps.py

from django.apps import AppConfig

class BlogsConfig(AppConfig):

    name = 'blogs'

# blogs/admin.py

from django.contrib import admin

from .models import Blog,Category

# Register your models here.

admin.site.register(Blog)

admin.site.register(Category)

# myblog/settings.py

# ...

INSTALLED_APPS = [

    'blogs.apps.BlogsConfig',

    'users.apps.UsersConfig',

    # ...

]

# ...

在完成了这些琐碎的小配置后，我们就可以开始编写我们的视图函数了。Blogs App涉及到的视图函数相对比较复杂，因此在这篇博客中先介绍三个核心功能的后端实现：浏览、发布博客以及保存草稿。

首先来看浏览功能的实现。浏览功能，即根据Blog的id得到其相关内容并显示在页面上，相对比较简单，代码如下：

# blogs/views.py

def content(request,blogId):

    blog = Blog.objects.get(id=blogId)

    comment = Comment.objects.filter(attachedblog=blog)

    request.session['currblogId'] = blogId

    blog_title = blog.title

    blog_content = blog.content

    blogContent = {

                   'blog_title':blog_title,

                   'content':blog_content,

                   'comment_list':comment

                   }

    blog.readcount+=1

    blog.save()

    return render(request,'blogs/content.html',blogContent)

# blogs/urls.py

from django.conf.urls import url

from . import views

from django.conf.urls import include

from users import urls as userurls

app_name='blogs'

urlpatterns = [

    url(r'^(?P<blogId>[0-9]*)$', views.content, name='content'),

    # ...

]

在content函数中，通过blogId可以获得到唯一的Blog对象，进而拿到博客的标题、正文和从属于该博客的所有评论。随后，使用session记录下正在访问的博客的id，以便后面发布评论使用。在获得了博客的相关信息后，便可以将其放在一个字典里传给前端以供显示；然后，我们要使该博客的访问量+1，并更新在数据库中。
在前端部分，同Users App一样，我们需要在blogs/templates中建立模板，并在其中建立blogs目录存放我们的页面。由于和Users App模板大同小异，因此这里不再放模板的代码；content页面代码如下：

<!-- blogs/templates/blogs/content.html -->

{% extends "blogTemplate.html" %}

{% block content %}

<div class="content">

<h2>{{ blog_title }}</h2>

{{ content|safe }}

</div>

<p><a href="{% url 'index' %}">返回首页</a></p>

{% endblock %}

{% block comment %}

{% if comment_list %}

	{% for comment in comment_list %}

		<ul class="comment">

		<li>

		{% if comment.auther.username == "anony" %}

		<h4>匿名用户    {{ comment.createtime|date:"Y-m-d H:i:s" }}</h4>

		{% else %}

                <img src="{{ comment.auther.logoimage.url }}" width="64" height="64" />

		<h4>{{ comment.auther }}    {{ comment.createtime|date:"Y-m-d H:i:s" }}</h4>

		{% endif %}

		</li>

		<li>{{ comment.content|safe }}</li>

		</ul>

		<hr/>

	{% endfor %}

{% else %}

	<ul class="comment">

	<p>还没有人发表评论</p>

	</ul>

{% endif %}

<span>评论 </span>

<form action="{% url 'blogs:saveComment' %}" method="post" onsubmit="return toVaild()">

{% csrf_token %}

<ul class="comment">

<li><textarea name="blogcomment"></textarea></li>

<li><input type="submit" value="提交"></li>

</ul>

</form>

{% endblock %}

content页面要显示两部分内容，其一是博客主体内容，包括博客的标题和正文，其二是博客的相关评论，以及发布评论的表单。在博客的正文部分有一个地方需要注意，就是我们的博客是以富文本形式存储在数据库中的，因此博客正文包含很多html标记。在显示的时候我们需要用|safe标记来表明这个内容是安全的，可以将内容转义以得到正确的格式。如果没有加上|safe，我们看到的就是带有html标记的原始数据。
在显示评论的部分，我们会逐条显示评论的内容以及发布时间，并且如果是非匿名评论，我们会显示评论者的用户名和头像，如下所示：

下面来让我们看一下如何发布博客。为了实现博客的图文混排，我们选用CKeditor这一款编辑器作为博客的编辑器。这款编辑器是一种免费的富文本编辑器，体积小巧，并且配置方便，支持可见即所得的图文混排，如图所示：

此外，CKeditor还支持多种配置，以实现更强大的功能。在这里我选用了默认的配置。

为了使用CKeditor，我们需要到官网上下载CKeditor，然后把解压后得到的ckeditor目录拷贝到我们在myblog目录下建立的static目录下。此外，我们还要安装Django的ckeditor库django-ckeditor，这样我们就可以在工程中使用ckeditor了（static的部分见本系列第三篇）。需要注意的是，ckeditor需要python的pillow库作为处理图像的后端，因此我们还需要安装pillow。

为了使用ckeditor，我们需要在myblog/settings.py中添加一些配置，如下所示：

# myblog/settings.py

# ...

INSTALLED_APPS = [

    'ckeditor',

    'ckeditor_uploader',

    # ...

]

# ...

CKEDITOR_JQUERY_URL = '/static/js/jquery-3.2.1.min.js'

CKEDITOR_UPLOAD_PATH = 'blogimage/'

CKEDITOR_IMAGE_BACKEND = 'pillow'

# ...

我们需要把ckeditor和它的上传器加入到INSTALLED_APPS中，此外我们还要将ckeditor的上传图片路径和依赖的jquery库路径写在settings.py中。

在配置好CKeditor后，我们就可以开始编写发布博客以及存储草稿的view函数了。我们需要一个ModelForm来发布博客，因此我们建立blogForm.py文件，并建好我们的BlogForm表单：

# blogs/blogForm.py

#-*- coding=utf-8 -*-

from django import forms

from django.forms import ModelForm

from .models import Blog

class BlogForm(ModelForm):

    class Meta:

        model = Blog

        fields = ['title','category','content']

在定义好BlogForm表单后，我们就可以写发布博客的相关函数了：

# blogs/views.py

def addBlog(request):

    if request.method == 'POST':

        if request.session.has_key('currentblogId'):

            tmpBlog = Blog.objects.get(id=request.session['currentblogId'])

            if tmpBlog:

                form = BlogForm(request.POST,instance=tmpBlog)

                tmpBlog = form.save(commit=False)

                tmpBlog.draft = False

                tmpBlog.save()

                result_info = 'Success'

            else:

                form = BlogForm(request.POST)

                if form.is_valid():

                    newBlog = form.save(commit=False)

                    newBlog.auther = Users.objects.get(username=request.session['username'])

                    newBlog.draft = False

                    category = Category.objects.get(categoryname=newBlog.category)

                    category.blogcount = category.blogcount+1

                    category.save()

                    newBlog.save()

                    result_info = 'Success'

            del request.session['currentblogId']

        else:

            form = BlogForm(request.POST)

            if form.is_valid():

                newBlog = form.save(commit=False)

                newBlog.auther = Users.objects.get(username=request.session['username'])

                newBlog.draft = False

                category = Category.objects.get(categoryname=newBlog.category)

                category.blogcount = category.blogcount + 1

                category.save()

                newBlog.save()

                result_info = 'Success'

        return HttpResponseRedirect(reverse('blogs:addblogResult', kwargs={'info': result_info}))

    else:

        form = BlogForm()

    return render(request, 'blogs/addblog.html', {'form':form})

def addBlogResult(request,info):

    tipMessage=''

    if info == 'Success':

        tipMessage = '博文已成功发表！'

    else:

        tipMessage = info

    parameters = {'info':tipMessage}

    return render(request, 'blogs/addblogResult.html', parameters)

def saveDraft(request):

    if request.method == 'POST':

        blogId = request.session.get('currentblogId','-1')

        if blogId!='-1':

            try:

                tmpBlog = Blog.objects.get(id=blogId)

                form = BlogForm(request.POST, instance=tmpBlog)

                tmpBlog = form.save(commit=False)

                tmpBlog.draft = True

                tmpBlog.save()

                result_info = u'文章已保存于草稿箱中。'

                return HttpResponse(result_info)

            except Blog.DoesNotExist:

                form = BlogForm(request.POST)

                if form.is_valid():

                    newBlog = form.save(commit=False)

                    newBlog.auther = Users.objects.get(username=request.session['username'])

                    category = Category.objects.get(categoryname=newBlog.category)

                    category.blogcount = category.blogcount+1

                    category.save()

                    newBlog.save()

                    request.session['currentblogId'] = newBlog.id

                    result_info = u'文章已保存于草稿箱中。'

                    return HttpResponse(result_info)

                return HttpResponse('test')

        else:

            form = BlogForm(request.POST)

            if form.is_valid():

                newBlog = form.save(commit=False)

                newBlog.auther = Users.objects.get(username=request.session['username'])

                category = Category.objects.get(categoryname=newBlog.category)

                category.blogcount = category.blogcount + 1

                category.save()

                newBlog.save()

                request.session['currentblogId'] = newBlog.id

                result_info = u'文章已保存于草稿箱中。'

                return HttpResponse(result_info)

            else:

                return HttpResponse('test')

    else:

        return HttpResponse('test')

发布博客的函数分为三部分：addBlog用于发布博客，addBlogResult是在发布博客成功后要跳转的页面，而saveDraft是将博客存储为草稿的函数。

首先来看saveDraft函数的实现。该函数要考虑到两种情况：1、博客的第一次保存；2、博客已存为草稿下的再次保存。对于博客的第一次保存，我们可以直接调用BlogForm的方法进行保存，并且在保存之后将该篇博客的id存储在session['currentblogId']中，以便情况2的使用；对于已经存储为草稿的博客，我们只需根据session['currentblogId']的值得到当前博客，并再次调用save方法保存即可。在这个函数中，我们使用了一种新的方法来初始化BlogForm：form = BlogForm(request.POST,instance=tmpBlog)，这是因为我们可以用一个已存在的对象来初始化一个ModelForm。另外，由于我们稍后在前端会以Ajax的方式来调用这个函数，因此我们没有使用render函数来渲染某个页面，而只是简单地返回了一个HttpResponse对象。

再来看addBlog函数的实现。该函数也要考虑两种情况：1、博客已存为草稿后发布；2、博客没有存储为草稿直接发布。对于第一种情况，我们可以直接从session['currentblogId']中得到当前博客的id值，再将其draft的值改为False后调用save方法保存。注意这里的第一次save函数的调用，我们传入了commit=False的选项，这表示此次save并不会真正加载到数据库中，在之后我们还可以对对象的字段值进行修改后再真正commit到数据库中。另外一个需要注意的地方是，我们不仅要在Blog表里插入数据，也要更新category model的blogcount值，使之+1。

addBlogResult函数没什么可说的，就是根据addBlog的结果进行的跳转页面。

以上三个函数的url配置如下：

# blog/urls.py

urlpatterns = [

    # ...

    url(r'^addblog/$', views.addBlog, name='addblog'),

    url(r'^addblogResult/(?P<info>.*)$', views.addBlogResult, name='addblogResult'),

    url(r'^saveDraft/$',views.saveDraft,name='saveDraft'),

    # ...

]

这样，我们的发布博客、存储草稿和正文的后端部分就完成了。在下篇博客中，将继续介绍这三个功能的前端页面实现～