📚 TransEpub – Spanisch zu Deutsch EPUB Übersetzer

Eine moderne, rein client-seitige Webanwendung, die speziell dafür entwickelt wurde, E-Books im EPUB-Format von Spanisch nach Deutsch (oder in andere Sprachen) zu übersetzen und als fertige, valide EPUB-Datei wieder auszugeben.

Da die Anwendung zu 100 % im Browser läuft (HTML5 / JavaScript / JSZip), kann sie völlig kostenlos und ohne Backend über GitHub Pages gehostet werden!

---

✨ Features

• 🌐 100 % GitHub Pages kompatibel: Keine Server-Installation, keine Datenbank, keine laufenden Hosting-Kosten.
• 🛡️ 100 % Datenschutz: Deine Bücher und API-Schlüssel werden niemals an Drittserver gesendet, sondern verbleiben rein in deinem Browser (localStorage).
• 📖 Exakter Erhalt der Buchformatierung:
  • Paragraphen, Überschriften und Absätze bleiben erhalten.
  • Inline-Formatierungen (<em>, <strong>, <span>, <a href="..."> etc.) werden nicht zerstört oder überschrieben.
  • CSS-Stylesheets, Schriftarten, Buchcover und Bilder werden unberührt übernommen.
• 🌍 Umfangreiche Sprachauswahl (24+ Sprachen):
  • Spanisch, Deutsch, Englisch, Französisch, Italienisch, Portugiesisch, Niederländisch, Polnisch, Russisch, Ukrainisch, Schwedisch, Dänisch, Norwegisch, Finnisch, Tschechisch, Griechisch, Ungarisch, Rumänisch, Bulgarisch, Türkisch, Japanisch, Chinesisch, Koreanisch, Arabisch.
  • Automatisches Erkennen der Buchsprache aus den EPUB-Metadaten.
  • Sprachen-Tauschen-Button (↔) zum sofortigen Wechseln zwischen Ausgangs- und Zielsprache.
• ⚡ Mehrere Übersetzungs-Engines:
  • Google Gemini API (Empfohlen): Extrem schnell, kostenloser API-Key (Gemini 2.0 / 1.5 Flash), hervorragende literarische Textqualität mit Tag-Erhalt.
  • DeepL API: Beste Qualität mit nativer tag_handling=html Unterstützung (inkl. DeepL Sprachcode-Mapping für EN-US, PT-PT etc.).
  • Groq Cloud (Llama 3.3 70B): Kostenlos, blitzschnell und leistungsstark.
  • OpenAI (GPT-4o-mini): Zuverlässig und kostengünstig.
  • Kostenlos ohne API-Key: Direkter Soforttest via Web-API ohne vorherige Einrichtung.
• 📊 Live Side-by-Side Vorschau: Sieh in Echtzeit zu, wie Absätze in die Zielsprache übersetzt werden.
• 📥 Valider EPUB-Export: Erstellt nach IDPF-Standard ein neues .epub mit unkomprimiertem mimetype (STORE) und aktualisierten Sprach-Metadaten.

---

🚀 In 2 Minuten auf GitHub Pages bereitstellen

Folge diesen einfachen Schritten, um dein eigenes Übersetzungs-Tool online zu bringen:

1. Repository auf GitHub erstellen

1. Öffne GitHub und erstelle ein neues öffentliches (oder privates) Repository, z. B. trans-epub.

2. Code pushen

Öffne ein Terminal im Ordner f:\transepub und führe folgende Befehle aus:

git push -u origin main

3. GitHub Pages aktivieren

1. Gehe im GitHub-Repository Ballaual/transepub auf Settings (Einstellungen).
2. Klicke in der linken Seitenleiste auf Pages.
3. Wähle unter Build and deployment -> Source: Deploy from a branch.
4. Wähle als Branch main und als Ordner / (root) aus.
5. Klicke auf Save.

🎉 Nach etwa 1–2 Minuten ist deine App unter folgender Adresse weltweit erreichbar: https://ballaual.github.io/transepub/

---

🔑 Kostenlose API-Keys einrichten (Optional, aber empfohlen)

Für die beste Übersetzungsqualität und hohe Geschwindigkeit empfiehlt sich ein kostenloser API-Schlüssel:

Option A: Google Gemini API (Beste Wahl – Gratis)

1. Besuche Google AI Studio.
2. Melde dich mit deinem Google-Konto an und klicke auf Create API key.
3. Kopiere den Schlüssel und füge ihn in TransEpub unter Einstellungen ➔ Google Gemini ein.

Option B: DeepL API Free (500.000 Zeichen / Monat gratis)

1. Registriere dich auf DeepL API Free.
2. Gehe in deinen Account-Bereich und kopiere den Authentifizierungsschlüssel (endet typischerweise auf :fx).
3. Füge ihn in TransEpub unter Einstellungen ➔ DeepL API ein und wähle DeepL Free.

Option C: Groq Cloud (Llama 3.3 – Gratis & Superschnell)

1. Registriere dich auf Groq Cloud Console.
2. Erstelle einen neuen API-Schlüssel (gsk_...).
3. Füge ihn unter Groq ein.

---

💻 Lokales Testen (ohne Internet-Server)

Du kannst die Anwendung auch lokal auf deinem Computer ausführen. Öffne dazu ein Terminal im Projektordner und starte einen einfachen Webserver:

# Mit Python:
python -m http.server 8000

# Oder mit Node.js:
npx serve .

Öffne anschließend http://localhost:8000 in deinem Webbrowser. Alternativ kannst du zum Schnelltest die index.html auch direkt mit Doppelklick im Browser öffnen!

---

🛠️ Technologien

• HTML5 & Vanilla JavaScript: Keine komplizierten Frameworks, kein Build-Step (kein Webpack/Vite nötig).
• Tailwind CSS: Modernes, responsives Design mit Dark-Mode-Unterstützung.
• JSZip (v3.10.1): Parsing, Modifikation und Neupackung von EPUB-Archiven direkt im Browser-Speicher.
• DOMParser & XMLSerializer: Native Browser-APIs zur Erhaltung der XHTML-Dokumenthierarchie.