Django Blog Zinnia 高级配置指南

Django Blog Zinnia 高级配置指南

前言

Django Blog Zinnia 是一个功能强大的博客应用，提供了丰富的配置选项来满足不同场景的需求。本文将深入探讨 Zinnia 的高级配置技巧，帮助开发者更好地定制自己的博客系统。

站点地图(Sitemap)配置

站点地图对于SEO优化至关重要。Zinnia 提供了完善的站点地图支持，可以自动生成包含博客文章、作者、分类和标签的站点地图。

配置步骤：

1. 确保 django.contrib.sitemaps 已添加到 INSTALLED_APPS 中
2. 在项目的URL配置中添加以下代码：

from django.contrib.sitemaps.views import index, sitemap
from zinnia.sitemaps import AuthorSitemap, CategorySitemap, EntrySitemap, TagSitemap

sitemaps = {
    'tags': TagSitemap,
    'blog': EntrySitemap,
    'authors': AuthorSitemap,
    'categories': CategorySitemap
}

urlpatterns += [
    url(r'^sitemap.xml$', index, {'sitemaps': sitemaps}),
    url(r'^sitemap-(?P<section>.+)\.xml$', 
        sitemap,
        {'sitemaps': sitemaps},
        name='django.contrib.sitemaps.views.sitemap'),
]

这样配置后，系统会自动生成四种类型的站点地图，搜索引擎可以更好地索引你的博客内容。

文章模板定制

Zinnia 允许为不同类型的文章使用不同的模板，这为内容展示提供了极大的灵活性。

内容模板定制

例如，如果你想为简短内容（如引用）创建特殊模板：

1. 在项目配置中添加：

ZINNIA_ENTRY_CONTENT_TEMPLATES = [
    ('zinnia/_short_entry_detail.html', 'Short entry template'),
]

2. 创建模板文件 zinnia/_short_entry_detail.html：

{% extends "zinnia/_entry_detail.html" %}
{% block continue-reading %}{% endblock %}

这样配置后，在文章列表中选择此模板的文章将不会显示"继续阅读"链接。

详情页模板定制

如果你想创建全宽度的详情页模板（不显示侧边栏）：

1. 在项目配置中添加：

ZINNIA_ENTRY_DETAIL_TEMPLATES = [
    ('zinnia/fullwidth_entry_detail.html', 'Fullwidth template'),
]

2. 创建模板文件 zinnia/fullwidth_entry_detail.html：

{% extends "zinnia/entry_detail.html" %}
{% block sidebar-class %}no-sidebar{% endblock %}
{% block sidebar %}{% endblock %}

自动通知(Ping)配置

Zinnia 默认会在发布新文章时自动通知搜索引擎和目录服务。你可以通过以下设置控制此行为：

ZINNIA_PING_EXTERNAL_URLS = False  # 禁用对外部URL的ping
ZINNIA_SAVE_PING_DIRECTORIES = False  # 禁用对目录服务的ping

自定义要通知的目录服务：

ZINNIA_PING_DIRECTORIES = (
    'http://ping.directory.com/',
    'http://pong.directory.com/'
)

标记语言支持

Zinnia 支持多种标记语言编写文章内容，包括：

• Markdown
• Textile
• reStructuredText

要启用标记语言支持：

1. 在项目配置中设置：

ZINNIA_MARKUP_LANGUAGE = 'restructuredtext'  # 小写名称

2. 安装相应的解析库：

• Textile: 需要安装 textile 库(>=2.1.5)
• Markdown: 需要安装 markdown 库(>=2.3.1)
• reStructuredText: 需要安装 docutils 库(>=0.10)

缓存配置

为提高性能，Zinnia 使用Django缓存API进行文章比较操作。建议配置专门的比较缓存：

CACHES = {
    'default': {
        'BACKEND': 'django.core.cache.backends.locmem.LocMemCache',
    },
    'comparison': {
        'BACKEND': 'django.core.cache.backends.locmem.LocMemCache',
        'LOCATION': 'comparison',
        'TIMEOUT': None,  # 永不过期
    }
}

如果没有配置专门的比较缓存，系统将使用默认缓存。

XML-RPC接口

Zinnia 提供了XML-RPC接口支持，允许通过远程调用管理博客内容。

配置步骤：

1. 安装 django-xmlrpc 库
2. 将 django_xmlrpc 添加到 INSTALLED_APPS
3. 在URL配置中添加：

url(r'^xmlrpc/$', 'django_xmlrpc.views.handle_xmlrpc'),

注意：如需支持Pingback服务，请确保你的站点已启用Pingback检测功能。

总结

通过本文介绍的高级配置选项，你可以充分发挥 Django Blog Zinnia 的潜力，打造一个功能丰富、性能优越的博客系统。从SEO优化到内容展示，从性能提升到远程管理，Zinnia 提供了全面的解决方案。