Fandom Translator

Desktop-програма для перекладу сторінок fandom.com і wiki.warframe.com.

About

Fandom Translator допомагає перекладати wiki-сторінки як повноцінний робочий процес: завантажити сторінку, отримати вікітекст, перекласти його, захистити важливі терміни, переглянути різницю, перевірити preview і забрати готовий результат.

Проєкт зосереджений саме на перекладі wiki-контенту, а не на ролі універсального редактора тексту.

Можливості

• Завантаження сторінок Fandom і Warframe Wiki.
• Переклад через DeepL, Google або AI-провайдерів.
• Захищені терміни, які не змінюються під час перекладу.
• Вбудований Warframe preset для protected terms.
• Власні presets і JSON import/export для protected terms.
• Правила заміни з групами, дублікатами, undo/redo і підсвіткою в редакторі.
• Історія перекладів, restore points і recovery-flow після помилок.
• Режими code, preview і compare для перевірки результату.
• Windows desktop-збірка через Electron.

Підтримувані джерела

• https://*.fandom.com/wiki/...
• https://wiki.warframe.com/w/...

Технології

• Electron
• React + TypeScript + Vite
• Node.js + Express
• esbuild

Встановлення

Потрібно:

• Node.js 18+
• npm

Встановлення залежностей:

npm install
cd server; npm install; cd ..
cd client; npm install; cd ..

Налаштування ключів

У репозиторії є приклади env-файлів:

• env.example
• .env.example

Локальні .env файли створюються тільки за потреби. Реальні API-ключі не треба комітити.

Підтримувані змінні:

• DEEPL_API_KEY
• OPENAI_API_KEY
• GROK_API_KEY
• GEMINI_API_KEY
• OLLAMA_URL

Розробка

Запуск client і server разом:

npm run dev

Корисні команди:

• npm run check:release
• npm run dist
• npm run build:all
• npm run test:server
• npm run smoke:server

Збірка релізу

Windows-збірка:

npm run dist

Готові релізні файли створюються поза source-tree.

Структура

client/    React renderer
server/    backend для перекладу і wiki-flow
electron/  Electron main process
scripts/   release і pipeline helpers
docs/      нотатки проєкту
assets/    assets програми

Roadmap

Поточний план розвитку зберігається в ROADMAP.md.