跳转到主要内容

Django模板加载器,允许您从特定的Django应用程序加载和覆盖模板。

项目描述

Build status Code health Python versions Software license

django-apptemplates 是一个 Django 模板加载器,允许您从特定应用程序中加载模板。通过这种方式,您可以在同一时间扩展和覆盖模板。默认的 Django 加载器需要您复制要覆盖的整个模板,即使您只想覆盖一小部分。

基于: http://djangosnippets.org/snippets/1376/

版本支持

django-apptemplates 已通过 测试 官方支持的 Python 和 Django 组合,自 Django 1.4 以来(Python 2.7 上的 Django 1.4 至 3.0,以及 3.4 至 3.8)。

安装、设置和使用

此软件包可在 PyPI 上获取。要安装它,只需执行

$ pip install django-apptemplates

设置(适用于 Django 1.8+)

TEMPLATES = [
    {
        'BACKEND': 'django.template.backends.django.DjangoTemplates',
        'OPTIONS': {
            'loaders': [
                'apptemplates.Loader',
                'django.template.loaders.filesystem.Loader',
                'django.template.loaders.app_directories.Loader',
            ],
        },
    },
]

设置(适用于 Django < 1.8)

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

如何在模板中使用

模板使用示例(扩展和覆盖 Django 管理员基本模板)

{% extends "admin:admin/base.html" %}

冒号(:)之前的部分被称为 Django 应用 命名空间

替代方案

作者和维护者

变更日志

(未发布)

  • 停止支持 Django 1.7(ImportError)

  • 停止支持 Python 2.6、3.2、3.3(Travis CI 上不可用)

1.4

  • 修复 Origin 缺失加载器和 template_name 属性 - 感谢 Brendan Roy,@bmon 和 Matthew Somerville,@dracos!

  • 也测试了 Django 2.0

1.3

  • 将模板加载器添加到返回的 Origins 中 - 感谢 J.J.,@jdotjdot!

  • 也测试了 Python 3.6 - 感谢 Justin Walgran,@jwalgran!

1.2

  • 重新支持 Django 1.4 至 1.8(自版本 1.1 以来已损坏)

  • 添加模板渲染测试

  • 停止支持 Django 1.3(无法通过测试验证)

  • 停止支持 Python 2.4 和 2.5(无法再进行测试)

1.1.1

  • 修复 Django 1.8 的 ImportError - 在版本 1.1 中已损坏

  • 添加集成测试(测试跨支持版本的包导入)

  • 将 clean 和 test 命令添加到 setup.py

1.1

  • 使用 django.template.Origin 计算模板位置以实现 Django 1.9 兼容性。 - 感谢,Gilles Crettenand

1.0

  • 删除 Django 1.9 的导入弃用警告

  • 更新 README,包含 Django 1.8+ 的说明

0.2

跳过以修复 setup.py 和 PyPI 软件包中的版本冲突

0.0.1

  • 按照最初在 djangosnippets 上发布的方式发布

下载文件

下载适用于您的平台的文件。如果您不确定选择哪个,请了解有关 安装软件包 的更多信息。

源分布

django-apptemplates-1.5.tar.gz (5.1 kB 查看散列

上传时间

构建分布

django_apptemplates-1.5-py2-none-any.whl (8.4 kB 查看哈希值)

上传时间 Python 2

支持者

AWS AWS 云计算和安全赞助商 Datadog Datadog 监控 Fastly Fastly CDN Google Google 下载分析 Microsoft Microsoft PSF 赞助商 Pingdom Pingdom 监控 Sentry Sentry 错误日志 StatusPage StatusPage 状态页面