Конфигурация

Добавьте дополнительную пустую строку после групп тегов {% <tag> ... %}.

blank_line_after_tag="load,extends,include"

"blank_line_after_tag": "load,extends,include"

--blank-line-after-tag "load,extends,include"

Добавляет дополнительную пустую строку перед группами тегов {% <tag> ... %}. Пустые строки никогда не будут добавлены в начало файла или между похожими тегами.

blank_line_before_tag="load,extends,include"

"blank_line_before_tag": "load,extends,include"

--blank-line-before-tag "load,extends,include"

Закрыть недействительные теги.

close_void_tags=true

"close_void_tags": true

--close-void-tags

Используется для отступов в пользовательских блоках кода. Например, {% toc %}...{% endtoc %}

custom_blocks="toc,example"

"custom_blocks": "toc,example"

--custom-blocks "toc,example"

Используется для отступа пользовательских HTML-тегов. Например, <mjml> или <simple-greeting> или <mj-\\w+>.

custom_html="mjml,simple-greeting,mj-\w+"

"custom_html": "mjml,simple-greeting,mj-\w+"

--custom_html "mjml,simple-greeting,mj-\\w+"

Переопределите пути исключения по умолчанию.

exclude=".venv,venv,.tox,.eggs,..."

"exclude": ".venv,venv,.tox,.eggs,..."

--exclude ".venv,venv,.tox,.eggs,..."

Добавьте дополнительные пути к исключаемым по умолчанию.

extend_exclude=".custom"

"extend_exclude": ".custom"

--extend-exclude ".custom"

Используется для поиска файлов только с определенным расширением.

extension="html.dj"

"extension": "html.dj"

--extension "html.dj"
# or
-e "html.dj"

Список путей для использования в качестве источника djlint. Когда указана эта опция, источник командной строки должен быть -, как при использовании stdin.

[tool.djlint]
files=["index.html"]

"files": [
    "index.html"
]

index.html

Форматировщик будет пытаться форматировать синтаксис шаблона внутри атрибутов тега. По умолчанию отключен.

format_attribute_template_tags=true

"format_attribute_template_tags": true

--format-attribute-template-tags

Форматирование содержимого тегов script с помощью css-beautify. Все параметры конфигурации см. в css-beautify. Синтаксис шаблона не полностью поддерживается в поддерживается.

[tool.djlint]
format_css=true

[tool.djlint.css]
indent_size=5

"format_css": true
"css": {
        "indent_size": 5
    }

--format-css --indent-css 5

Форматирование содержимого тегов script с помощью js-beautify. Все параметры конфигурации см. в js-beautify. Синтаксис шаблона не полностью поддерживается в поддерживается.

[tool.djlint]
format_js=true

[tool.djlint.js]
indent_size=5

"format_js": true
"js": {
        "indent_size": 5
    }

--format-js --indent-js 5

Игнорируйте коды линтера.

ignore="H014,H015"

"ignore": "H014,H015"

--ignore "H014,H015"

Используется для пропуска отступов для дочерних тегов шаблона. Дочерние теги будут рассматриваться как родные братья и сестры и будут иметь соответствующий отступ.

ignore_blocks="raw,example"

"ignore_blocks": "raw,example"

--ignore-blocks "raw,example"

Не пытайтесь исправить регистр известных html-тегов.

[tool.djlint]
ignore_case=true

"ignore_case": true

--ignore_case

Включите коды линтера.

include="H014,H015"

"include": "H014,H015"

--include "H014,H015"

Используется для изменения отступа кода. По умолчанию - 4 (четыре пробела).

indent=3

"indent": "3"

--indent 3

Не сжимайте содержимое многострочных тегов в строку последнего атрибута.

line_break_after_multiline_tag=true

"line_break_after_multiline_tag": "true"

--line-break-after-multiline-tag

Настройка порядка вывода сообщения. По умолчанию=“{code} {line} {message} {match}”. Если {filename} не включено в сообщение, то вывод будет сгруппирован по файлам и к каждой группе будет автоматически добавлен заголовок.

Optional variables:

linter_output_format="{filename}:{line}: {code} {message} {match}"

"linter_output_format": "{filename}:{line}: {code} {message} {match}"

--linter_output_format "{filename}:{line}: {code} {message} {match}"

Форматировщик попытается обернуть атрибуты тега, если длина атрибута превышает это значение.

max_attribute_length=10

"max_attribute_length": "10"

--max-attribute-length 10

Объедините пустые строки до х строк. По умолчанию 0, что означает, что пустые строки будут удалены.

max_blank_lines=5

"max_blank_lines": 5

--max_blank_lines 5

Форматировщик попытается разместить некоторые html и шаблонные теги на одной строке вместо того, чтобы обернуть их, если длина строки не превышает этого значения.

max_line_length=120

"max_line_length": "120"

--max_line_length 120

Не пытайтесь форматировать содержимое функции. ** Если вы используете эту опцию, пожалуйста, откройте проблему gh, объяснив, что заставило вас ее использовать.

no_function_formatting=true

"no_function_formatting": true

--no-function-formatting

Не добавляйте пустую строку после лицевой части yaml.

no_line_after_yaml=true

"no_line_after_yaml": true

--no-line-after-yaml

Не пытайтесь форматировать содержимое набора. ** Если вы используете эту опцию, пожалуйста, откройте проблему gh, объяснив, что заставило вас использовать ее.

no_set_formatting=true

"no_set_formatting": true

--no-set-formatting

Игнорировать правила линтера на основе каждого файла.

[tool.djlint.per-file-ignores]
"file.html"= "H026,H025"
"file_two.html"="H001"

"per-file-ignores": {
        "file.html": "H026,H025",
        "file_two.html":"H001"
    }

--per-file-ignores "file.html" "H026,H025" --per-file-ignores "file_two.html" "H001"

Сохраняйте пробелы там, где это возможно. Идеально подходит для не-html файлов шаблонов, где пустые строки являются намеренными.

preserve_blank_lines=true

"preserve_blank_lines": true

--preserve_blank_lines

Сохраняет пробелы в тексте, где это возможно. Идеально подходит для не-html файлов шаблонов, где отступ текста является намеренным.

preserve_leading_space=true

"preserve_leading_space": true

--preserve_leading_space

Установите профиль для языка шаблона. Профиль будет включать правила линтера, применимые к языку шаблонов, а также может изменять переформатирование. Например, в handlebars нет пробелов внутри тегов {{#if}}.

Options:

profile="django"

"profile": "django"

--profile "django"

Не печатайте diff при переформатировании.

--quiet

Форматировать или линтовать только те файлы, которые начинаются с комментария, содержащего только текст ‘djlint:on’. Комментарий может быть HTML-комментарием или комментарием на языке шаблонов, определенном настройкой профиля. Если профиль не указан, принимается комментарий на любом из языков шаблонов.

<!-- djlint:on -->
{# djlint:on #}
{% comment %} djlint:on {% endcomment %}
{{ /* djlint:on */ }}
{{!-- djlint:on --}}

require_pragma=true

"require_pragma": true

--require_pragma

Добавьте исключения .gitignore к исключениям по умолчанию.

use_gitignore=true

"use_gitignore": true

--use_gitignore

Покажите версию и выйдите.

--version

Возвращать ошибки в виде предупреждений.

--warn