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

归档


{% regroup dates by year as dates_by_year %}

    {% for mouth in dates_by_year %}
    
        

            {{ mouth.grouper }} 年
            
            

                {% for d in mouth.list %}
                
                    

                        {{ d |date:\'m\' }} 月
                    
                {% endfor %}
            
        
    {% endfor %}

测试效果如图：

归档效果演示图

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