django-wrapper-tag 0.1.17

文件

包装标签提供包装标签的基类。包装可以定义关键字参数的标记，关键字 参数以声明方式分组，并提供多个模板呈现步骤。

示例：

from django import template
register = template.Library()

@wrapper_tag.register_tag(register)
class ExampleTag(wrapper_tag.Tag):

    title = wrapper_tag.Keyword(help_text=('title for example tag'))

    class Meta:
        template = "<div{{ title__rendered }}>{{ content }}</div>"

    def render_title(self, argument, data, context):
        if argument.name not in data:
            return
        return ' title="{title}"'.format(data[argument.name])

然后只需在模板中使用标记：

{% example title="Some informational title" %}
    Content
{% end:example %}

这将屈服于：

<div title="Some informational title">
    Content
</div>

这只是包装标签能做的一个简单的例子。它能做的远不止这些。

快速启动

安装包装标签：

pip install django-wrapper-tag

然后在项目中使用：

INSTALLED_APPS = (
    'wrapper_tag',
)

功能

包装器标记为标记和参数提供了多个功能。

• 自动生成关于标记文档参数的documantation
• 定义标记别名并自动将其注册为标记
• 提供标记的自定义呈现方法（render_tag）
• 当启用模板调试时，包装器标记运行回调的验证

标记参数功能：

• 参数的默认值
• 论据的选择
• 参数验证器

运行测试

代码真的有用吗？

source <YOURVIRTUALENV>/bin/activate
(myenv) $ pip install -r requirements_test.txt
(myenv) $ python runtests.py

学分

用于呈现此包的工具：

• Cookiecutter
• cookiecutter-djangopackage

历史记录

0.1.0（2016-09-29）

• pypi上的第一个版本。