class IndexView(ListView):
    model = Post
    template_name = 'blog/index.html'
    context_object_name = 'post_list'
    paginate_by = 10

    def get_context_data(self, **kwargs):
        """
        在視圖函數(shù)中將模板變量傳遞給模板是通過(guò)給 render 函數(shù)的 context 參數(shù)傳遞一個(gè)字典實(shí)現(xiàn)的拦赠，
        例如 render(request, 'blog/index.html', context={'post_list': post_list})，
        這里傳遞了一個(gè) {'post_list': post_list} 字典給模板葵姥。
        在類視圖中荷鼠，這個(gè)需要傳遞的模板變量字典是通過(guò) get_context_data 獲得的，
        所以我們復(fù)寫(xiě)該方法榔幸，以便我們能夠自己再插入一些我們自定義的模板變量進(jìn)去允乐。
        """

        # 首先獲得父類生成的傳遞給模板的字典。
        context = super().get_context_data(**kwargs)

        # 父類生成的字典中已有 paginator削咆、page_obj牍疏、is_paginated 這三個(gè)模板變量，
        # paginator 是 Paginator 的一個(gè)實(shí)例拨齐，
        # page_obj 是 Page 的一個(gè)實(shí)例鳞陨，
        # is_paginated 是一個(gè)布爾變量，用于指示是否已分頁(yè)瞻惋。
        # 例如如果規(guī)定每頁(yè) 10 個(gè)數(shù)據(jù)厦滤，而本身只有 5 個(gè)數(shù)據(jù)，其實(shí)就用不著分頁(yè)熟史，此時(shí) is_paginated=False馁害。
        # 關(guān)于什么是 Paginator，Page 類在 Django Pagination 簡(jiǎn)單分頁(yè)：http://zmrenwu.com/post/34/ 中已有詳細(xì)說(shuō)明蹂匹。
        # 由于 context 是一個(gè)字典碘菜，所以調(diào)用 get 方法從中取出某個(gè)鍵對(duì)應(yīng)的值。
        paginator = context.get('paginator')
        page = context.get('page_obj')
        is_paginated = context.get('is_paginated')

        # 調(diào)用自己寫(xiě)的 pagination_data 方法獲得顯示分頁(yè)導(dǎo)航條需要的數(shù)據(jù)限寞，見(jiàn)下方忍啸。
        pagination_data = self.pagination_data(paginator, page, is_paginated)

        # 將分頁(yè)導(dǎo)航條的模板變量更新到 context 中，注意 pagination_data 方法返回的也是一個(gè)字典履植。
        context.update(pagination_data)

        # 將更新后的 context 返回计雌，以便 ListView 使用這個(gè)字典中的模板變量去渲染模板。
        # 注意此時(shí) context 字典中已有了顯示分頁(yè)導(dǎo)航條所需的數(shù)據(jù)玫霎。
        return context

    def pagination_data(self, paginator, page, is_paginated):
        if not is_paginated:
            # 如果沒(méi)有分頁(yè)凿滤，則無(wú)需顯示分頁(yè)導(dǎo)航條妈橄，不用任何分頁(yè)導(dǎo)航條的數(shù)據(jù)，因此返回一個(gè)空的字典
            return {}

        # 當(dāng)前頁(yè)左邊連續(xù)的頁(yè)碼號(hào)翁脆，初始值為空
        left = []

        # 當(dāng)前頁(yè)右邊連續(xù)的頁(yè)碼號(hào)眷蚓，初始值為空
        right = []

        # 標(biāo)示第 1 頁(yè)頁(yè)碼后是否需要顯示省略號(hào)
        left_has_more = False

        # 標(biāo)示最后一頁(yè)頁(yè)碼前是否需要顯示省略號(hào)
        right_has_more = False

        # 標(biāo)示是否需要顯示第 1 頁(yè)的頁(yè)碼號(hào)。
        # 因?yàn)槿绻?dāng)前頁(yè)左邊的連續(xù)頁(yè)碼號(hào)中已經(jīng)含有第 1 頁(yè)的頁(yè)碼號(hào)反番，此時(shí)就無(wú)需再顯示第 1 頁(yè)的頁(yè)碼號(hào)沙热，
        # 其它情況下第一頁(yè)的頁(yè)碼是始終需要顯示的。
        # 初始值為 False
        first = False

        # 標(biāo)示是否需要顯示最后一頁(yè)的頁(yè)碼號(hào)罢缸。
        # 需要此指示變量的理由和上面相同篙贸。
        last = False

        # 獲得用戶當(dāng)前請(qǐng)求的頁(yè)碼號(hào)
        page_number = page.number

        # 獲得分頁(yè)后的總頁(yè)數(shù)
        total_pages = paginator.num_pages

        # 獲得整個(gè)分頁(yè)頁(yè)碼列表，比如分了四頁(yè)枫疆，那么就是 [1, 2, 3, 4]
        page_range = paginator.page_range

        if page_number == 1:
            # 如果用戶請(qǐng)求的是第一頁(yè)的數(shù)據(jù)爵川，那么當(dāng)前頁(yè)左邊的不需要數(shù)據(jù)，因此 left=[]（已默認(rèn)為空）养铸。
            # 此時(shí)只要獲取當(dāng)前頁(yè)右邊的連續(xù)頁(yè)碼號(hào)雁芙，
            # 比如分頁(yè)頁(yè)碼列表是 [1, 2, 3, 4]，那么獲取的就是 right = [2, 3]钞螟。
            # 注意這里只獲取了當(dāng)前頁(yè)碼后連續(xù)兩個(gè)頁(yè)碼，你可以更改這個(gè)數(shù)字以獲取更多頁(yè)碼谎碍。
            right = page_range[page_number:page_number + 2]

            # 如果最右邊的頁(yè)碼號(hào)比最后一頁(yè)的頁(yè)碼號(hào)減去 1 還要小鳞滨，
            # 說(shuō)明最右邊的頁(yè)碼號(hào)和最后一頁(yè)的頁(yè)碼號(hào)之間還有其它頁(yè)碼，因此需要顯示省略號(hào)蟆淀，通過(guò) right_has_more 來(lái)指示拯啦。
            if right[-1] < total_pages - 1:
                right_has_more = True

            # 如果最右邊的頁(yè)碼號(hào)比最后一頁(yè)的頁(yè)碼號(hào)小，說(shuō)明當(dāng)前頁(yè)右邊的連續(xù)頁(yè)碼號(hào)中不包含最后一頁(yè)的頁(yè)碼
            # 所以需要顯示最后一頁(yè)的頁(yè)碼號(hào)熔任，通過(guò) last 來(lái)指示
            if right[-1] < total_pages:
                last = True

        elif page_number == total_pages:
            # 如果用戶請(qǐng)求的是最后一頁(yè)的數(shù)據(jù)褒链，那么當(dāng)前頁(yè)右邊就不需要數(shù)據(jù)，因此 right=[]（已默認(rèn)為空）疑苔，
            # 此時(shí)只要獲取當(dāng)前頁(yè)左邊的連續(xù)頁(yè)碼號(hào)甫匹。
            # 比如分頁(yè)頁(yè)碼列表是 [1, 2, 3, 4]，那么獲取的就是 left = [2, 3]
            # 這里只獲取了當(dāng)前頁(yè)碼后連續(xù)兩個(gè)頁(yè)碼惦费，你可以更改這個(gè)數(shù)字以獲取更多頁(yè)碼兵迅。
            left = page_range[(page_number - 3) if (page_number - 3) > 0 else 0:page_number - 1]

            # 如果最左邊的頁(yè)碼號(hào)比第 2 頁(yè)頁(yè)碼號(hào)還大，
            # 說(shuō)明最左邊的頁(yè)碼號(hào)和第 1 頁(yè)的頁(yè)碼號(hào)之間還有其它頁(yè)碼薪贫，因此需要顯示省略號(hào)恍箭，通過(guò) left_has_more 來(lái)指示。
            if left[0] > 2:
                left_has_more = True

            # 如果最左邊的頁(yè)碼號(hào)比第 1 頁(yè)的頁(yè)碼號(hào)大瞧省，說(shuō)明當(dāng)前頁(yè)左邊的連續(xù)頁(yè)碼號(hào)中不包含第一頁(yè)的頁(yè)碼扯夭，
            # 所以需要顯示第一頁(yè)的頁(yè)碼號(hào)鳍贾，通過(guò) first 來(lái)指示
            if left[0] > 1:
                first = True
        else:
            # 用戶請(qǐng)求的既不是最后一頁(yè)，也不是第 1 頁(yè)交洗，則需要獲取當(dāng)前頁(yè)左右兩邊的連續(xù)頁(yè)碼號(hào)骑科，
            # 這里只獲取了當(dāng)前頁(yè)碼前后連續(xù)兩個(gè)頁(yè)碼，你可以更改這個(gè)數(shù)字以獲取更多頁(yè)碼藕筋。
            left = page_range[(page_number - 3) if (page_number - 3) > 0 else 0:page_number - 1]
            right = page_range[page_number:page_number + 2]

            # 是否需要顯示最后一頁(yè)和最后一頁(yè)前的省略號(hào)
            if right[-1] < total_pages - 1:
                right_has_more = True
            if right[-1] < total_pages:
                last = True

            # 是否需要顯示第 1 頁(yè)和第 1 頁(yè)后的省略號(hào)
            if left[0] > 2:
                left_has_more = True
            if left[0] > 1:
                first = True

        data = {
            'left': left,
            'right': right,
            'left_has_more': left_has_more,
            'right_has_more': right_has_more,
            'first': first,
            'last': last,
        }

        return data