48 lines
1.6 KiB
Markdown
48 lines
1.6 KiB
Markdown
# Assets Folder Standard
|
||
|
||
## Поле frontmatter: assets_folder
|
||
|
||
Для статей со скриншотами и другими визуальными материалами добавляем во frontmatter:
|
||
|
||
```yaml
|
||
assets_folder: assets/{slug}/
|
||
```
|
||
|
||
## Структура папки
|
||
|
||
```
|
||
assets/{slug}/
|
||
├── screenshots/ # скриншоты для статьи
|
||
├── diagrams/ # диаграммы
|
||
└── other/ # прочие файлы
|
||
```
|
||
|
||
Подпапки создаются по необходимости. Для простых статей можно класть файлы прямо в корень `assets/{slug}/`.
|
||
|
||
## Использование
|
||
|
||
| Агент | Действие |
|
||
|-------|----------|
|
||
| Human | Добавляет скриншоты перед передачей @writer |
|
||
| @writer | Вставляет ссылки на изображения из этой папки |
|
||
| @image-gen | Генерирует спеки для изображений, которые будут сохранены сюда |
|
||
|
||
## Формат ссылок в статье
|
||
|
||
```markdown
|
||
|
||
```
|
||
|
||
## Когда использовать
|
||
|
||
Папка создаётся только когда статье нужны визуальные материалы:
|
||
- Скриншоты интерфейса
|
||
- Диаграммы и схемы
|
||
- Иллюстрации
|
||
|
||
Для статей без изображений поле `assets_folder` не добавляется.
|
||
|
||
---
|
||
|
||
*Стандарт введён: 2026-01-06*
|