Django搭建个人博客：文章标签功能

Amio 发布于2019-07-31 10:03 / 2043人阅读

摘要：每一篇文章的标签可能都不一样，并且还可能拥有多个标签，这是与栏目功能不同的。列表中显示标签虽然保存标签的功能已经实现了，还得把它显示出来才行。更多的用法请阅读官方文档总结本章学习了使用来完成标签功能。

“标签”是作者从文章中提取的核心词汇，其他用户可以通过标签快速了解文章的关注点。每一篇文章的标签可能都不一样，并且还可能拥有多个标签，这是与栏目功能不同的。

好在标签功能也有优秀的三方库：Django-taggit，省得自己动手设计了。快速开发就是这样，能“借用”就不要自己重复劳动。

安装及设置

首先在虚拟环境中安装Django-taggit：

pip install django-taggit

安装成功后，修改项目设置以添加库：

my_blog/settings.py

...
INSTALLED_APPS = [
    ...
    "taggit",
]
...

修改文章模型

标签是文章Model的属性，因此需要修改文章模型。

需要注意的是标签引用的不是内置字段，而是库中的TaggableManager，它是处理多对多关系的管理器：

article/models.py

...

# Django-taggit
from taggit.managers import TaggableManager

...
class ArticlePost(models.Model):
    ...

    # 文章标签
    tags = TaggableManager(blank=True)

    ...

然后记得数据迁移。

带标签文章的发表

修改文章的表单类，让其能够提交标签字段：

article/forms.py

...
class ArticlePostForm(forms.ModelForm):
    class Meta:
        ...
        fields = ("title", "body", "tags")

然后修改发表文章的视图，保存POST中的标签：

article/views.py

...
def article_create(request):
    # 已有代码
    if request.method == "POST":
        article_post_form = ArticlePostForm(data=request.POST)
        if article_post_form.is_valid():
            new_article = article_post_form.save(commit=False)
            ...
            new_article.save()
            
            # 新增代码，保存 tags 的多对多关系
            article_post_form.save_m2m()
            
            ...

需要注意的是，如果提交的表单使用了commit=False选项，则必须调用save_m2m()才能正确的保存标签，就像普通的多对多关系一样。

最后就是在发表文章的模板中添加标签的表单项了：

templates/article/create.html

...


    ...
    
    
    
        标签
        
    
    
    ...

...

运行服务器，就可以在发表页面看到效果了：

多个标签最好用英文逗号进行分隔。中文逗号有的版本会报错，干脆就不要去使用了。

列表中显示标签

虽然保存标签的功能已经实现了，还得把它显示出来才行。

显示标签最常用的位置是在文章列表中，方便用户筛选感兴趣的文章。

修改文章列表的模板，将标签显示出来：

templates/article/list.html

...

...



    {% for tag in article.tags.all %}
        
            {{ tag }}
        
    {% endfor %}


...

链接中的class中是Bootstrap定义的徽章样式。

插入位置紧靠在栏目按钮的后面。当然你想放到其他位置也是完全可以的。

刷新列表页面看看效果：

标签过滤

有时候用户想搜索带有某一个标签的所有文章，现在就来做这个功能。

与搜索功能一样，只需要调取数据时用filter()方法过滤结果就可以了。

修改标签中的href，使其带有tag参数返回到View中：

templates/article/list.html

...



    {% for tag in article.tags.all %}
        
            {{ tag }}
        
    {% endfor %}


...

然后在View中取得tag的值，并进行搜索。

下面的代码将article_list()函数完整写出来了（包括上一章末尾没讲的栏目查询），方便读者比对。

article/views.py

...
def article_list(request):
    # 从 url 中提取查询参数
    search = request.GET.get("search")
    order = request.GET.get("order")
    column = request.GET.get("column")
    tag = request.GET.get("tag")

    # 初始化查询集
    article_list = ArticlePost.objects.all()

    # 搜索查询集
    if search:
        article_list = article_list.filter(
            Q(title__icontains=search) |
            Q(body__icontains=search)
        )
    else:
        search = ""

    # 栏目查询集
    if column is not None and column.isdigit():
        article_list = article_list.filter(column=column)

    # 标签查询集
    if tag and tag != "None":
        article_list = article_list.filter(tags__name__in=[tag])

    # 查询集排序
    if order == "total_views":
        article_list = article_list.order_by("-total_views")

    paginator = Paginator(article_list, 3)
    page = request.GET.get("page")
    articles = paginator.get_page(page)
    
    # 需要传递给模板（templates）的对象
    context = {
        "articles": articles,
        "order": order,
        "search": search,
        "column": column,
        "tag": tag,
    }
    
    return render(request, "article/list.html", context)

...

注意Django-taggit中标签过滤的写法：filter(tags__name__in=[tag])，意思是在tags字段中过滤name为tag的数据条目。赋值的字符串tag用方括号包起来。

之所以这样写是因为Django-taggit还支持多标签的联合查询，比如：Model.objects.filter(tags__name__in=["tag1", "tag2"])

为了实现带参数的交叉查询，还要将翻页等位置的href修改一下：

templates/article/list.html

...




    最新


...


    最热


...


    « 1



...

标签过滤功能就完成了。

Django-taggit更多的用法请阅读官方文档：Django-taggit

总结

本章学习了使用Django-taggit来完成标签功能。

在学习阶段，你可以不借助他人的轮子，自己实现功能：瞎折腾对掌握基础有很大帮助。

实际开发时，又分为两种情况：

浅层需求某项通用功能，开发完成后改动不大：此类功能建议尽量使用轮子，加快开发效率。人生苦短，能节约的时间，一秒钟都不要浪费。

需要大量定制化的功能，开发完成后需要频繁改动：此类功能因为经常对底层代码进行改动，与其在别人的代码上修修补补，还不如自己从头写了。自己的代码不仅熟悉，而且都是为定制化而生的。

到底如何选择，就根据你的喜欢进行斟酌了。

有疑问请在杜赛的个人网站留言，我会尽快回复。

或Email私信我：dusaiphoto@foxmail.com

项目完整代码：Django_blog_tutorial

云服务器私有云搭建个人博客个人博客搭建如何用wordpress搭建个人博客阿里云服务器linux搭建个人博客

文章版权归作者所有，未经允许请勿转载,若此文章存在违规行为，您可以联系管理员删除。

转载请注明本文地址：https://www.ucloud.cn/yun/43162.html

Django搭建个人博客：结束和开始

摘要：教程看到这里，你已经学会如下内容搭建开发环境博文管理用户管理发表评论若干小功能搭建简单的小博客，以上的功能够用了。教程为了起步平缓，没有展开这方面的内容。陌生人，祝你学业进步事业有成欢迎常到杜赛的个人网站做客教程看到这里，你已经学会如下内容：搭建开发环境博文管理用户管理发表评论若干小功能搭建简单的小博客，以上的功能够用了。相信你的志向不止于此。毕竟程序员面试个个造火...

zqhxuyuan 2019-07-30 18:42 评论0 收藏0
Django搭建个人博客：使用django-ckeditor富文本编辑器

摘要：后面两个编辑器自带，不用单独下载，添上就可以了添加相关插件这样就完成了代码高亮效果不错在前台使用为了让用户在前台也能使用富文本编辑器，还得对代码稍加改动。对于有些不喜欢的人来说，甚至可以连博文都使用提供的富文本编辑器。前面我们已经实现了用Markdown语法写文章了。但是文章的评论用Markdown就不太合适了，你不能强求用户也花时间去熟悉语法啊。另外评论中通常还有表情、带颜色的字体...

beanlam 2019-07-31 10:11 评论0 收藏0
使用 django-blog-zinnia 搭建个人博客

摘要：语法支持再次打开文件，在文件的最后添加指明了使用语法标记，做了两个拓展，其中表示支持语法高亮，包含的特性请参见相关文档。语法高亮支持注意这一步必须在安装完主题之后。目前网上搭建个人博客的方案很多，虽然使用诸如 Wordpress ( PHP )、Hexo ( Node.js ) 等可以方便快速地搭建一款功能齐全的高性能个人博客，但是本文将尝试一种更为小众化的方案 —— 一款基于 dj...

褰辩话 2019-07-25 10:47 评论0 收藏0
Django搭建个人博客：用django-notifications实现消息通知

摘要：接下来你就可以在项目的任何地方发送通知了像这样其中的参数释义发送通知的对象接收通知的对象动词短语链接到动作的对象可选执行通知的对象可选有点绕，举个栗子杜赛在搭建个人博客中对你发表了评论。有疑问请在杜赛的个人网站留言，我会尽快回复。凭借你勤奋的写作，拜读你文章的用户越来越多，他们的评论也分散在众多的文章之中。作为博主，读者的留言肯定是要都看的；而读者给你留言，自然也希望得到回复。怎么...

Zoom 2019-07-31 10:26 评论0 收藏0
Django搭建个人博客：使用Form表单类发表新文章

摘要：一些表单界面元素文本框或复选框非常简单并内置在中，而其他会复杂些像弹出日期选择等操作控件。和标签中的属性指定了当前文本框提交的数据的名称，它必须与表单类中的字段名称对应，否则服务器无法将字段和数据正确的对应起来。前面我们已经学会如何用Markdown语法书写文章了。但是还有问题呀。之前写文章都是在后台中进行的，万一有别的普通用户也要发表文章怎么办？万一我想拓展些后台中没有的提交验证...

Java3y 2019-07-30 17:57 评论0 收藏0