wydengyre/bitextual

a tool for bilingual text alignment

Bitextual: A tool for bilingual text alignment

Bitextual takes translated (preferably by humans) epubs in two languages, and outputs a bilingual book.

This is useful for lovers of translated literature and intermediate-to-advanced level language learners.

You can use Bitextual on the web at bitextual.net.

You can also use it as a command-line tool with node.js by cloning this repo.

There are two output options. Links to examples are in the technical notes, below:

• HTML: A parallel, bilingual web page.
• ePub: The source book, but with a link at the end of each paragraph to the translated paragraph. This is great for using an e-reader.

Some technical notes

For an example of output, see the included French-English copy of Madame Bovary. That file is generated with the following command:

tsx packages/cli/main.ts --html packages/test/bovary.french.epub packages/test/bovary.english.epub > packages/web/dist/bovary.aligned/index.html

The command says "run the main.ts script with html output on Bovary in French (source) and Bovary in English (target)."

There is also an epub version, produced with the following command:

tsx packages/cli/main.ts --epub packages/test/bovary.french.epub packages/test/bovary.english.epub > packages/web/dist/bovary.aligned/bovary.epub

This project relies on a WebAssembly fork of hunalign for text alignment.

bitextual's Issues

replace `toArray` with `Array.fromAsync`

Optimization: pass in a dom parser

In the web version, we can rely on the browser's DOM parser, rather than getting one from NPM