https://github.com/baroxyton/parallel-translation-generator
Generate a parallel translation (bilingual version) of a book, given a .epub file using google translate
https://github.com/baroxyton/parallel-translation-generator
bilingual bilingual-book-maker ebook ebook-translator epub google-translate language-learning language-learning-book parallel-text pdf translation
Last synced: 9 days ago
JSON representation
Generate a parallel translation (bilingual version) of a book, given a .epub file using google translate
- Host: GitHub
- URL: https://github.com/baroxyton/parallel-translation-generator
- Owner: baroxyton
- License: other
- Created: 2023-04-09T13:50:39.000Z (about 2 years ago)
- Default Branch: master
- Last Pushed: 2023-11-08T22:22:30.000Z (over 1 year ago)
- Last Synced: 2025-04-01T00:34:28.237Z (about 2 months ago)
- Topics: bilingual, bilingual-book-maker, ebook, ebook-translator, epub, google-translate, language-learning, language-learning-book, parallel-text, pdf, translation
- Language: Python
- Homepage:
- Size: 134 KB
- Stars: 4
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Parallel text generator
Given a .epub file, you can use this project to generate a parallel translation
## Prequesiteries:
- Linux environment (native, WSL, ...)
- Bash shell
- .epub file
- Installed commands: pdf2txt, zip/unzip, ebook-convert, python, pandoc, git
- Web browser
## Step 1: preparations
Run the command `git clone https://github.com/baroxyton/parallel-translation-generator` to copy the code to your computer. Next, navigate into it using `cd parallel-translation-generator`. Copy the .epub book into this directory and lastly run `pip install -r requirements.txt` to install the dependencies.
## Step 2: running it
run `python v2.py` and supervise the process. File paths requested can be provided relative or absolute. Note that you will need to translate a docx generated by the program in https://translate.google.com, so a modern browser with access to the file system is necessary.
## Features
- Generates a parallel translation of an ebook in .epub format.
- Provides a side-by-side comparison of the original text and its translation in a table format.
- Each paragraph is marked with a unique ID, making it easy to match the two versions.
## Limitations
- The tool requires some technical knowledge and may not be user-friendly for beginners.
- The translation quality heavily depends on the machine translation service used, in this case, Google Translate.
- The tool may not work for all .epub files due to their format or encoding. When not working as expected, using the old version may work as it allows more troubleshooting: https://github.com/baroxyton/parallel-translation-generator/tree/fa3436509671ed33a6532ec5872ecaa5cadab3a9
## Credits
This project is developed by baroxyton and is open-source and public domain under the CC0 License. Contributions are welcome.
## Disclaimer
This tool is provided as-is and the developers are not responsible for any errors, data loss, or other issues that may arise from its usage. Use at your own risk.