Django实战：搭建个人博客(三)

[TOC]

后台的优化

1. 应用汉化

后台汉化

修改settings文件中的语言和时区：
```
LANGUAGE_CODE = 'zh-hans'
TIME_ZONE = 'Asia/Shanghai'
```

表单汉化

修改blog/apps.py里的应用配置信息：

class BlogConfig(AppConfig):
    name = 'blog'
    verbose_name='博客'

修改settings文件中blog应用的注册信息：

INSTALLED_APPS = [
    ...
    'blog.apps.BlogConfig',  # 注册blog应用的配置信息
]

模型名称汉化

以Category为例，通过内部类Meta修改模型名称：

class Category(models.Model):
    name = models.CharField(max_length=20)
    class Meta:
        verbose_name = '分类'
        verbose_name_plural = verbose_name  # 复数名称，不覆写则自动加s

模型属性汉化

以Post为例，为各个属性添加verbose_name参数：

title = models.CharField('标题', max_length=40)  # '标题'作为第一个位置参数传给verbose_name
tag = models.ManyToManyField(Tag, verbose_name='标签')  # 由于关联属性的第一个参数必须是关联的类，所以用关键词参数

2. 创建时间等信息自动填写

创建时间：用default参数传入当前时间

from django.utils import timezone
createdTime = models.DateTimeField('创建时间', default=timezone.now())  # 默认值为当前时间，timezone.now可以自适应时区

修改时间：覆写Post的父类Model的save方法

def save(self, *args, **kwargs):
    self.modifiedTime = timezone.now()  # 每次保存实例时都变更一次修改时间
    super().save(*args, **kwargs)

作者：覆写admin.py/PostAdmin的父类ModelAdmin的save_model()方法

admin.site.register(Post, PostAdmin)  # 注意将PostAdmin和Post关联注册

class PostAdmin(admin.ModelAdmin):
    def save_model(self, request, obj, form, change):
        obj.author = request.user  # request.user是当前登录的用户
        super().save_model(request, obj, form, change)

属性展示与填写的调整，可以通过修改PostAdmin的list_display和fields属性

class PostAdmin(admin.ModelAdmin):
    # Post表单展示的属性
    list_display = ['title', 'createdTime', 'modifiedTime', 'category', 'author']
    # Post表单需要人工填写的属性
    fields = ['title', 'body', 'excerpt', 'category','tag']

Markdown语法支持

在数据库中保存的数据是原始数据，希望在显示时按照Markdown语法显示，修改视图函数如下：

import markdown
from django.utils.text import slugify
from markdown.extensions.toc import TocExtension
def detail(request, pk):
    post = get_object_or_404(Post, pk=pk)
    # 实例化一个markdown对象，添加了一些额外语法如代码高亮
    md = markdown.Markdown(extensions=[
        'markdown.extensions.extra',
        'markdown.extensions.codehilite',
        # 记得在顶部引入 TocExtension 和 slugify
        TocExtension(slugify=slugify),
    ])
    post.body = md.convert(post.body)
    m = re.search(r'<div class="toc">\s*<ul>(.*)</ul>\s*</div>', md.toc, re.S)
    # 为post添加一个toc属性，可以在模板中调用以显示目录
    post.toc = m.group(1) if m is not None else ''
    return render(request, 'blog/detail.html', context={'post': post})

经过转换，post.body已经转换成了html文本，由于Django的安全机制，在detail模板中调用post.body时要加上safe过滤器，告诉Django这段文本可以正常渲染：

{{ post.body|safe }}

继续添加代码高亮效果参照让博客支持 Markdown 语法和代码高亮

自动生成摘要

为了自动生成文章摘要，可以就像自动生成修改时间一样，覆写Post模型的save方法。

from django.utils.html import strip_tags
def save(self, *args, **kwargs):
    self.modifiedTime = timezone.now()
    md = markdown.Markdown(extensions=[
        'markdown.extensions.extra',
        'markdown.extensions.codehilite',
    ])
    # strip_tags可以剥去html文本的标签
    self.excerpt=strip_tags(md.convert(self.body))[:300]
    super().save(*args, **kwargs)