djade 1.2.0

pre-commit钩子

您还可以将Djade作为pre-commit钩子安装。

首先， 将以下内容添加到你的 .pre-commit-config.yaml 文件的 repos 部分 (文档)

-   repo: https://github.com/adamchainz/djade-pre-commit
    rev: ""  # Replace with the latest tag on GitHub
    hooks:
    -   id: djade
        args: [--target-version, "5.1"]  # Replace with Django version

独立的仓库可以使得安装时无需编译Rust代码。

默认配置使用pre-commit的 files 选项 来获取所有名为 templates 的目录中的所有文本文件（源）。如果你有不同目录中的模板，可能需要通过在 .pre-commit-config.yaml 文件中的钩子配置中添加 files 来覆盖此设置。

其次， 格式化整个项目

pre-commit run djade --all-files

检查这些更改是否存在Djade的潜在错误，并将它们提交。尝试使用 git diff --ignore-all-space 来检查非空白字符的更改。

第三， 考虑将上一个提交的SHA添加到 .git-blame-ignore-revs 文件 中。这将防止初始化格式化提交出现在 git blame 中。

保持钩子安装状态以继续格式化模板。pre-commit的 autoupdate 命令将升级Djade，以便你可以利用未来的功能。

--target-version

可选：要针对的Django版本，格式为 <major>.<minor>。如果提供，Djade将为目标版本及其以上版本启用修复器。使用 djade --help 查看可用版本的列表。

--check

避免将任何格式化文件写回。相反，如果任何文件将被修改，则使用非零状态码退出，否则使用零。

Django 4.2+：length_is -> length

来自发布说明

模板过滤器length_is已被弃用，现在使用length和{% if %}标签内的==操作符。

Djade适当地更新了if标签内弃用的过滤器使用

-{% if engines|length_is:1 %}
+{% if engines|length == 1 %}

Django 4.1+：json_script空ID修复程序

来自发布说明

当使用json_script模板过滤器时，HTML<script>元素的id属性不再需要。

Djade移除了传递空字符串给json_script时的参数，以避免发出id=""

-{% tracks|json_script:"" %}
+{% tracks|json_script %}

Django 3.1+：trans -> translate，blocktrans / endblocktrans -> blocktranslate / endblocktranslate

来自发布说明

为模板代码中的国际化引入了重命名的translate和blocktranslate模板标签。旧的trans和blocktrans模板标签别名继续工作，并将保留在可预见的未来。

Djade适当地更新了弃用的标签

-{% load blocktrans trans from i18n %}
+{% load blocktranslate translate from i18n %}

-{% trans "Engine colours" %}
+{% translate "Engine colours" %}

-{% blocktrans with colour=engine.colour %}
+{% blocktranslate with colour=engine.colour %}
 This engine is {{ colour }}.
-{% endblocktrans %}
+{% endblocktranslate %}

Django 3.1+：ifequal和ifnotequal -> if

来自发布说明

模板标签{% ifequal %}和{% ifnotequal %}已被弃用，现在使用{% if %}。

Djade适当地更新了弃用的标签

-{% ifequal engine.colour 'blue' %}
+{% if engine.colour == 'blue' %}
 Thomas!
-{% endifequal %}
+{% endif %}

-{% ifnotequal engine.colour 'blue' %}
+{% if engine.colour != 'blue' %}
 Not Thomas.
-{% endifnotequal %}
+{% endif %}

Django 2.1+：admin_static和staticfiles -> static

来自发布说明

{% load staticfiles %}和{% load admin_static %}已被弃用，现在使用{% load static %}，效果相同。

Djade适当地更新了{% load %}标签

-{% load staticfiles %}
+{% load static %}

-{% load admin_static %}
+{% load static %}