Як вести цю вікі
Мова: English · Українська
Одне місце на факт
Англійські файли в docs/wiki/ — джерело правди. Українські в docs/wiki/uk/ — переклад тих самих сторінок, не друга правда.
| Факт | Англійська сторінка | Український близнюк |
|---|---|---|
| Головне вікно, меню, тулбар, фільтри, Settings, F1 | 1_User_Guide_and_Workflow_Pipeline.md |
uk/1_… |
| Який Python-файл реалізує контроль | 2_API_Reference.md |
uk/2_… |
| Написання плагіна | 3_Plugin_Developer_Guide.md |
uk/3_… |
settings.json, .env, сесія |
4_Configuration_Guide.md |
uk/4_… |
| Gemini Web2API / WebTOP | 5_Gemini_Web2API.md |
uk/5_… |
| Віртуальні теки, прев’ю TP, Show Unsaved Only | 6_Virtual_Navigation_and_Preview.md |
uk/6_… |
| Ця таблиця | цей файл | uk/7_… |
| Майстер пайплайну і автоглосарій | 8_Localization_Pipeline.md |
uk/8_… |
| Script Markup Studio | 9_Script_Markup.md |
uk/9_… |
| AI Translate / Variation / Chat | 11_AI_Translation.md |
uk/11_… |
| Picoripi Companion (мобільний PWA та сервер синхронізації) | 12_Picoripi_Companion.md |
uk/12_… |
Вікі як вебсайт (GitHub Pages, збирає scripts/build_wiki_site.py з docs/wiki; .github/workflows/wiki-site.yml) |
власного тексту немає: редагуйте сторінки | |
| Кімнати (спільна робота), сторінка прогресу, таблиця команди | 13_Working_Together.md |
|
Перший запуск: встановлення, тека даних, майстер нового проєкту, зі скріншотами (img/getting_started/) |
0_Getting_Started.md |
|
| Короткий пітч + карта | кореневий README.md |
посилання на docs/wiki/uk/README.md |
| Усі можливості одним переліком | docs/FEATURES.md |
лише англійською |
| Правила для агентів | AGENTS.md (обґрунтування: docs/ENGINEERING.md; карта коду: docs/ARCHITECTURE.md) |
лише англійською |
| Усі документи з розміром і статусом | docs/INDEX.md (генерується: python tasks.py docs-index) |
лише англійською |
Авторитет: поточний Python/UI. Якщо старі docs/*.md розходяться з кодом — правити англійську вікі з коду, потім українську копію.
Коли змінюється код
Після зміни, видимої користувачеві, або зміни налаштувань:
- Знайдіть рядок у таблиці вище.
- Виправте англійську сторінку (і карту в README, якщо перемістилася точка входу).
- Виправте
docs/wiki/uk/— файл із тією самою назвою, той самий абзац. Назви контролів у обох мовах — як у UI (англійською). - У CHANGELOG — рядок лише про зміну поведінки; у вікі — тривале «як користуватися».
- Якщо контрол перейменовано, пошукайте в
docs/wikiстару англійську назву.
Агенти: після такої роботи або на прохання оновити документацію викликайте навичку update-wiki (/update-wiki). Перед правкою сторінки перечитайте файл коду, який вона описує.