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 "Важно"
Важная информация
Правила преобразования
- Основная структура: Заменить
{% Aside %}на!!!note "" - Пустая строка: После
!!!note ""обязательно добавить пустую строку - Отступы: Весь контент внутри блока должен иметь отступ в одну табуляцию
- Завершение: После контента добавить пустую строку
- Типы блоков: Переводить типы Aside блоков согласно таблице соответствий
Типы Aside блоков и их переводы
| Исходный тип | Перевод на русский |
|---|---|
'important' |
"Важно" |
'warning' |
"Предупреждение" |
'caution' |
"Осторожно" |
'note' |
"Примечание" |
'tip' |
"Совет" |
'info' |
"Информация" |
'success' |
"Успех" |
'error' |
"Ошибка" |
Примеры применения
Простой 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 сохраняются с соответствующими отступами
