Skip to content

Исправлена сломанная YFM-разметка на девяти страницах - #1154

Open
bontail wants to merge 1 commit into
yandex-cloud:masterfrom
bontail:docs-broken-yfm-tags
Open

Исправлена сломанная YFM-разметка на девяти страницах#1154
bontail wants to merge 1 commit into
yandex-cloud:masterfrom
bontail:docs-broken-yfm-tags

Conversation

@bontail

@bontail bontail commented Jul 29, 2026

Copy link
Copy Markdown
Contributor

I hereby agree to the terms of the CLA available at: https://yandex.ru/legal/cla/?lang=ru

Идентификатор платежного аккаунта: dn2ujjv4advyulwqk7mp

Description of changes:

На девяти страницах разметка врезок, вкладок и раскрывающихся блоков не срабатывает и выводится в текст как есть. Где-то внутри тега лишний пробел, { % note alert %} и { % endcut %}, где-то закрывающий тег остался без открывающего, где-то пропущено открытие блока вкладок. Проверил по собранному бандлу md-docs, эти строки действительно доходят до читателя.

Теги врезок, вкладок и раскрывающихся блоков не сбалансированы: часть
написана с ошибкой в синтаксисе, часть осталась без пары. В таком виде
разметка не срабатывает и попадает на страницу текстом. Проверил по
собранному бандлу md-docs: строки { % note alert %} и { % endcut %}
действительно доходят до читателя как есть.

Лишний пробел внутри тега, из-за которого он не распознается:

* ru/_tutorials/applied/wordpress-mysql-console.md, { % note alert %};
* ru/_tutorials/dataplatform/spark/airflow-and-spark.md, три раза
  { % endcut %}. Из-за них три блока cut оставались незакрытыми.

Пропущено открытие блока вкладок:

* ru/_includes/terraform/authentication-sa.md. Вкладки Bash и
  PowerShell есть, закрытие есть, а строки {% list tabs %} нет,
  поэтому вкладки выводятся простым списком, а {% endlist %} виден в
  тексте. Добавил открытие с группой programming_language, как в
  соседнем include export-env-vars.md.

Закрывающий тег без парного открывающего, остался от прошлых правок:

* ru/_includes/kms/terraform-encryption.md, лишний {% endnote %};
* ru/_tutorials/dataplatform/valkey-data-migration.md, лишний
  {% endcut %};
* ru/_tutorials/dataplatform/sqoop/sqoop-mpg.md и sqoop-mmy.md,
  лишний {% endlist %}: разделы там давно оформлены заголовками, а не
  вкладками;
* ru/_tutorials/security/wlif-managed-k8s-integration.md, два
  {% endlist %} подряд;
* ru/_tutorials/dataplatform/spark/datasphere-and-spark.md, лишний
  {% endlist %} в самом конце файла.

Как искал. Для каждой страницы раскрыл include и посчитал теги
стеком. До правок несбалансированными оказались 29 страниц, все они
сводились к девяти исходным файлам. После правок несбалансированных
страниц не осталось, искажений вида { % в ru/ тоже нет.
@yfm-team

Copy link
Copy Markdown

Все готово!
Commit: b23adf1
Проверьте результат: RU.
Check the result: EN.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants