文章目录
- 0.思路引导
- 1.方法一:覆写 save 方法
- 2.方法二:使用 truncatechars 模板过滤器
0.思路引导
博客文章的模型有一个 excerpt 字段,这个字段用于存储文章的摘要。
若在 django admin 后台手动为文章输入摘要,每次手动输入摘要比较麻烦。
若想要程序自动摘取正文的前 N 个字符作为摘要,以便提供文章预览就可以了。
因此我们来实现如果文章没有输入摘要,则自动摘取正文的前 N 个字符作为摘要。
1.方法一:覆写 save 方法
第一种方法是通过覆写模型的 save()方法,从正文body 中摘取前 N 个字符保存到摘要字段。
save()方法中执行的是保存模型实例数据到数据库的逻辑,因此通过覆写 save() 方法,在保存数据库前做一些事情,比如填充某个缺失字段的值。
方案:先将 body 中的 Markdown 文本转为 HTML 文本,去掉 HTML 文本里的 HTML 标签,然后摘取文本的前 54 个字符作为摘要。去掉 HTML 标签的目的是防止前 54 个字符中存在块级 HTML 标签而使得摘要格式比较难看。可以看到很多网站都采用这样一种生成摘要的方式。
代码位置:blog/models.py
import markdown
from django.utils.html import strip_tagsclass Post(models.Model):# 其它字段...body = models.TextField()excerpt = models.CharField(max_length=200, blank=True)# 其它方法...def save(self, *args, **kwargs):self.modified_time = timezone.now()# 首先实例化一个 Markdown 类,用于渲染 body 的文本。# 由于摘要并不需要生成文章目录,所以去掉了目录拓展。md = markdown.Markdown(extensions=['markdown.extensions.extra','markdown.extensions.codehilite',])# 先将 Markdown 文本渲染成 HTML 文本# strip_tags 去掉 HTML 文本的全部 HTML 标签# 从文本摘取前 54 个字符赋给 excerptself.excerpt = strip_tags(md.convert(self.body))[:54]super().save(*args, **kwargs)
然后在模板中适当的地方使用模板标签引用 {{ post.excerpt }} 显示摘要的值即可
文件位置:templates/blog/index.html
<article class="post post-{{ post.pk }}">...<div class="entry-content clearfix"><p>{{ post.excerpt }}</p><div class="read-more cl-effect-14"><a href="{{ post.get_absolute_url }}" class="more-link">继续阅读 <span class="meta-nav">→</span></a></div></div>
</article>
新添加一篇文章(这样才能触发 save 方法,此前添加的文章不会自动生成摘要,要手动保存一下触发 save 方法),可以看到摘要效果如下:
2.方法二:使用 truncatechars 模板过滤器
在 django 的模板系统中,我们之前使用过 safe 过滤器,使用语法为 {{ var | filter: arg }}。可以将模板过滤看做一个函数,它会作用于被它过滤的模板变量,从而改变模板变量的值。
第二种方法是使用 truncatechars 模板过滤器(Filter),其可以截取模板变量值的前 N 个字符显示。
例如摘要效果,需要显示 post.body 的前 54 的字符,那么可以在模板中使用 {{ post.body | truncatechars:54 }}。
文件位置:templates/blog/index.html
<article class="post post-{{ post.pk }}">...<div class="entry-content clearfix"><p>{{ post.body|truncatechars:54 }}</p><div class="read-more cl-effect-14"><a href="{{ post.get_absolute_url }}" class="more-link">继续阅读 <span class="meta-nav">→</span></a></div></div>
</article>
不过这种方法的一个缺点就是如果前 54 个字符含有块级 HTML 元素标签的话(比如一段代码块),会使摘要比较难看。所以推荐使用第一种方法。