自定义模板标签和选择器

官方文档说明：
https://docs.djangoproject.com/en/2.1/howto/custom-template-tags/

功能需求：
1、统计文章总数
2、某用户发布的文章总数统计
3、最新发布的文章列表
4、评论最多的文章列表
5、将Markdown语法解析为HTML代码

文件配置
在APP中创建一个目录templatetags（默认，必须用这个名称），然后在里面创建两个文件__init__.py和article_tags.py。
article_tags.py

from article.models import ArticlePost    # 注意引入方式
from django.db.models import Count

from django.utils.safestring import mark_safe
import markdown    # pip install Markdown

from django import template
register = template.Library() # 实例对象register

# 统计文章总数     通过装饰器，表明其下面的代码是自定义的simple_tag类型的标签
@register.simple_tag     # simple_tag 返回的是字符串
def total_articles():
    return ArticlePost.objects.count()

# 统计某个作者发布的文章总数
@register.simple_tag
def author_total_articles(user):
    return user.article.count()

# 汇总最新发布的文章   inclusion_tag  返回一个模板
@register.inclusion_tag('article/list/latest_articles.html')   # 参数为要渲染的模板文件
def latest_articles(n=5):
    latest_articles = ArticlePost.objects.order_by('-created')[:n]   # 文章对象列表集合
    return {'latest_articles':latest_articles}     # 返回字典类型，数据会被应用到要渲染的模板文件中

# 评论最多的文章
@register.simple_tag
def most_commented_articles(n=3):
    # annotate():给QuerySet中的每个对象添加注释
    # Count('comment') 得到的是ArticlePost对象关联的Comment对象的个数
    return ArticlePost.objects.annotate(total_comments=Count('comments')).order_by('-total_comments')[:n]


# 自定义模板选择器，将Markdown语法解析为HTML代码
@register.filter(name='markdown')  # 重命名选择器函数，将markdown_filter改为markdown
def markdown_filter(text):         # 要避免函数名与第三方库的名字冲突
    return mark_safe(markdown.markdown(text))   # 返回safe string

在模板文件中应用，article_titles.html

{% load article_tags %}    # 引入自定义标签的声明
<p>这里已经有{% total_articles %}篇文章供你阅读</p> 

author_articles.html

{% load article_tags %} 
<p>{{ user.username }}</p>
<p>共发表文章{% author_total_articles user %}篇</p>    # 注意参数

latest_articles.html

<ul>
    {% for article in latest_articles %}
    <li>
        <a href="{{ article.get_url_path }}">{{ article.title }}</a>
    </li>
    {% endfor %}
</ul>

在article_detail.html使用{% latest_articles %} 和{% most_commented_articles %} 标签

{% load article_tags %} 
<p class="text-center"><h3>最新文章</h3></p>
 {% latest_articles 4 %}   

<p class="text-center"><h3>最多评论文章</h3></p>
      {% most_commented_articles as most_comments %}   #把自定义标签所得到的对象赋值给一个变量，此步是必须的！！！！！
    <ul>
      {% for comment_article in most_comments %}
      <li>
        <a href="{{comment_article.get_url_path}}">{{ comment_article.title }}</a>
     </li>
     {% endfor %}
     </ul>

自定义选择器
实现将Markdown语法解析为HTML代码的markdown_filter()方法中：
django.utils.safestring的作用就是将字符串编程为“safe strings”,即实实在在的字符，mark_safe()方法返回的就是这种“safe strings”。
article_detail.html

{% load article_tags %}
{{ article.body | markdown }}