aside

Instruction file imported from xsltdev/hcdev.ru (.cursor/rules/aside.mdc). Copyright stays with the author.

Aside Tags Transformation

При переводе документации на русский язык контент между тегами {% Aside %} и {% endAside %} нужно оформить следующим образом:

Исходный формат

{% Aside %}
Содержимое блока
{% endAside %}

{% Aside 'important' %}
Важная информация
{% endAside %}

Целевой формат

!!!note ""

	Содержимое блока

!!!important "Важно"

	Важная информация

Правила преобразования

1. Основная структура: Заменить {% Aside %} на !!!note ""
2. Пустая строка: После !!!note "" обязательно добавить пустую строку
3. Отступы: Весь контент внутри блока должен иметь отступ в одну табуляцию
4. Завершение: После контента добавить пустую строку
5. Типы блоков: Переводить типы Aside блоков согласно таблице соответствий

Типы Aside блоков и их переводы

Примеры применения

Простой Aside блок

<!-- ДО -->
{% Aside %}
Это важная информация для разработчиков.
{% endAside %}

<!-- ПОСЛЕ -->
!!!note ""

	Это важная информация для разработчиков.

Aside блок с типом

<!-- ДО -->
{% Aside 'warning' %}
Будьте осторожны при использовании этого метода.
{% endAside %}

<!-- ПОСЛЕ -->
!!!warning "Предупреждение"

	Будьте осторожны при использовании этого метода.

Aside блок с множественным контентом

<!-- ДО -->
{% Aside 'tip' %}
Полезный совет:

- Используйте семантические теги
- Добавляйте alt-атрибуты к изображениям
- Проверяйте контрастность цветов
{% endAside %}

<!-- ПОСЛЕ -->
!!!tip "Совет"

	Полезный совет:

	- Используйте семантические теги
	- Добавляйте alt-атрибуты к изображениям
	- Проверяйте контрастность цветов

Aside блок с кодом

<!-- ДО -->
{% Aside 'important' %}
Всегда используйте следующий синтаксис:

```html
<button aria-label="Закрыть диалог">×</button>

{% endAside %}

!!!important "Важно"

Всегда используйте следующий синтаксис:

```html
<button aria-label="Закрыть диалог">×</button>
```

## Важные примечания

- **Отступ**: Используется ровно одна табуляция для всего контента внутри блока
- **Перевод типов**: Первая буква переведенного типа всегда заглавная
- **Сохранение форматирования**: Весь внутренний контент (списки, код, абзацы) сохраняет свою структуру с добавлением табуляции
- **Пустые строки**: Обязательны после открывающего `!!!note` и в конце блока
- **Вложенный контент**: Блоки кода, списки и другая разметка внутри Aside сохраняются с соответствующими отступами