Yapıyı koruyan EPUB
ZIP düzeyinde yazım: özgün her girdi bayt bayt kopyalanır; yalnızca çevrilen XHTML, OPF ve NCX/nav etiketleri değişir. Çıktı EPUBCheck’ten girdi kadar iyi geçer.
v1.1.0 · PyPI · ücretsiz motorlar
Kitaplarınız Türkçeye edebiyat gibi çevrilsin.
epub-tr, EPUB kitapları doğal ve edebî Türkçeye çevirirken kitabı bozmaz: biçim, görseller, CSS, fontlar, içindekiler, üst veri ve iç bağlantılar korunur. Ücretli API anahtarı gerekmez.
Çeviri motorlarıOpenCode (free LLM)OllamaGoogleBingYandexModernMTMyMemoryLingvaLibreTranslateArgos (offline)OpenRouterGeminiGroqMistralOpenAI
Neden epub-tr?
Makine çevirisi kitabı bozar. epub-tr bozmaz.
Çeviri sonrası italikler, dipnotlar ve bağlantılar kaybolur.
Satır içi biçim nötr yer tutuculara dönüşür ve tüm öznitelikleriyle geri kurulur; her bağlantı hedefi korunur.
Karakter adları bölümden bölüme değişir.
Akan sözlük: model ad ve terim kararlarını bildirir, kitabın geri kalanında yeniden kullanılır; önbellekte saklanır.
Düz, kelimesi kelimesine Türkçe.
Edebî Türkçe sistem istemi, bağlam penceresi, TDK yazımı, sen/siz tutarlılığı ve isteğe bağlı ikinci cila geçişi (
--polish).Özellikler
Kitabı koruyan, üslubu taşıyan çeviri
Edebî LLM hattı
Kararlı <seg id>’li parçalar, önceki paragrafları taşıyan bağlam, özel ad algılama (Della’nın) ve diyalog noktalaması.
İki dilli baskı
--bilingual her özgün paragrafın altına çevirisini ekler: dil öğrenenler için ideal.
Kaldığı yerden devam
SQLite önbelleği: komutu yeniden çalıştırın, biten bölümler önbellekten gelir, yalnızca boşluklar modele gider.
Yedek zincir
Parça başına --fallback google,argos; OpenCode ücretsiz limitlerinde modeller arasında otomatik geçiş.
Yerel ve gizli
Ollama ya da tamamen çevrim dışı Argos ile kitabınız bilgisayarınızdan çıkmaz.
Ölçülen sıralama
O. Henry’nin Müneccimlerin Armağanı üzerinde ölçüldü
51 parça, 11.237 karakter. Ayrıntılar ve çıktılar depoda.
🥇opencode + --polish: en iyisi, düzeltilmiş Türkçe düzyazı gibi okunuyor
🥈opencode taslak: deyimsel, birkaç yazım hatası
🥉bing: en doğal makine çevirisi, 43 sn
1,7 sgoogle: akıcı ama kelimesi kelimesine, kurulum gerektirmez
OpenCode ücretsiz katmanı IP başına limitli ve yavaştır (testte çağrı başına ~5 dk); bazı parçalar başarısız olabilir, aynı komutu sonra yeniden çalıştırın. Hızlı sonuç için --engine bing ya da google.
Nasıl çalışır
Dört komutla çevrilmiş bir kitap
Kurun
pip install epub-tr (Python 3.10+).
Motorları kontrol edin
epub-tr engines --check makinenizde nelerin çalıştığını gösterir.
İnceleyin
epub-tr inspect kitap.epub --show 10 neyin çevrileceğini gösterir.
Çevirin
epub-tr translate kitap.epub --engine opencode --polish --fallback bing
Kurulum
PyPI’dan tek komut
Son sürüm: v1.1.0. pipx install epub-tr da çalışır.
# çekirdek pip install epub-tr # + çevrim dışı Argos ve Bing/Yandex/ModernMT pip install "epub-tr[argos,extra]" # OpenCode CLI (ücretsiz LLM’ler) npm i -g opencode-ai
# en iyi kalite, ücretsiz epub-tr translate book.epub -o book.tr.epub --engine opencode --polish --fallback bing # yerel ve gizli epub-tr translate book.epub --engine ollama -m aya-expanse:8b # hızlı, iki dilli baskı epub-tr translate book.epub --engine google --bilingual -o book.en-tr.epub
Çevrim dışı kurulum için wheel ve kaynak paketi.
🐍Wheel (.whl)epub_tr-1.1.0-py3-none-any.whlÖnerilen📦Kaynak (.tar.gz)epub_tr-1.1.0.tar.gzÖnerilen#SağlamalarSHA256SUMS.txtÖnerilen
pip install ./epub_tr-1.1.0-py3-none-any.whl
git clone https://github.com/cumabozkurt/epub-tr.git && cd epub-tr python3 -m venv .venv && . .venv/bin/activate pip install -e ".[dev]" epub-tr translate samples/pg7256.epub -e google -o magi.tr.epub
Kimler için?
Türkçe okumak ve okutmak isteyenler
Okurlar
Türkçesi olmayan bir kitabı kendi kişisel kopyanız için okunabilir Türkçeye çevirin.
Dil öğrenenler
İki dilli baskıyla her paragrafın altında çevirisi.
Çevirmenler ve editörler
Sözlük tohumlama, ikinci cila geçişi ve --dump pairs.jsonl ile taslak üretip düzeltin.
SSS
Sık sorulan sorular
Gerçekten ücretsiz mi?
Evet. Araç MIT lisanslı ve tüm motorlar ücretli API anahtarı olmadan kullanılabilir (OpenCode ücretsiz modelleri, Google/Bing web, Ollama, Argos…).
Sadece Türkçeye mi çeviriyor?
Türkçe önceliklidir ama
--target ile başka hedef diller de çalışır.Kitabım bozulur mu?
Hayır. Özgün girdiler bayt bayt kopyalanır, yalnızca çevrilen içerik değişir; çıktı EPUBCheck’ten girdi kadar iyi geçer.
Telif hakkı?
epub-tr bir araçtır; çevirdiğiniz kitabın haklarına ve yerel yasalara uymak sizin sorumluluğunuzdadır. Kamu malı eserler (ör. Project Gutenberg) güvenli bir başlangıçtır.
Bir sonraki kitabınız Türkçe okunsun.
pip ile kurun, tek komutla çevirin; kitabın biçimi ve yazarın sesi yerinde kalsın.