djlint 1.28.0 → 1.30.0

package/docs/src/ru/docs/linter.md

@@ -0,0 +1,126 @@
+---
+description: djLint HTML Template linter включает более 30 правил! Найти определения можно здесь. Легко расширить, включив пользовательские правила!
+title: Правила Линтера
+keywords: облицовка шаблонов, форматер шаблонов, djLint, HTML, шаблоны, форматер, линтер, использование, правила
+---
+
+# Использование вкладышей
+
+djLint включает в себя множество правил для проверки стиля и валидности ваших шаблонов. Используйте все преимущества линтера, настроив его на использование предустановленного профиля для выбранного вами языка шаблонов.
+
+```bash
+djlint /path/to/templates --lint
+
+# with custom extensions
+djlint /path/to/templates -e html.dj --profile=django
+
+# or to file
+djlint /path/to/this.html.j2  --profile=jinja
+```
+
+<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>
+
+## Включение или отключение правил
+
+Большинство правил включены по умолчанию. Правила могут быть отключены в командной строке с помощью флага `--ignore`. Правила могут быть включены с помощью флага `--include`.
+
+Например:
+
+```bash
+djlint . --lint --include=H017,H035 --ignore=H013,H015
+```
+
+Это также можно сделать через [{{ "configuration" | i18n }}]({{ "lang_code_url" | i18n }}/docs/configuration) файл.
+
+## Правила
+
+| Код  | Значение                                                                                                                  | По умолчанию |
+| ---- | ------------------------------------------------------------------------------------------------------------------------- | ------------ |
+| D004 | (Django) Статические урлы должны следовать шаблону {% raw %}`{% static path/to/file %}`{% endraw %}.                      | ✔️           |
+| D018 | (Django) Внутренние ссылки должны использовать шаблон {% raw %}`{% url ... %}`{% endraw %}.                               | ✔️           |
+| H005 | Html-тег должен иметь атрибут `lang`.                                                                                     | ✔️           |
+| H006 | Тег `img` должен иметь атрибуты `height` и `width`.                                                                       | ✔️           |
+| H007 | `<!DOCTYPE ... >` должен присутствовать перед тегом html.                                                                 | ✔️           |
+| H008 | Атрибуты должны быть заключены в двойные кавычки.                                                                         | ✔️           |
+| H009 | Имена тегов должны быть в нижнем регистре.                                                                                | ✔️           |
+| H010 | Имена атрибутов должны быть в нижнем регистре.                                                                            | ✔️           |
+| H011 | Значения атрибутов должны быть заключены в кавычки.                                                                       | ✔️           |
+| H012 | Вокруг атрибута `=` не должно быть пробелов.                                                                              | ✔️           |
+| H013 | Тег `img` должен иметь атрибуты alt.                                                                                      | ✔️           |
+| H014 | Более 2 пустых строк.                                                                                                     | ✔️           |
+| H015 | После тегов `h` следует перевод строки.                                                                                   | ✔️           |
+| H016 | Отсутствие тега `title` в html.                                                                                           | ✔️           |
+| H017 | Метки пустоты должны быть самозакрывающимися.                                                                             | -            |
+| H019 | Замените `javascript:abc()` на событие `on_` и реальный url.                                                              | ✔️           |
+| H020 | Найдена пустая пара тегов. Рассмотрите возможность удаления.                                                              | ✔️           |
+| H021 | Следует избегать инлайн-стилей.                                                                                           | ✔️           |
+| H022 | Используйте HTTPS для внешних ссылок.                                                                                     | ✔️           |
+| H023 | Не используйте ссылки на сущности.                                                                                        | ✔️           |
+| H024 | Опускайте тип в скриптах и стилях.                                                                                        | ✔️           |
+| H025 | Тег кажется бесхозным.                                                                                                    | ✔️           |
+| H026 | Пустые теги id и class могут быть удалены.                                                                                | ✔️           |
+| H029 | Рассмотрите возможность использования строчных значений метода формы.                                                     | ✔️           |
+| H030 | Рассмотрите возможность добавления мета-описания.                                                                         | ✔️           |
+| H031 | Рассмотрите возможность добавления мета-ключевых слов.                                                                    | ✔️           |
+| H033 | В действии формы обнаружен лишний пробел.                                                                                 | ✔️           |
+| J004 | (Jinja) Статические урлы должны следовать шаблону {% raw %}`{{ url_for('static'...)}}`{% endraw %}.                       | ✔️           |
+| J018 | (Jinja) Внутренние ссылки должны использовать шаблон {% raw %}`{% url ... %}`{% endraw %}.                                | ✔️           |
+| T001 | Переменные должны быть заключены в один пробел. Например: {% raw %}`{{ this }}`{% endraw %}                               | ✔️           |
+| T002 | В тегах следует использовать двойные кавычки. Ex {% raw %}`{% extends "this.html" %}`{% endraw %}                         | ✔️           |
+| T003 | Конечный блок должен иметь имя. Например: {% raw %}`{% endblock body %}`{% endraw %}.                                     | ✔️           |
+| T027 | В синтаксисе шаблона найдена незакрытая строка.                                                                           | ✔️           |
+| T028 | Рассмотрите возможность использования тегов без пробелов внутри значений атрибутов. {% raw %}`{%- if/for -%}`{% endraw %} | ✔️           |
+| T032 | В тегах шаблона обнаружены лишние пробелы.                                                                                | ✔️           |
+| T034 | Вы намеревались использовать {% raw %}{% ... %} вместо {% ... }%?  {% endraw %}                                           | ✔️           |
+| H035 | Meta должны быть самозакрывающимися.                                                                                      | -            |
+| H036 | Избегайте использования тегов <br>.                                                                                       | -            |
+| H037 | Найдено дублирование атрибута.                                                                                            | ✔️           |
+
+### Кодовые шаблоны
+
+Первая буква кода соответствует схеме:
+
+::: content
+
+- D: применяется специально для Django
+- H: применяется к html
+- J: применяется специально для Jinja
+- M: применяется специально для Handlebars
+- N: применяется специально для Nunjucks
+- T: применяется в целом к шаблонам
+  :::
+
+### Добавление правил
+
+Мы приветствуем запросы с новыми правилами!
+
+Хорошее правило состоит из
+
+::: content
+
+- Name
+- Code
+- Message - Сообщение для отображения при обнаружении ошибки.
+- Flags - Флаги регекса. По умолчанию используется re.DOTALL. например: re.I|re.M
+- Patterns - regex-выражения, которые найдут ошибку.
+- Exclude - Необязательный список профилей, из которых нужно исключить правило.
+  :::
+
+Пожалуйста, включите тест для проверки правила.
+
+## Пользовательские правила
+
+Создайте файл `.djlint_rules.yaml` рядом с вашим `pyproject.toml`. Правила могут быть добавлены в этот файл, и djLint подхватит их.
+
+Хорошее правило выглядит следующим образом:
+
+```yaml
+- rule:
+    name: T001
+    message: Найти трихотилломанию
+    flags: re.DOTALL|re.I
+    patterns:
+      - трихотилломанию
+```

package/docs/src/ru/index.njk

@@ -0,0 +1,4 @@
+---
+layout: index.njk
+date: Last Modified
+---

package/docs/src/ru/ru.json

@@ -0,0 +1,4 @@
+{
+  "dir": "ltr",
+  "locale": "ru"
+}

package/docs/src/sitemap.njk

@@ -0,0 +1,16 @@
+---
+permalink: /sitemap.xml
+eleventyExcludeFromCollections: true
+---
+<?xml version="1.0" encoding="utf-8"?>
+<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
+{%- for page in collections.all -%}
+    {%- if not page.data.draft %}
+        <url>
+        <loc>{{ site.url }}{{ page.url | url }}</loc>
+        <lastmod>{{ page.date.toISOString() }}</lastmod>
+        <changefreq>{{ page.data.changeFreq if page.data.changeFreq else "weekly" }}</changefreq>
+        </url>
+    {%- endif -%}
+{%- endfor -%}
+</urlset>

package/docs/src/static/css/site.scss

@@ -0,0 +1,467 @@
+@use '../../../node_modules/@fontsource/inter/scss/mixins' as Inter;
+@use '../../../node_modules/@fontsource/rasa/scss/mixins' as Rasa;
+@use '../../../node_modules/@fontsource/crimson-pro/scss/mixins' as Crimson;
+$link-hover: hsl(207, 61%, 44%);
+$link: hsl(207, 61%, 44%);
+
+@import '../../../node_modules/bulma/bulma';
+@import '../../../node_modules/bulma-pricingtable/src/sass/index';
+@import '../../../node_modules/@creativebulma/bulma-divider/src/sass/index';
+
+$use-all: true;
+$use-slideInDown: true;
+@import '../../../node_modules/animate-sass/animate';
+
+@import '../font/fontawesome/stylesheet';
+
+/* purgecss start ignore */
+
+pre .tag {
+  align-items: unset;
+  background-color: unset;
+  border-radius: unset;
+  color: unset;
+  display: unset;
+  font-size: unset;
+  height: unset;
+  justify-content: unset;
+  line-height: unset;
+  padding-left: unset;
+  padding-right: unset;
+  white-space: unset;
+}
+pre .section {
+  padding: unset;
+}
+
+@import '../../../node_modules/prismjs/themes/prism-tomorrow';
+
+@include Inter.faces(
+  $family: Inter,
+  $weights: (
+    400,
+    600,
+    700,
+  ),
+  $display: swap,
+  $subsets: latin,
+  $directory: '/static/font/inter/files/'
+);
+
+@include Rasa.faces(
+  $family: Rasa,
+  $weights: (
+    300,
+    500,
+    600,
+    700,
+  ),
+  $display: swap,
+  $subsets: latin,
+  $directory: '/static/font/rasa/files/'
+);
+
+@include Crimson.faces(
+  $family: 'Crimson Pro',
+  $weights: 400,
+  $display: swap,
+  $subsets: latin,
+  $directory: '/static/font/crimson-pro/files/'
+);
+
+html {
+  height: 100%;
+}
+
+body {
+  font-family: 'Inter', Arial, Verdana, Tahoma, sans-serif;
+  display: flex;
+  flex-direction: column;
+  min-height: 100%;
+}
+
+.title {
+  font-family: 'Rasa', Georgia, 'Times New Roman', Times, serif;
+}
+.huge {
+  font-size: 100px;
+}
+
+.djlint-nav {
+  padding-left: 15px;
+}
+.djlint-nav .navbar-brand a {
+  margin-top: auto;
+  margin-bottom: auto;
+}
+
+body.has-navbar-fixed-top,
+html.has-navbar-fixed-top {
+  padding-top: 118px;
+}
+.djlint-nav .navbar-brand img {
+  width: auto;
+  height: 40px !important;
+  margin-top: 6px;
+  margin-bottom: -2px;
+}
+
+.is-flex-widescreen {
+  display: none !important;
+}
+@media screen and (min-width: $widescreen) {
+  .djlint-nav {
+    padding: 15px 0;
+  }
+
+  .djlint-nav .navbar-brand img {
+    height: 56px !important;
+  }
+
+  .is-flex-widescreen {
+    display: flex !important;
+  }
+}
+
+.image.brand {
+  height: 200px;
+  display: flex;
+  justify-content: center;
+  align-items: center;
+}
+.image.brand img {
+  max-width: 200px;
+  max-height: 200px;
+}
+
+a.navbar-item:hover,
+a.navbar-link:hover,
+.navbar-item.has-dropdown:hover .navbar-link {
+  background: transparent;
+}
+
+.hero-body {
+  background-color: rgba(167, 200, 204, 0.7);
+}
+
+.hero-two {
+  background-color: rgba(0, 68, 106, 0.08);
+}
+
+h1 {
+  font-size: 50px;
+}
+
+h2 {
+  font-size: 25px;
+}
+
+.is-nav-icon .fa-2x {
+  font-size: 1.6em;
+}
+
+/* fix for prism in bulma */
+pre .number {
+  background-color: inherit;
+  font: inherit;
+  padding: 0;
+  margin: 0;
+  height: inherit;
+  min-width: inherit;
+  text-align: inherit;
+  vertical-align: inherit;
+}
+
+.navbar-item.button {
+  margin: 13px;
+  margin-top: auto;
+  margin-bottom: auto;
+}
+
+.mail-icon > img {
+  margin-top: 3px;
+}
+/* comparison */
+.plan-item .icon {
+  height: auto;
+}
+.plan-item .icon svg {
+  height: 15px;
+  width: 15px;
+}
+
+.pricing-table .pricing-plan .plan-group {
+  align-content: center;
+  background-color: #fff;
+  color: #4a4a4a;
+  font-size: $size-6;
+  font-weight: 600;
+  padding: 0.75em;
+  text-align: center;
+}
+
+.pricing-table .pricing-plan .plan-header {
+  font-size: $size-6;
+}
+
+.icon.is-huge {
+  height: 2.5em;
+  width: 2.5em;
+}
+
+.story {
+  font-family: Crimson Pro, Georgia, serif;
+  font-size: 24px;
+  font-weight: 400;
+  line-height: 1.6666666667;
+  max-width: 800px;
+  margin-left: auto;
+  margin-right: auto;
+}
+
+// tabs
+
+.tab-container {
+  @extend %block;
+}
+.tab-container .tab {
+  display: none;
+}
+
+.tab-container .tab.is-active {
+  display: initial;
+}
+
+// admonitions
+.message-header .icon svg {
+  height: $size-6;
+  padding-right: 10px;
+}
+
+.message.note {
+  border-width: $message-body-border-width;
+  border-style: solid;
+  border-color: $info;
+  background-color: $white;
+  padding: 0;
+}
+.message.hint {
+  border-width: $message-body-border-width;
+  border-style: solid;
+  border-color: $success;
+  background-color: $white;
+  padding: 0;
+}
+.message.alert {
+  border-width: $message-body-border-width;
+  border-style: solid;
+  border-color: $danger;
+  background-color: $white;
+  padding: 0;
+}
+.message.note .message-header {
+  color: $text;
+  background-color: $info-light;
+}
+
+.message.hint .message-header {
+  color: $text;
+  background-color: $success-light;
+}
+
+.message.alert .message-header {
+  color: $text;
+  background-color: $danger-light;
+}
+
+.message.note .message-body,
+.message.hint .message-body,
+.message.alert .message-body {
+  color: $text;
+}
+
+.image.is-35x35 {
+  height: 35px;
+  width: 35px;
+}
+/* menu collapse */
+
+.is-collapsible,
+.is-collapsible.is-active {
+  transition: max-height 0.2s ease-out;
+}
+
+.is-collapsible {
+  max-height: 0;
+  overflow: hidden;
+  margin-top: 0;
+  margin-bottom: 0;
+}
+
+.is-collapsible-menu {
+  height: 0;
+  overflow: hidden;
+  margin-top: 0;
+  margin-bottom: 0;
+}
+.is-collapsible-menu.is-active {
+  height: auto;
+}
+
+.is-collapsible-menu:not(.is-active) {
+  margin-top: 0 !important;
+  margin-bottom: 0 !important;
+}
+
+.is-collapsible-menu .is-collapsible-menu {
+  margin-bottom: 0 !important;
+}
+
+.menu .menu-label {
+  font-weight: 600;
+  font-size: unset;
+  color: $grey-dark;
+}
+
+.menu li a.is-active {
+  background: unset;
+  color: unset;
+  font-weight: 700;
+}
+
+.menu li.head > a {
+  font-weight: 600;
+}
+
+.menu-list li.head ul {
+  margin-left: 3px;
+  padding-left: 20px;
+}
+
+.menu-list a:hover,
+.menu li a:hover {
+  background-color: unset;
+}
+
+pre:not(.CodeMirror-line) {
+  margin-bottom: 1.5rem !important;
+}
+
+.column:not(.is-narrow) {
+  min-width: 0px;
+}
+
+.is-inlineblock {
+  display: inline-block !important;
+}
+
+.is-radius > img {
+  border-radius: $radius;
+}
+
+.is-framed {
+  max-width: 800px;
+  border: 8px solid $grey-lightest;
+  border-radius: 4px;
+  border-top: 24px solid $grey-lightest;
+  box-shadow: 0 0.5em 1em -0.125em #0a0a0a1a, 0 0 0 1px #0a0a0a05;
+  position: relative;
+}
+
+.is-framed::before {
+  border-radius: 10px;
+  content: '';
+  height: 15px;
+  left: 0px;
+  position: absolute;
+  top: -19px;
+  width: 15px;
+  background: $grey-light;
+}
+
+.is-framed::after {
+  border-radius: 10px;
+  content: '';
+  height: 15px;
+  left: 20px;
+  position: absolute;
+  top: -19px;
+  width: 15px;
+  background: $grey-light;
+}
+
+.hero.is-white .hero-body {
+  background-color: $white;
+}
+
+.hero {
+  position: relative;
+}
+
+a.card:hover {
+  box-shadow: 0 0.5em 2em -0.125em #0a0a0a1a, 0 0 0 1px #0a0a0a05;
+}
+
+.title {
+  color: $grey-darker;
+}
+@media screen and (min-width: $tablet) {
+  .is-sticky {
+    position: sticky;
+    top: 118px;
+    bottom: 0;
+    max-height: calc(100vh - 118px);
+    overflow-y: scroll;
+  }
+}
+@media screen and (min-width: $desktop) {
+  .navbar.is-transparent a.is-info.navbar-item:hover {
+    background-color: $info-dark !important;
+  }
+}
+.navbar-item.button.is-white:hover {
+  background: transparent !important;
+}
+.is-256x256 {
+  max-height: 256px;
+  max-width: 256px;
+}
+@media screen and (max-width: $tablet) {
+  .main {
+    padding: 0 15px;
+  }
+}
+.animated[data-animate] {
+  visibility: hidden;
+}
+
+.navbar-item .media img {
+  max-height: unset !important;
+}
+
+.icon.is-5x {
+  height: 6rem;
+  width: 6rem;
+}
+
+.is-transparent,
+.is-transparent:hover {
+  background-color: transparent !important;
+}
+.is-rounded {
+  border-radius: $radius;
+}
+
+pre[class*='language'] {
+  border-radius: $radius;
+}
+/* purgecss end ignore */
+
+.navbar-item.is-mega {
+  position: static;
+
+  .is-mega-menu-title {
+    margin-bottom: 0;
+    padding: 0.375rem 1rem;
+  }
+}

package/docs/src/static/font/fontawesome/stylesheet.scss

@@ -0,0 +1,78 @@
+@use 'sass:math';
+
+@import '../../../../node_modules/@fortawesome/fontawesome-free/scss/_functions';
+@import '../../../../node_modules/@fortawesome/fontawesome-free/scss/_variables';
+@import '../../../../node_modules/@fortawesome/fontawesome-free/scss/_mixins';
+@import '../../../../node_modules/@fortawesome/fontawesome-free/scss/_core';
+@import '../../../../node_modules/@fortawesome/fontawesome-free/scss/_sizing';
+@import '../../../../node_modules/@fortawesome/fontawesome-free/scss/_animated';
+
+$fa-font-path: '/static/font/fontawesome/webfonts';
+@font-face {
+  font-family: 'Font Awesome 6 Brands';
+  font-style: normal;
+  font-weight: 400;
+  font-display: $fa-font-display;
+  src: url('#{$fa-font-path}/fa-brands-400.woff2') format('woff2'),
+    url('#{$fa-font-path}/fa-brands-400.ttf') format('truetype');
+}
+
+@font-face {
+  font-family: 'Font Awesome 6 Free';
+  font-style: normal;
+  font-weight: 900;
+  font-display: $fa-font-display;
+  src: url('#{$fa-font-path}/fa-solid-900.woff2') format('woff2'),
+    url('#{$fa-font-path}/fa-solid-900.ttf') format('truetype');
+}
+
+@font-face {
+  font-family: 'Font Awesome 6 Free';
+  font-style: normal;
+  font-weight: 400;
+  font-display: $fa-font-display;
+  src: url('#{$fa-font-path}/fa-regular-400.woff2') format('woff2'),
+    url('#{$fa-font-path}/fa-regular-400.ttf') format('truetype');
+}
+
+.far,
+.#{$fa-css-prefix}-regular {
+  font-family: 'Font Awesome 6 Free';
+  font-weight: 400;
+}
+
+.fas,
+.#{$fa-css-prefix}-solid {
+  font-family: 'Font Awesome 6 Free';
+  font-weight: 900;
+}
+
+.fab,
+.#{$fa-css-prefix}-brands {
+  font-family: 'Font Awesome 6 Brands';
+  font-weight: 400;
+}
+
+.#{$fa-css-prefix}-2_3x {
+  font-size: 2.3em;
+}
+
+/* build icon list */
+$icons: (
+  infinity: $fa-var-infinity,
+  discord: $fa-var-discord,
+  github: $fa-var-github,
+  download: $fa-var-download,
+  pencil: $fa-var-pencil,
+  circle-arrow-right: $fa-var-circle-arrow-right,
+  globe: $fa-var-globe,
+  code-commit: $fa-var-code-commit,
+  spinner: $fa-var-spinner,
+  circle-question: $fa-var-circle-question,
+);
+
+@each $key, $value in $icons {
+  .#{$fa-css-prefix}-#{$key}:before {
+    content: fa-content($value);
+  }
+}