Django:之Sitemap站點地圖、通用視圖和上下文渲染器

Django中自帶了sitemap框架，用來生成xml文件

Django sitemap演示：

sitemap很重要，能夠用來通知搜索引擎頁面的地址，頁面的重要性，幫助站點獲得比較好的收錄。

開啓sitemap功能的步驟

settings.py文件中django.contrib.sitemaps和django.contrib.sites要在INSTALL_APPS中

INSTALLED_APPS = (
    'django.contrib.admin',
    'django.contrib.auth',
    'django.contrib.contenttypes',
    'django.contrib.sessions',
    'django.contrib.messages',
    'django.contrib.staticfiles',
    'django.contrib.sites',
    'django.contrib.sitemaps',
    'django.contrib.redirects',
     
    #####
    #othther apps
    #####
)

Django 1.7及之前版本：

TEMPLATE_LOADERS中要加入‘django.template.loaders.app_directories.Loader’,像這樣：

TEMPLATE_LOADERS ＝ (
    'django.template.loaders.filesystem.Loader',
    'django.template.loaders.app_directories.Loader',
 )

Django 1.8及以上版本新加入了TEMPLATES設置，其中APP_DIRS要爲True,好比：

# NOTICE: code for Django 1.8, not work on Django 1.7 and below
TEMPLATES = [
    {
        'BACKEND': 'django.template.backends.django.DjangoTemplates',
        'DIRS': [
            os.path.join(BASE_DIR,'templates').replace('\\', '/'),
        ],
        'APP_DIRS': True,
    },
]

而後在urls.py中以下配置：

from django.conf.urls import url
from django.contrib.sitemaps import GenericSitemap
from django.contrib.sitemaps.views import sitemap
 
from blog.models import Entry
 
 
sitemaps = {
    'blog': GenericSitemap({'queryset': Entry.objects.all(), 'date_field': 'pub_date'}, priority=0.6),
    # 若是還要加其它的能夠模仿上面的
}
 
urlpatterns = [
    # some generic view using info_dict
    # ...
 
    # the sitemap
    url(r'^sitemap\.xml$', sitemap, {'sitemaps': sitemaps},
        name='django.contrib.sitemaps.views.sitemap'),

可是這樣生成的sitemap，若是網站內容太多就很慢，很耗費資源，能夠採用分頁的功能：

from django.conf.urls import url
from django.contrib.sitemaps import GenericSitemap
from django.contrib.sitemaps.views import sitemap
 
from blog.models import Entry
 
from django.contrib.sitemaps import views as sitemaps_views
from django.views.decorators.cache import cache_page
 
 
sitemaps = {
    'blog': GenericSitemap({'queryset': Entry.objects.all(), 'date_field': 'pub_date'}, priority=0.6),
    # 若是還要加其它的能夠模仿上面的
}
 
urlpatterns = [
    url(r'^sitemap\.xml$',
        cache_page(86400)(sitemaps_views.index),
        {'sitemaps': sitemaps, 'sitemap_url_name': 'sitemaps'}),
    url(r'^sitemap-(?P<section>.+)\.xml$',
        cache_page(86400)(sitemaps_views.sitemap),
        {'sitemaps': sitemaps}, name='sitemaps'),
]

這樣就能夠看到相似以下的sitemap，若是本地測試訪問http://localhost:8000/sitemap.xml

<?xml version="1.0" encoding="UTF-8"?>
<sitemapindex xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
<sitemap><loc>http://localhost:8000/sitemap-tutorials.xml</loc></sitemap>
<sitemap><loc>http://localhost:8000/sitemap-tutorials.xml?p=2</loc></sitemap>
<sitemap><loc>http://localhost:8000/sitemap-tutorials.xml?p=3</loc></sitemap>
<sitemap><loc>http://localhost:8000/sitemap-tutorials.xml?p=4</loc></sitemap>
<sitemap><loc>http://localhost:8000/sitemap-tutorials.xml?p=5</loc></sitemap>
<sitemap><loc>http://localhost:8000/sitemap-tutorials.xml?p=6</loc></sitemap>
<sitemap><loc>http://localhost:8000/sitemap-tutorials.xml?p=7</loc></sitemap>
<sitemap><loc>http://localhost:8000/sitemap-tutorials.xml?p=8</loc></sitemap>
<sitemap><loc>http://localhost:8000/sitemap-tutorials.xml?p=9</loc></sitemap>
</sitemapindex>

查看了下分頁是實現了，可是所有顯示成了?p=頁面數，並且在百度站長平臺上測試，發現這樣的sitemap百度報錯，因而看了下Django的源代碼:

在這裏 https://github.com/django/django/blob/1.7.7/django/contrib/sitemaps/views.py

因而對源代碼做了修改，變成了本站的sitemap的樣子，比?p=2這樣更優雅

引入下面這個好比是sitemap_views.py

import warnings
from functools import wraps
 
from django.contrib.sites.models import get_current_site
from django.core import urlresolvers
from django.core.paginator import EmptyPage, PageNotAnInteger
from django.http import Http404
from django.template.response import TemplateResponse
from django.utils import six
 
def x_robots_tag(func):
    @wraps(func)
    def inner(request, *args, **kwargs):
        response = func(request, *args, **kwargs)
        response['X-Robots-Tag'] = 'noindex, noodp, noarchive'
        return response
    return inner
 
@x_robots_tag
def index(request, sitemaps,
          template_name='sitemap_index.xml', content_type='application/xml',
          sitemap_url_name='django.contrib.sitemaps.views.sitemap',
          mimetype=None):
 
    if mimetype:
        warnings.warn("The mimetype keyword argument is deprecated, use "
            "content_type instead", DeprecationWarning, stacklevel=2)
        content_type = mimetype
 
    req_protocol = 'https' if request.is_secure() else 'http'
    req_site = get_current_site(request)
 
    sites = []
    for section, site in sitemaps.items():
        if callable(site):
            site = site()
        protocol = req_protocol if site.protocol is None else site.protocol
        for page in range(1, site.paginator.num_pages + 1):
            sitemap_url = urlresolvers.reverse(
                    sitemap_url_name, kwargs={'section': section, 'page': page})
            absolute_url = '%s://%s%s' % (protocol, req_site.domain, sitemap_url)
            sites.append(absolute_url)
 
    return TemplateResponse(request, template_name, {'sitemaps': sites},
                            content_type=content_type)
 
@x_robots_tag
def sitemap(request, sitemaps, section=None, page=1,
            template_name='sitemap.xml', content_type='application/xml',
            mimetype=None):
 
    if mimetype:
        warnings.warn("The mimetype keyword argument is deprecated, use "
            "content_type instead", DeprecationWarning, stacklevel=2)
        content_type = mimetype
 
    req_protocol = 'https' if request.is_secure() else 'http'
    req_site = get_current_site(request)
 
    if section is not None:
        if section not in sitemaps:
            raise Http404("No sitemap available for section: %r" % section)
        maps = [sitemaps[section]]
    else:
        maps = list(six.itervalues(sitemaps))
         
    urls = []
    for site in maps:
        try:
            if callable(site):
                site = site()
            urls.extend(site.get_urls(page=page, site=req_site,
                                      protocol=req_protocol))
        except EmptyPage:
            raise Http404("Page %s empty" % page)
        except PageNotAnInteger:
            raise Http404("No page '%s'" % page)
    return TemplateResponse(request, template_name, {'urlset': urls},
                            content_type=content_type)

若是還不是很懂，能夠下載附件查看：sitemap.zip

更多參考：

官方文檔：https://docs.djangoproject.com/en/dev/ref/contrib/sitemaps/

Django通用視圖

咱們用Django開發，好比作一個博客，咱們須要作一個博文列表，須要分頁，這樣咱們須要計算出一共有多少篇文章，根據每頁顯示的博文數量，咱們從數據庫是顯示出相應的頁對應的文章，這樣使用數據庫的查詢能夠實現，可是這種需求是比較廣泛的，因此Django中有更簡單的方法來實現，最簡單的方法就是使用generic類來作。

有時候咱們想將一個模版直接顯示出來，還不得不寫一個視圖函數，其實能夠用TemplateView能夠直接寫在urls.py中，這樣的例子還有不少，下面一一介紹：

在urls.py中使用類視圖的時候都是調用它都.as_view()函數

1、Base Views

一、django.views.generic.base.View

這個類是通用類的基類，其它類都是繼承類自這個類，通常不會用到這個類，我的感受用函數更簡單些。

# views.py
from django.http import HttpResponse
from django.views.generic import View
 
class MyView(View):
 
    def get(self, request, *args, **kwargs):
        return HttpResponse('Hello, World!')
 
# urls.py
from django.conf.urls import patterns, url
 
from myapp.views import MyView
 
urlpatterns = patterns('',
    url(r'^mine/$', MyView.as_view(), name='my-view'),
)

二、 django.views.generic.base.TemplateView

在get_context_data()函數中，能夠傳一些額外內容到模版

# views.py
 
from django.views.generic.base import TemplateView
 
from articles.models import Article
 
class HomePageView(TemplateView):
 
    template_name = "home.html"
 
    def get_context_data(self, **kwargs):
        context = super(HomePageView, self).get_context_data(**kwargs)
        context['latest_articles'] = Article.objects.all()[:5]
        return context
 
 
# urls.py
 
from django.conf.urls import patterns, url
 
from myapp.views import HomePageView
 
urlpatterns = patterns('',
    url(r'^$', HomePageView.as_view(), name='home'),
)

3. django.views.generic.base.RedirectView

用來進行跳轉, 默認是永久重定向（301），能夠直接在urls.py中使用，很是方便：

from django.conf.urls import patterns, url
from django.views.generic.base import RedirectView
 
urlpatterns = patterns('',
    url(r'^go-to-django/$', RedirectView.as_view(url='http://djangoproject.com'), name='go-to-django'),
    url(r'^go-to-ziqiangxuetang/$', RedirectView.as_view(url='http://localhost:8000',permant=False), name='go-to-wulaoer'),
)

其它的使用方式：(new in Django1.6)

# views.py
from django.shortcuts import get_object_or_404
from django.views.generic.base import RedirectView
 
from articles.models import Article
 
class ArticleCounterRedirectView(RedirectView):
 
    url = ' # 要跳轉的網址，
    # url 能夠不給，用 pattern_name 和 get_redirect_url() 函數 來解析到要跳轉的網址
     
    permanent = False #是否爲永久重定向, 默認爲 True
    query_string = True # 是否傳遞GET的參數到跳轉網址，True時會傳遞，默認爲 False
    pattern_name = 'article-detail' # 用來跳轉的 URL, 看下面的 get_redirect_url() 函數
 
     
    # 若是url沒有設定，此函數就會嘗試用pattern_name和從網址中捕捉的參數來獲取對應網址
    # 即 reverse(pattern_name, args) 獲得相應的網址，
    # 在這個例子中是一個文章的點擊數連接，點擊後文章瀏覽次數加1，再跳轉到真正的文章頁面
    def get_redirect_url(self, *args, **kwargs):
         If url is not set, get_redirect_url() tries to reverse the pattern_name using what was captured in the URL (both named and unnamed groups are used).
        article = get_object_or_404(Article, pk=kwargs['pk'])
        article.update_counter() # 更新文章點擊數，在models.py中實現
        return super(ArticleCounterRedirectView, self).get_redirect_url(*args, **kwargs)
 
 
# urls.py
from django.conf.urls import patterns, url
from django.views.generic.base import RedirectView
 
from article.views import ArticleCounterRedirectView, ArticleDetail
 
urlpatterns = patterns('',
 
    url(r'^counter/(?P<pk>\d+)/$', ArticleCounterRedirectView.as_view(), name='article-counter'),
    url(r'^details/(?P<pk>\d+)/$', ArticleDetail.as_view(), name='article-detail'),
)

二，Generic Display View （通用顯示視圖）

1. django.views.generic.detail.DetailView

DetailView 有如下方法：

1. dispatch()

2. http_method_not_allowed()

3. get_template_names()

4. get_slug_field()

5. get_queryset()

6. get_object()

7. get_context_object_name()

8. get_context_data()

9. get()

10. render_to_response()

# views.py
from django.views.generic.detail import DetailView
from django.utils import timezone
 
from articles.models import Article
 
class ArticleDetailView(DetailView):
 
    model = Article # 要顯示詳情內容的類
     
    template_name = 'article_detail.html' 
    # 模板名稱，默認爲 應用名/類名_detail.html（即 app/modelname_detail.html）
 
    # 在 get_context_data() 函數中能夠用於傳遞一些額外的內容到網頁
    def get_context_data(self, **kwargs):
        context = super(ArticleDetailView, self).get_context_data(**kwargs)
        context['now'] = timezone.now()
        return context
         
         
# urls.py
from django.conf.urls import url
 
from article.views import ArticleDetailView
 
urlpatterns = [
    url(r'^(?P<slug>[-_\w]+)/$', ArticleDetailView.as_view(), name='article-detail'),
]

article_detail.html

<h1>標題：{{ object.title }}</h1>
<p>內容：{{ object.content }}</p>
<p>發表人: {{ object.reporter }}</p>
<p>發表於: {{ object.pub_date|date }}</p>
 
 
<p>日期: {{ now|date }}</p>

2. django.views.generic.list.ListView

ListView 有如下方法：

1. dispatch()

2. http_method_not_allowed()

3. get_template_names()

4. get_queryset()

5. get_context_object_name()

6. get_context_data()

7. get()

8. render_to_response()

# views.py
from django.views.generic.list import ListView
from django.utils import timezone
 
from articles.models import Article
 
class ArticleListView(ListView):
 
    model = Article
 
    def get_context_data(self, **kwargs):
        context = super(ArticleListView, self).get_context_data(**kwargs)
        context['now'] = timezone.now()
        return context
 
 
 
# urls.py:
 
from django.conf.urls import url
 
from article.views import ArticleListView
 
urlpatterns = [
    url(r'^$', ArticleListView.as_view(), name='article-list'),
]

article_list.html

<h1>文章列表</h1>
<ul>
{% for article in object_list %}
    <li>{{ article.pub_date|date }} - {{ article.headline }}</li>
{% empty %}
    <li>抱歉，目前尚未文章。</li>
{% endfor %}
</ul>

Class-based views 官方文檔: 

https://docs.djangoproject.com/en/dev/ref/class-based-views/#built-in-class-based-views-api

Django 上下文渲染器

有時候咱們想把一個變量在多個模板之間共用，這時候就能夠用 Django 上下文渲染器。

一，初識上下文渲染器

咱們從視圖函數提及，在 views.py 中返回字典在模板中使用:

from django.shortcuts import render
 
def home(request):
    return render(request, 'home.html', {'info': 'Welcome to ziqiangxuetang.com !'})

這樣咱們就能夠在模板中使用 info 這個變量了。

{{ info }}

模板對應的地方就會顯示：Welcome to wulaoer.com !

可是若是咱們有一個變量，好比用戶的IP，想顯示在每一個網頁上。再好比顯示全部的欄目信息在每一個網頁上，該怎麼作呢？

一種方法是用死代碼，直接把欄目固定寫在 模塊中，這個對於不常常變更的來講也是一個辦法，簡單高效。可是要是用戶的IP這樣的因人而異的，或者常常變更的，咱們不得不用其它的辦法了。

因爲上下文渲染器API在Django 1.8 時發生了變化，被移動到了 tempate 文件夾下，因此講解的時候分兩種，一種是 Django 1.8 及之後的，和Django 1.7及之前的。

咱們來看Django官方自帶的小例子：

Django 1.8 版本：

django.template.context_processors 中有這樣一個函數

def request(request):    
    return {'request': request}

Django 1.7 及之前的代碼在這裏：django.core.context_processors.request 函數是同樣的。

在settings.py 中：

Django 1.8 版本 settings.py:

TEMPLATES = [
    {
        'BACKEND': 'django.template.backends.django.DjangoTemplates',
        'DIRS': [],
        'APP_DIRS': True,
        'OPTIONS': {
            'context_processors': [
                'django.template.context_processors.debug',
                'django.template.context_processors.request',
                'django.contrib.auth.context_processors.auth',
                'django.contrib.messages.context_processors.messages',
            ],
        },
    },
]

Django 1.7 版本 settings.py 默認是這樣的：

TEMPLATE_CONTEXT_PROCESSORS = (
    "django.contrib.auth.context_processors.auth",
    "django.core.context_processors.debug",
    "django.core.context_processors.i18n",
    "django.core.context_processors.media",
    "django.core.context_processors.static",
    "django.core.context_processors.tz",
    "django.contrib.messages.context_processors.messages"
)

咱們能夠手動添加 request 的渲染器

TEMPLATE_CONTEXT_PROCESSORS = (
    ...
    "django.core.context_processors.request",
    ...
)

這裏的 context_processors 中放了一系列的 渲染器，上下文渲染器 其實就是函數返回字典，這些值能夠用在模板中。

request 函數就是在返回一個字典，每個模板中均可以使用這個字典中提供的 request 變量。

好比 在template 中 獲取當前訪問的用戶的用戶名：

User Name: {{ request.user.username }}

二，動手寫個上下文渲染器

2.1 新建一個項目，基於 Django 1.8，低版本的請自行修改對應地方：

django-admin.py startproject wulaoer
cd wulaoer
python manage.py startapp blog

咱們新建了 wulaoer 項目和 blog 這個應用。

把 blog 這個app 加入到 settings.py 中

整個項目當前目錄結構以下：

wulaoer
├── blog
│   ├── __init__.py
│   ├── admin.py
│   ├── migrations
│   │   └── __init__.py
│   ├── models.py
│   ├── tests.py
│   └── views.py
├── manage.py
└── wulaoer
    ├── __init__.py
    ├── settings.py
    ├── urls.py
    └── wsgi.py

2.2 咱們在 wulaoer/wulaoer 這個目錄下（與settings.py 在一塊兒）新建一個 context_processor.py　　

#!/usr/bin/env python
# -*- coding: utf-8 -*-
 
from django.conf import settings as original_settings
 
 
def settings(request):
    return {'settings': original_settings}
 
 
def ip_address(request):
    return {'ip_address': request.META['REMOTE_ADDR']}

2.3 咱們把新建的兩個 上下文渲染器 加入到 settings.py 中：

TEMPLATES = [
    {
        'BACKEND': 'django.template.backends.django.DjangoTemplates',
        'DIRS': [],
        'APP_DIRS': True,
        'OPTIONS': {
            'context_processors': [
                'django.template.context_processors.debug',
                'django.template.context_processors.request',
                'django.contrib.auth.context_processors.auth',
                'django.contrib.messages.context_processors.messages',
 
                'zqxt.context_processor.settings',
                'zqxt.context_processor.ip_address',
            ],
        },
    },
]

最後面兩個是咱們新加入的，咱們稍後在模板中測試它。

2.4 修改 blog/views.py

from django.shortcuts import render
 
 
def index(reuqest):
    return render(reuqest, 'blog/index.html')
 
 
def columns(request):
    return render(request, 'blog/columns.html')

2.5 新建兩個模板文件，放在 wulaoer/blog/template/blog/ 中

index.html

<h1>Blog Home Page</h1>
 
DEBUG: {{ settings.DEBUG }}
 
ip: {{ ip_address }}

columns.html

<h1>Blog Columns</h1>
 
DEBUG: {{ settings.DEBUG }}
 
ip: {{ ip_address }}

2.6 修改 wulaoer/urls.py　　

from django.conf.urls import include, url
from django.contrib import admin
from blog import views as blog_views
 
urlpatterns = [
    url(r'^blog_home/$', blog_views.index),
    url(r'^blog_columns/$', blog_views.columns),
    url(r'^admin/', include(admin.site.urls)),
]

2.7 打開開發服務器並訪問，進行測試吧：

python manage.py runserver

就會看到全部的模板均可以使用 settings 和 ip_address 變量：

http://127.0.0.1:8000/blog_home/

http://127.0.0.1:8000/blog_columns/