djlint 1.30.0 → 1.30.2

package/docs/src/ru/docs/getting-started.md

@@ -1,127 +0,0 @@
----
-description: Начало работы с djLint для линтинга и форматирования HTML-шаблонов. Воспользуйтесь простым интерфейсом cli и множеством опций форматирования.
-title: Начало работы
-keywords: облицовка шаблонов, форматер шаблонов, djLint, HTML, шаблоны, форматер, линтер, использование
----
-
-# {{ "getting_started" | i18n }}
-
-## Установка от [Pypi](https://pypi.org/project/djlint/)
-
-djLint собирается с [Python](https://python.org), он может быть установлен простым запуском:
-
-```bash
-pip install djlint
-```
-
-_Или с помощью npm экспериментальная установка - Обратите внимание, это требует, чтобы python и pip были в вашем системном пути._
-
-```bash
-npm i djlint
-```
-
-## Использование CLI
-
-djLint - это приложение командной строки. Для расширенной настройки смотрите `конфигурация`.
-
-{% raw %}
-
-```bash
-Usage: djlint [OPTIONS] SRC ...
-
-  djLint · lint and reformat HTML templates.
-
-Options:
-  --version                       Show the version and exit.
-  -e, --extension TEXT            File extension to check [default: html]
-  -i, --ignore TEXT               Codes to ignore. ex: "H014,H017"
-  --reformat                      Reformat the file(s).
-  --check                         Check formatting on the file(s).
-  --indent INTEGER                Indent spacing. [default: 4]
-  --quiet                         Do not print diff when reformatting.
-  --profile TEXT                  Enable defaults by template language. ops:
-                                  django, jinja, nunjucks, handlebars, golang,
-                                  angular, html [default: html]
-  --require-pragma                Only format or lint files that starts with a
-                                  comment with the text 'djlint:on'
-  --lint                          Lint for common issues. [default option]
-  --use-gitignore                 Use .gitignore file to extend excludes.
-  --warn                          Return errors as warnings.
-  --preserve-leading-space        Attempt to preserve leading space on text.
-  --preserve-blank-lines          Attempt to preserve blank lines.
-  --format-css                    Also format contents of <style> tags.
-  --format-js                     Also format contents of <script> tags.
-  --configuration PATH            Path to global configuration file in
-                                  .djlintrc format
-  --statistics                    Count the number of occurrences of each
-                                  error/warning code.
-  --include TEXT                  Codes to include. ex: "H014,H017"
-  --ignore-case                   Do not fix case on known html tags.
-  --ignore-blocks TEXT            Comma list of template blocks to not indent.
-  --blank-line-after-tag TEXT     Add an additional blank line after {% <tag>
-                                  ... %} tag groups.
-  --blank-line-before-tag TEXT    Add an additional blank line before {% <tag>
-                                  ... %} tag groups.
-  --custom-blocks TEXT            Indent custom template blocks. For example
-                                  {% toc %}...{% endtoc %}
-  --custom-html TEXT              Indent custom HTML tags. For example <mjml>
-  --exclude TEXT                  Override the default exclude paths.
-  --extend-exclude TEXT           Add additional paths to the default exclude.
-  --linter-output-format TEXT     Customize order of linter output message.
-  --max-line-length INTEGER       Max line length. [default: 120]
-  --max-attribute-length INTEGER  Max attribute length. [default: 70]
-  --format-attribute-template-tags
-                                  Attempt to format template syntax inside of
-                                  tag attributes.
-  --per-file-ignores <TEXT TEXT>...
-                                  Ignore linter rules on a per-file basis.
-  --indent-css INTEGER            Set CSS indent level.
-  --indent-js INTEGER             Set JS indent level.
-  --close-void-tags               Add closing mark on known void tags. Ex:
-                                  <img> becomse <img />
-  --no-line-after-yaml            Do not add a blank line after yaml front
-                                  matter.
-  -h, --help                      Show this message and exit.
-```
-
-{% endraw %}
-
-{% admonition
-   "note",
-   "Note",
-   "Если команда `djlint` не найдена, убедитесь, что Python находится [в вашем пути](https://www.geeksforgeeks.org/how-to-add-python-to-windows-path/)."
-%}
-
-## Использование Path против Stdin
-
-djLint работает с путем или stdin.
-
-Бег с тропинкой -
-
-```bash
-djlint /path/to/templates --lint
-```
-
-Или конкретный файл -
-
-```bash
-djlint /path/to/this.mustache --lint
-```
-
-Или с помощью stdin -
-
-```bash
-echo "<div></div>" | djlint -
-```
-
-Stdin также может быть использован для переформатирования кода. На выходе будет только отформатированный код без сообщений.
-
-```bash
-echo "<div></div>" | djlint - --reformat
-```
-
-Выход -
-
-```html
-<div></div>
-```

package/docs/src/ru/docs/ignoring-code.md

@@ -1,75 +0,0 @@
----
-description: Как запретить djLint форматировать блок кода. Как игнорировать правила djLint в строке.
-title: Игнорирование кодекса
-keywords: облицовка шаблонов, форматер шаблонов, djLint, HTML, шаблоны, форматер, линтер, использование, Использование форматера
-date: Last Modified
----
-
-## Игнорирование кодекса
-
-Код можно игнорировать, обернув его в теги `djlint`:
-
-{% raw %}
-
-Для простого старого html -
-
-```html
-<!-- djlint:off -->
-<плохой html, который следует игнорировать> <!-- djlint:on --></bad>
-```
-
-или как комментарий -
-
-```html
-{# djlint:off #} <плохой html, который следует игнорировать> {# djlint:on #}</bad>
-```
-
-или в виде длинного комментария
-
-```html
-{% comment %} djlint:off {% endcomment %}
-<плохой html, который следует игнорировать> {% comment %} djlint:on {% endcomment %}</bad>
-```
-
-или как комментарий в стиле javascript -
-
-```html
-{{ /* djlint:off */ }} <плохой html, который следует игнорировать> {{ /* djlint:on */ }}</bad>
-```
-
-или как комментарий в стиле golang -
-
-```html
-{{!-- djlint:off --}} <плохой html, который следует игнорировать> {{!-- djlint:on --}}</bad>
-```
-
-{% endraw %}
-
-## Игнорирование правил
-
-Определенные правила linter можно игнорировать, добавив имя правила в открывающий тег игнорируемого блока.
-
-{% raw %}
-
-```html
-{# djlint:off H025,H026 #}
-<p>
-  {# djlint:on #}
-
-  <!-- djlint:off H025-->
-</p>
-
-<p>
-  <!-- djlint:on -->
-
-  {% comment %} djlint:off H025 {% endcomment %}
-</p>
-
-<p>{% comment %} djlint:on {% endcomment %} {{!-- djlint:off H025 --}}</p>
-
-<p>{{!-- djlint:on --}} {{ /* djlint:off H025 */ }}</p>
-
-<p>{{ /* djlint:on */ }}</p>
-```
-
-{% endraw %}

package/docs/src/ru/docs/integrations.md

@@ -1,100 +0,0 @@
----
-description: Интегрируйте djLint с вашим любимым редактором. Автоматическое форматирование ваших шаблонов с помощью Pre-Commit или Visual Studio Code. Lint с SublimeText.
-title: Интеграции
-keywords: облицовка шаблонов, форматер шаблонов, djLint, HTML, шаблоны, форматер, линтер, использование, integrations
----
-
-# {{ "integrations" | i18n }}
-
-Существует несколько интеграций редакторов для djLint.
-
-## Pre-Commit
-
-djLint можно использовать как [pre-commit](https://pre-commit.com) хук в качестве как линтера, так и форматировщика.
-
-Репозиторий предоставляет несколько предварительно настроенных хуков для определенных профилей djLint (он просто задает аргумент `--profile` и указывает pre-commit, какие расширения файлов искать):
-
-::: content
-
-- `djlint` для линтинга и `djlint-reformat` для форматирования
-  Будет искать файлы, соответствующие `templates/**.html`, без установки `--profile`.
-- `djlint-django` и `djlint-reformat-django`
-  Будет искать файлы, соответствующие `templates/**.html`, и устанавливать `--profile=django`.
-- `djlint-jinja` и `djlint-reformat-jinja`
-  Будет искать файлы, соответствующие `*.j2`, `*.jinja` или `*.jinja2`, и устанавливать `--profile=jinja`.
-- `djlint-nunjucks` и `djlint-reformat-nunjucks`
-  Будет искать файлы, соответствующие `*.njk`, и устанавливать `--profile=nunjucks`.
-- `djlint-handlebars` и `djlint-reformat-handlebars`
-  Будет искать файлы, соответствующие `*.hbs`, и устанавливать `--profile=handlebars`.
-- `djlint-golang` и `djlint-reformat-golang`
-  Будет искать файлы, соответствующие `*.tmpl`, и устанавливать `--profile=golang`.
-  :::
-
-Обратите внимание, что эти предопределенные хуки иногда слишком консервативны в принимаемых ими входных данных (ваши шаблоны могут использовать другое расширение), поэтому pre-commit явно позволяет вам переопределять любые из этих предопределенных опций. См. [pre-commit документы](https://pre-commit.com/#pre-commit-configyaml---hooks) для дополнительной настройки.
-
-### Пример Django по умолчанию
-
-```yaml
-repos:
-  - repo: https://github.com/Riverside-Healthcare/djLint
-    rev: v{{ djlint_version }}
-    hooks:
-      - id: djlint-reformat-django
-      - id: djlint-django
-```
-
-### Handlebars с расширением .html вместо .hbs
-
-```yaml
-repos:
-  - repo: https://github.com/Riverside-Healthcare/djLint
-    rev: v{{ djlint_version }}
-    hooks:
-      - id: djlint-reformat-handlebars
-        files: "\\.html"
-        types_or: ['html']
-      - id: djlint-handlebars
-        files: "\\.html"
-        types_or: ['html']
-```
-
-Вы можете использовать параметры `files` или `exclude`, чтобы ограничить каждый хук своим каталогом, что позволит вам поддерживать несколько языков шаблонов в одном репозитории.
-
-## SublimeText Linter
-
-djLint можно использовать в качестве плагина SublimeText Linter. Его можно установить через [package-control](https://packagecontrol.io/packages/SublimeLinter-contrib-djlint).
-
-::: content
-
-1. `cmd + shft + p`
-2. Install SublimeLinter
-3. Install SublimeLinter-contrib-djlint
-   :::
-
-Убедитесь, что djLint установлен в вашем глобальном python или в вашем `PATH`.
-
-## Visual Studio Code
-
-::: content
-
-- [GitHub репозиторий](https://github.com/monosans/djlint-vscode)
-- [Страница на VS Marketplace](https://marketplace.visualstudio.com/items?itemName=monosans.djlint)
-- [Страница на Open VSX](https://open-vsx.org/extension/monosans/djlint)
-  :::
-
-## neovim
-
-djLint можно использовать в качестве форматера в neovim с помощью плагина `null-ls`.
-
-::: content
-
-- [GitHub репозиторий](https://github.com/jose-elias-alvarez/null-ls.nvim/)
-- [Пример конфигурации](https://github.com/shaeinst/roshnivim/blob/5d991fcfa1b8f865f9653a98c6d97a829d4a2add/lua/plugins/null-ls_nvim.lua#L84-L91)
-  :::
-
-## coc.nvim
-
-::: content
-
-- [npm package](https://www.npmjs.com/package/coc-htmldjango)
-  :::

package/docs/src/ru/docs/languages/angular.md

@@ -1,31 +0,0 @@
----
-title: Angular Template Linter
-keywords: angular, djlint, angular template linter, lint angular templates
-description: djLint - это ангулярный линтер шаблонов! Используйте преимущества профиля предварительной сборки при линтинге и форматировании ваших шаблонов с помощью djLint.
-tool: angular
----
-
-# {{ title }}
-
-{{ description }}
-
-**[Что такое Angular?](https://angular.io/guide/template-syntax)**
-
-#### Использование командной строки
-
-```bash
-djlint /path/to/templates --profile={{ tool }}
-```
-
-#### Или используйте файл конфигурации
-
-Настройте djLint в вашем проекте `pyproject.toml`.
-
-```toml
-[tool.djlint]
-profile="{{ tool }}"
-```
-
-<div class="box notification is-info is-light">
-    <span class="icon is-large"><i class="fas fa-2x fa-circle-arrow-right"></i></span><div class="my-auto ml-3 is-inline-block"><a href="/ru/docs/configuration/">Ознакомьтесь с руководством по настройке, чтобы узнать обо всех возможностях!</a></div>
-</div>

package/docs/src/ru/docs/languages/django.md

@@ -1,31 +0,0 @@
----
-title: Django Template Linter и Formatter
-keywords: django, djlint, django template linter, django template formatter, format django templates
-description: djLint - это линтер шаблонов django и форматер шаблонов django! Используйте преимущества профиля предварительной сборки при линтинге и форматировании ваших шаблонов с помощью djLint.
-tool: django
----
-
-# {{ title }}
-
-{{ description }}
-
-**[Что такое Django?](https://django.readthedocs.io/en/stable/ref/templates/language.html)**
-
-#### Использование командной строки
-
-```bash
-djlint /path/to/templates --profile={{ tool }}
-```
-
-#### Или используйте файл конфигурации
-
-Настройте djLint в вашем проекте `pyproject.toml`.
-
-```toml
-[tool.djlint]
-profile="{{ tool }}"
-```
-
-<div class="box notification is-info is-light">
-    <span class="icon is-large"><i class="fas fa-2x fa-circle-arrow-right"></i></span><div class="my-auto ml-3 is-inline-block"><a href="/ru/docs/configuration/">Ознакомьтесь с руководством по настройке, чтобы узнать обо всех возможностях!</a></div>
-</div>

package/docs/src/ru/docs/languages/golang.md

@@ -1,31 +0,0 @@
----
-title: GoLang Template Linter and Formatter
-keywords: GoLang, djlint, GoLang template linter, GoLang template formatter, format GoLang templates
-description: djLint - это линтер шаблонов GoLang и форматер шаблонов GoLang! Используйте преимущества профиля предварительной сборки при линтинге и форматировании ваших шаблонов с помощью djLint.
-tool: golang
----
-
-# {{ title }}
-
-{{ description }}
-
-**[Что такое GoLang?](https://pkg.go.dev/text/template)**
-
-#### Использование командной строки
-
-```bash
-djlint /path/to/templates --profile={{ tool }}
-```
-
-#### Или используйте файл конфигурации
-
-Настройте djLint в вашем проекте `pyproject.toml`.
-
-```toml
-[tool.djlint]
-profile="{{ tool }}"
-```
-
-<div class="box notification is-info is-light">
-    <span class="icon is-large"><i class="fas fa-2x fa-circle-arrow-right"></i></span><div class="my-auto ml-3 is-inline-block"><a href="/ru/docs/configuration/">Ознакомьтесь с руководством по настройке, чтобы узнать обо всех возможностях!</a></div>
-</div>

package/docs/src/ru/docs/languages/handlebars.md

@@ -1,31 +0,0 @@
----
-title: Handlebars Template Linter and Formatter
-keywords: handlebars, djlint, handlebars template linter, handlebars template formatter, format handlebars templates
-description: djLint - это линтеры и форматоры шаблонов для ручек! Используйте преимущества профиля предварительной сборки при линтинге и форматировании ваших шаблонов с помощью djLint.
-tool: handlebars
----
-
-# {{ title }}
-
-{{ description }}
-
-**[Что такое Handlebars?](https://handlebarsjs.com/)**
-
-#### Использование командной строки
-
-```bash
-djlint /path/to/templates --profile={{ tool }}
-```
-
-#### Или используйте файл конфигурации
-
-Настройте djLint в вашем проекте `pyproject.toml`.
-
-```toml
-[tool.djlint]
-profile="{{ tool }}"
-```
-
-<div class="box notification is-info is-light">
-    <span class="icon is-large"><i class="fas fa-2x fa-circle-arrow-right"></i></span><div class="my-auto ml-3 is-inline-block"><a href="/ru/docs/configuration/">Ознакомьтесь с руководством по настройке, чтобы узнать обо всех возможностях!</a></div>
-</div>

package/docs/src/ru/docs/languages/jinja.md

@@ -1,31 +0,0 @@
----
-title: Jinja Template Linter and Formatter
-keywords: jinja, djlint, jinja template linter, jinja template formatter, format jinja templates
-description: djLint - это линтер шаблонов jinja и форматер шаблонов jinja! Используйте преимущества профиля предварительной сборки при линтинге и форматировании ваших шаблонов с помощью djLint.
-tool: jinja
----
-
-# {{ title }}
-
-{{ description }}
-
-**[Что такое Jinja?](https://jinja2docs.readthedocs.io/en/stable/)**
-
-#### Использование командной строки
-
-```bash
-djlint /path/to/templates --profile={{ tool }}
-```
-
-#### Или используйте файл конфигурации
-
-Настройте djLint в вашем проекте `pyproject.toml`.
-
-```toml
-[tool.djlint]
-profile="{{ tool }}"
-```
-
-<div class="box notification is-info is-light">
-    <span class="icon is-large"><i class="fas fa-2x fa-circle-arrow-right"></i></span><div class="my-auto ml-3 is-inline-block"><a href="/ru/docs/configuration/">Ознакомьтесь с руководством по настройке, чтобы узнать обо всех возможностях!</a></div>
-</div>

package/docs/src/ru/docs/languages/languages.json

@@ -1,3 +0,0 @@
-{
-  "layout": "languages_layout.njk"
-}

package/docs/src/ru/docs/languages/mustache.md

@@ -1,31 +0,0 @@
----
-title: Mustache Template Linter and Formatter
-keywords: mustache, djlint, mustache template linter, mustache template formatter, format mustache templates
-description: djLint - это линтер шаблонов mustache и форматировщик шаблонов mustache! Используйте преимущества профиля предварительной сборки при линтинге и форматировании ваших шаблонов с помощью djLint.
-tool: handlebars
----
-
-# {{ title }}
-
-{{ description }}
-
-**[Что такое Mustache?](http://mustache.github.io/mustache.5.html)**
-
-#### Использование командной строки
-
-```bash
-djlint /path/to/templates --profile={{ tool }}
-```
-
-#### Или используйте файл конфигурации
-
-Настройте djLint в вашем проекте `pyproject.toml`.
-
-```toml
-[tool.djlint]
-profile="{{ tool }}"
-```
-
-<div class="box notification is-info is-light">
-    <span class="icon is-large"><i class="fas fa-2x fa-circle-arrow-right"></i></span><div class="my-auto ml-3 is-inline-block"><a href="/ru/docs/configuration/">Ознакомьтесь с руководством по настройке, чтобы узнать обо всех возможностях!</a></div>
-</div>

package/docs/src/ru/docs/languages/nunjucks.md

@@ -1,31 +0,0 @@
----
-title: Nunjucks Template Linter and Formatter
-keywords: nunjucks, djlint, nunjucks template linter, nunjucks template formatter, format nunjucks templates
-description: djLint - это линтер шаблонов nunjucks и форматер шаблонов nunjucks! Используйте преимущества профиля предварительной сборки при линтинге и форматировании ваших шаблонов с помощью djLint.
-tool: nunjucks
----
-
-# {{ title }}
-
-{{ description }}
-
-**[Что такое Nunjucks?](https://mozilla.github.io/nunjucks/)**
-
-#### Использование командной строки
-
-```bash
-djlint /path/to/templates --profile={{ tool }}
-```
-
-#### Или используйте файл конфигурации
-
-Настройте djLint в вашем проекте `pyproject.toml`.
-
-```toml
-[tool.djlint]
-profile="{{ tool }}"
-```
-
-<div class="box notification is-info is-light">
-    <span class="icon is-large"><i class="fas fa-2x fa-circle-arrow-right"></i></span><div class="my-auto ml-3 is-inline-block"><a href="/ru/docs/configuration/">Ознакомьтесь с руководством по настройке, чтобы узнать обо всех возможностях!</a></div>
-</div>

package/docs/src/ru/docs/languages/twig.md

@@ -1,31 +0,0 @@
----
-title: Twig Template Linter and Formatter
-keywords: twig, djlint, twig template linter, twig template formatter, format twig templates
-description: djLint - это линтер шаблонов twig и форматировщик шаблонов twig! Используйте преимущества профиля предварительной сборки при линтинге и форматировании ваших шаблонов с помощью djLint.
-tool: nunjucks
----
-
-# {{ title }}
-
-{{ description }}
-
-**[Что такое Twig?](https://twig.symfony.com/)**
-
-#### Использование командной строки
-
-```bash
-djlint /path/to/templates --profile={{ tool }}
-```
-
-#### Или используйте файл конфигурации
-
-Настройте djLint в вашем проекте `pyproject.toml`.
-
-```toml
-[tool.djlint]
-profile="{{ tool }}"
-```
-
-<div class="box notification is-info is-light">
-    <span class="icon is-large"><i class="fas fa-2x fa-circle-arrow-right"></i></span><div class="my-auto ml-3 is-inline-block"><a href="/ru/docs/configuration/">Ознакомьтесь с руководством по настройке, чтобы узнать обо всех возможностях!</a></div>
-</div>