Віртуальна навігація і прев’ю
Мова: English · Українська
Ліве дерево Blocks змішує фізичні файли з похідними виглядами. Збирається в ui/updaters/block_list_updater.py. Фізичні рядки — джерело правди для save/load. Віртуальні теки лише групують наявні рядки.
Фізичне дерево
- Вкладені теки. Стиснуті шляхи архівів виглядають як
bmgres4.arc / zel_00.bmg. - Рисочки попереджень (кольоровий gutter) і лічильники
(N)на файлах і стиснутих рядках. Дані рисочки лежать на айтемі (UserRole+20), щоб підписи не подвоювались якName (1) (1). - Незбережене
*на файлах і батьках. - Зелена заливка прогресу: частка перекладу. Порожні / пробільні / лише-теги оригінали не рахуються.
- Show Unsaved Only над деревом ховає файли без незбережених правок. Лише сесія: перезапуск завжди знімає галочку (
AppDataStore.from_snapshotвимикає обидва unsaved-фільтри).
Розгортання чи згортання фізичної теки лише зберігає стан відкрито/закрито. Воно не перебудовує все дерево і не перезаповнює кожен блок.
Клік по фізичному файлу (UserRole >= 0) завжди вантажить рядки цього файлу, навіть якщо батько виглядає як агрегат.
Похідні корені
Стабільні імена на UserRole+4:
| Корінь | Значення |
|---|---|
| Story | Акти / розділи / сцени з MemePalace + комбо Chapter |
| Speakers | Рядки за розв’язаним спікером, плюс None для непризначених непорожніх рядків |
| Items | Item-get / каталожний текст, прив’язаний до довідкових предметів |
| Windows | Групи за типом ігрового вікна повідомлення |
| Notated | Рядки з явною нотаткою перекладача (UserRole == -5) |
Порожній BMG-паддинг лишається у фізичному файлі. Віртуальні корені пропускають порожні рядки (_is_blank_row). Тип, у якому були б лише порожні, не з’являється.
Клік по віртуальному листу вантажить лише його відображені пари (block, string).
⟳ Rebuild virtual folders на тулбарі дерева перебудовує Speakers / Chapters / Items з поточних сюжетних даних. Файли перекладу не чіпає.
Перетягування рядків на віртуальний лист призначає цю грань (спікер, розділ, …). Корінь Chapters і теки Act не мають правого кліку.
Теки плагіна
Плагін може додати теки під фізичним блоком (get_virtual_folders). Вони стоять під блоком, а їхній елемент має UserRole == -2 і позначку aggregate, тож клік заповнює список рядків рядками теки, як у похідних коренів. Мануали 3DS використовують їх: під кожним мануалом Small text і Large text (одна підтека на сторінку), Sections (на сторінку: її малі та великі рядки) і Contents (заголовки розділів). Рядок стоїть у двох місцях. Назва сторінки — поточний переклад її запису індексу, або оригінал, коли переклад порожній, або «Сторінка N». Назви оновлюються, коли дерево перебудовується (після збереження або зміни проєкту), а не при кожному натисканні клавіші. Вибрана тека лишається вибраною після перебудови. Теки плагіна не перетягуються, а скидання на теку нічого не робить: тека, перетягнута на мовця, призначила б його всьому мануалу.
Список Strings проти редактора
- Клік по рядку в Strings in block прив’язує Original + Editable.
- Hide empty strings згортає підряд порожні в плейсхолдер (цей фільтр відновлюється з сесії).
- Show Unsaved Only на списку рядків не відновлюється.
- Show Warnings Only + Warnings: X / Y використовує id проблем, увімкнені в Detection плагіна.
Візуальне прев’ю
View → Preview (Ctrl+Shift+P), також дія Preview на тулбарі. Під Editable: BfnPreviewWidget + BfnPreviewWindowBar.
Коли плагін оголошує message_window_preview (Twilight Princess BMG), прев’ю може малювати хром talk / item-get / sign з локального дампу гри. Репозиторій не постачає ассети Nintendo. Сторінка n/N і original/translation (T/O) на тій панелі.
Картки імені боса відповідають zelda_boss_name.blo (sfont00 600×77, ruby 34px, по центру). {scale:…} у рядку все одно застосовується.
Global → Enable Live Preview вимикає живий симулятор, щоб зменшити лаги.
Масштабування та макет прев’ю: спочатку вікно повідомлення вписується у доступну область. За видимого фонового зображення фон, рамка й текст використовують спільне перетворення ігрових координат; Ctrl+Wheel масштабує їх разом, а Скинути масштаб (100%) повертає зум до 100%, зберігаючи зсув. Зсув фону діє лише тоді, коли його видно. Виправити масштаб шрифту відновлює вибраний розмір тексту після повторного відкриття й пропорційно змінює його при зміні розміру панелі. На компактній панелі кнопки сайдбара зменшуються, а тултіпи попереджень показують кольорову крапку біля назви кожного попередження.
Не чекайте рамок вікон TP без легального локального дампу і плагіна Zelda BMG.
Поля Story Context
Над Editable: Window:, Chapter:, Speaker:, Font / Max-width. Ті самі призначення, які читають віртуальні теки.
- Подвійний клік Window: → фізичний блок гри.
- Подвійний клік Chapter: → віртуальний Chapter.
- Подвійний клік Speaker: → віртуальний Speaker або Item.
Noneу Speaker знімає призначення.
Не вигадуйте спікерів для порожніх слотів паддингу; цих рядків немає в Speakers.