import datetime
from django import template

register = template.Library()# 只有向系統(tǒng)注冊過的tags，系統(tǒng)才認(rèn)得你。

@register.simple_tag(takes_context=True)#加上這句后我就是一名合格的template tags
def current_time(context, format_string):
  timezone = context['timezone']
  return your_get_current_time_method(timezone, format_string)

@register.simple_tag(takes_context=True)
# 這個裝飾器表明這個函數(shù)是一個模板標(biāo)簽，takes_context = True 表示接收上下文對象，就是前面所說的封裝了各種變量的 Context 對象。
def paginate(context, object_list ,page_count):
  # context是Context 對象，object_list是你要分頁的對象，page_count表示每頁的數(shù)量 , page_count
  left = 3 # 當(dāng)前頁碼左邊顯示幾個頁碼號 -1，比如3就顯示2個
  right = 3 # 當(dāng)前頁碼右邊顯示幾個頁碼號 -1
  paginator = Paginator(object_list, page_count) # 通過object_list分頁對象

  page = context['request'].GET.get('page') # 從 Http 請求中獲取用戶請求的頁碼號
  try:
    object_list = paginator.page(page) # 根據(jù)頁碼號獲取第幾頁的數(shù)據(jù)
    context['current_page'] = int(page) # 把當(dāng)前頁封裝進context（上下文）中
    pages = get_left(context['current_page'], left, paginator.num_pages) + get_right(context['current_page'], right,
                                             paginator.num_pages)
    # 調(diào)用了兩個輔助函數(shù)，根據(jù)當(dāng)前頁得到了左右的頁碼號，比如設(shè)置成獲取左右兩邊2個頁碼號，那么假如當(dāng)前頁是5，則 pages = [3,4,5,6,7],當(dāng)然一些細節(jié)需要處理，比如如果當(dāng)前頁是2，那么獲取的是pages = [1,2,3,4]
  except PageNotAnInteger:
    # 異常處理，如果用戶傳遞的page值不是整數(shù)，則把第一頁的值返回給他
    object_list = paginator.page(1)
    context['current_page'] = 1 # 當(dāng)前頁是1
    pages = get_right(context['current_page'], right, paginator.num_pages)
  except EmptyPage:
    # 如果用戶傳遞的 page 值是一個空值，那么把最后一頁的值返回給他
    object_list = paginator.page(paginator.num_pages)
    context['current_page'] = paginator.num_pages # 當(dāng)前頁是最后一頁，num_pages的值是總分頁數(shù)
    pages = get_left(context['current_page'], left, paginator.num_pages)
  context['article_list'] = object_list # 把獲取到的分頁的數(shù)據(jù)封裝到上下文中
  context['pages'] = pages # 把頁碼號列表封裝進去
  context['last_page'] = paginator.num_pages # 最后一頁的頁碼號
  context['first_page'] = 1 # 第一頁的頁碼號為1
  try:
    # 獲取 pages 列表第一個值和最后一個值，主要用于在是否該插入省略號的判斷，在模板文件中將會體會到它的用處。注意這里可能產(chǎn)生異常，因為pages可能是一個空列表，比如本身只有一個分頁，那么pages就為空，因為我們永遠不會獲取頁碼為1的頁碼號（至少有1頁，1的頁碼號已經(jīng)固定寫在模板文件中）
    context['pages_first'] = pages[0]
    context['pages_last'] = pages[-1] + 1
    # +1的原因是為了方便判斷，在模板文件中將會體會到其作用。
  except IndexError:
    context['pages_first'] = 1 # 發(fā)生異常說明只有1頁
    context['pages_last'] = 2 # 1 + 1 后的值
  return '' # 必須加這個，否則首頁會顯示個None

{% load paginate_tags %}#第一步：把文件名包含進來
{% paginate blogposts 2 %} #第二步：調(diào)用函數(shù) 添加參數(shù)。注意context參數(shù)不用你傳。

  context['article_list'] = object_list # 把獲取到的分頁的數(shù)據(jù)封裝到上下文中
  context['pages'] = pages # 把頁碼號列表封裝進去
  context['last_page'] = paginator.num_pages # 最后一頁的頁碼號
  context['first_page'] = 1 # 第一頁的頁碼號為1