Django Blog 文章按发表时间自动归档的优雅解决方案

Django Blog 文章按发表时间自动归档的优雅解决方案

Blog 应用通常都有一个文章归档的功能,按照年月来对所有文章分组,比较优雅的显示可能是这样的:

  • 2016 年
    • 8 月
    • 4月
    • 3月
  • 2015 年
    • 9月
    • 8月
    • 1月
  • 2013 年
    • 7月
    • 6月
    • 5月

Django 为上述的需求提供了非常优雅的解决方案。

假设我们有如下的 Model :

models.py

class Post(models.Model):
    """
    Blog 的文章模型
    """
    title = models.CharField(max_length=255)
    body = models.TextField()
    pub_date = models.DateTimeField()

    def __str__(self):
        return self.title

其中 pub_date 是文章发表时间。首先我们取得所有已发表文章的发表时间(pub_date,精确到月份):

views.py

def archive(request):
    # datetimes() 方法返回一个 python 的 datetimes 对象列表
    # 对应着每篇文章的发表时间
    # month 表示精确到月份,DESC 表示降序排列
    dates = Post.objects.datetimes('pub_date', 'month', order='DESC')
    return render(request,'archive.html',{'dates':dates})

例如你可能得到如下的 datetimes 对象列表:

2016 08

2016 04

2016 03

2015 09

2015 08

2015 01

2013 07

2013 06

2013 05

已经按照先年份后月份降序排列,现在需要做的就是按照年份分组即可,Django 为我们提供了 {% regroup %} 模板标签,在模板中使用它:

archive.html

<p>归档</p>
<!-- 归档 -->
<!--
regroup 对 dates 按照 year(年份) 分组,把相同年份的月分到一个组
-->
{% regroup dates by year as dates_by_year %}
<ul>
    {% for mouth in dates_by_year %}
    <!-- month 是一组月份列表 -->
        <li>
            {{ mouth.grouper }} 年
            <!-- grouper 是组头,即某个月份列表的年份 -->
            <ul>
                {% for d in mouth.list %}
                <!-- 再循环显示该年份组下的月份列表即可 -->
                    <li>
                        {{ d |date:'m' }} 月
                    </li>
                {% endfor %}
            </ul>
        </li>
    {% endfor %}
</ul>

测试效果如图:

归档效果演示图

由此实现了按照文章发表时间自动归档,通过 datetimes() 方法的参数还可以控制归档的精度,比如日、时、分等,简洁而优雅。归档的样式则可以通过 css 自由定制。

推荐阅读更多精彩内容