django-absolute 0.3

安装

您可以使用pip安装Django Absolute

pip install django-absolute

或使用easy_install

easy_install django-absolute

将absolute添加到您的settings.INSTALLED_APPS。

上下文处理器

将absolute.context_processors.absolute添加到您的settings.TEMPLATE_CONTEXT_PROCESSORS。Django Absolute上下文处理器依赖于请求上下文处理器

from django.conf import global_settings

TEMPLATE_CONTEXT_PROCESSORS = global_settings.TEMPLATE_CONTEXT_PROCESSORS + (
    'django.core.context_processors.request',
    'absolute.context_processors.absolute',
)

然后您可以在模板中访问以下变量

• ABSOLUTE_ROOT：基于传入请求的完整绝对根URL（不包含尾部斜杠）

• ABSOLUTE_ROOT_URL：基于传入请求的完整绝对根URL（包含尾部斜杠）

• SITE_ROOT：基于当前Django Site的完整绝对根URL（不包含尾部斜杠）

• SITE_ROOT_URL：基于当前Django site的完整绝对根URL（包含尾部斜杠）

模板标记

Django绝对提供了2个模板标记

• absolute：类似于url，但基于传入请求提供完整的URL。

• site：类似于url，但基于当前Django Site提供完整的URL。

要使用这些模板标记，您需要加载absolute模板标记库。

{% load absolute %}

{% url index %}
{% absolute index %}
{% site index %}

这些模板标签的语法与 url 完全相同，包括“as”语法。

{% absolute index as the_url %}
{{ the_url }}

如果您使用 Django 1.5，需要使用“新式”URL 语法（引用参数）。

{% load absolute %}

{% url "index" %}
{% absolute "index" %}
{% site "index" %}

{% absolute "index" as the_url %}
{{ the_url }}

如果您想匹配 Django < 1.5 的“新式”语法，需要加载 absolute_future（与 {% load url from future %} 具有相同的行为）。

{% load url from future %}
{% load absolute_future %}

{% url "index" %}
{% absolute "index" %}
{% site "index" %}

{% absolute "index" as the_url %}
{{ the_url }}

有关更多信息，请参阅 Django 1.5 版本说明。

0.3 (2013-03-03)

• 检查 django.contrib.sites 是否已启用（感谢 Rodrigo Primo）

• Django 1.5 兼容性（文档和测试）

• 添加 absolute_future 模板标签库（匹配 {% load url from future %} 语法）。

• 停止对 Python 2.6 的支持（仅测试）

0.2.2 (2012-11-18)

• 处理模板标签 as 语法

0.2.1 (2012-11-10)

• 修复打包问题

0.2 (2012-11-10)

• {% site %} 如果 request 缺失，将回退到 http 协议。

0.1 (2012-06-10)

• 初始版本