# Как добавить новый релиз раскладки на сайт

На странице сайта **`raskladki/`** есть таблица «Релизы и загрузки» (Устройство · ОС · Версия ·
Дата релиза · Загрузка). Она **рисуется автоматически** из файла [`releases.json`](releases.json) —
в вёрстку лезть не нужно.

## Шаги (2 действия)

1. **Добавь строку** в [`releases.json`](releases.json) (это просто список `[ {...}, {...} ]`).
2. **Пересобери сайт:**
   ```
   python scripts/valks_build.py
   ```
   Таблица обновится во всех трёх языковых версиях (ru/de/en) сама.

> Перед заливкой на хостинг ещё пересобери архив деплоя `valks_site_deploy.zip` из папки `site/`.

## Поля одной строки релиза

| Поле | Значения | Что это |
|---|---|---|
| `device` | `desktop` или `mobile` | «Компьютер» или «Телефон / планшет» (подпись переведётся сама) |
| `os` | любой текст | напр. `"Android"`, `"Windows"`, `"macOS"` |
| `comp` | `layout` · `macro` · `autoreplace` · `app` | что это: раскладка / макрос / автозамена / клавиатура-приложение |
| `version` | текст | напр. `"1.0"` (у `planned` можно не указывать) |
| `date` | `ГГГГ-ММ-ДД` | дата релиза (у `planned` можно не указывать) |
| `status` | `released` или `planned` | `planned` рисуется приглушённой строкой «планируется / в разработке» |
| ссылка (одно из) | `file` · `zipfile` · `anchor` | куда ведёт «Загрузка» — см. ниже |

**Ссылка на загрузку** — добавь ОДНО из полей:
- `"file": "windows/erzya-new.klc"` — файл внутри бандла `site/files/keyboard/…` (путь от папки `keyboard/`);
- `"zipfile": "erzya-keyboard.zip"` — общий архив в `site/files/`;
- `"anchor": "#rask-mob"` — якорь на раздел этой же страницы (для «как включить»);
- ничего из этого → в ячейке будет «—».

Файлы для скачивания берутся из папки `keyboard/` (она целиком копируется в `site/files/keyboard/`
при сборке, плюс собирается общий `erzya-keyboard.zip`). То есть положил новый файл в `keyboard/…` и
сослался на него полем `file` — он автоматически попадёт на сайт.

## Пример: выпустили Android-приложение v1.0

Было (в разработке):
```json
{"device":"mobile","os":"Android","comp":"app","status":"planned"}
```
Стало (релиз; ссылка на Google Play через `anchor` на раздел или внешний URL в будущем):
```json
{"device":"mobile","os":"Android","comp":"app","version":"1.0","date":"2026-09-01","status":"released","anchor":"#rask-mob"}
```

## Где что лежит (для правок текста, а не таблицы)
- Список релизов: `keyboard/releases.json` (этот механизм).
- Перевод заголовков/ярлыков таблицы: словарь `REL_T` в `scripts/valks_build.py`.
- Рендер таблицы: функция `releases_table(loc)` там же.
- Тексты самой страницы (установка по платформам): словарь `RASK` в `scripts/valks_build.py`.
