LibreOffice plugin to pipe whole Writer documents through Google Translate, that ought to keep most of the page formatting.

βŒˆβŒ‹ βŽ‡ branch:  PageTranslate

Add PONS Text Translation backend.
mario authored 0 days ago last checkin 4620700b3
πŸ“‚ META-INF Introduce crude help file for config options.β€Ήβ€Ί 339 days ago
πŸ“‚ dingonyms added related/subproject: dingonymsβ€Ήβ€Ί 76 days ago
πŸ“‚ help Add errors, update help treeβ€Ήβ€Ί 96 days ago
πŸ“‚ icons resized, lighter blue tonesβ€Ήβ€Ί 371 days ago
πŸ“‚ off Add more languages ('le continental submenus)β€Ήβ€Ί 100 days ago
πŸ“‚ pkg-desc move license text to pkg-desc/β€Ήβ€Ί 356 days ago
πŸ“‚ pythonpath Add langdetect as dependency/bundle (used by mymemory)β€Ήβ€Ί 96 days ago
πŸ“„ Addons.xcu Minor documentation updates, yield errors for DeepL failures.β€Ήβ€Ί 0 days ago
πŸ“„ Makefile Minor documentation updates, yield errors for DeepL failures.β€Ήβ€Ί 0 days ago
πŸ“„ NEWS More error notes and changed MyMemory behaviour.β€Ήβ€Ί 94 days ago
πŸ“„ OptionsDialog.xcu AOO compat. OptionsDialog XCU requires leaf name to equal handler ID.β€Ήβ€Ί 350 days ago
πŸ“„ OptionsDialog.xdl Add PONS Text Translation backend.β€Ήβ€Ί 0 days ago
πŸ“„ OptionsSchema.xcs Rework config dialog to use dropdown/listbox for selecting service. Cβ€Ήβ€Ί 2 days ago
πŸ“„ description.xml Minor documentation updates, yield errors for DeepL failures.β€Ήβ€Ί 0 days ago
πŸ“„ pagetranslate.py Add PONS Text Translation backend.β€Ήβ€Ί 0 days ago

PageTranslate

OpenOffice/LibreOffice extension that translates whole documents, whilst retaining some formatting.

  • Iterates over paragraphs / text segments / and tables (only linebreaks kept)
  • Utilizes Google translate (or DeepL, Microsoft Translate, MyMemory).
  • And is therefore rather slow.
    (Writer freezes during process for long documents!)
  • Still allows for text-selection mode translation (from original extension).

Install

Download the package file, and import it in LibreOffice via Tools β†’ Extension Manager β†’ Add.

Location Features Link
Source repository Newest package, Linux-only package, no python dependencies pagetranslate.oxt
LibreOffice Extensions Older/stable versions, bundles python requests library https://extensions.libreoffice.org/extensions/pagetranslate
OpenOffice Extensions Full releases, AOO/LO/Windows compatible (bundles translate+requests) https://extensions.openoffice.org/en/project/pagetranslate

For using the unbundled/development package, you should install Python dependencies on your system:
pip3 install -U requests translate deep-translator six

Usage

  • Hit the Tβ†’πŸ‡¬πŸ‡§ toolbar button to get entire document translated to English. Have some trust and patience for longer documents.
  • The second button 🏴 translates to the local/system language.
  • Or select a paragraph, to get a partial translation.
  • Alternatively pick a menu entry from Extras > PageTranslate.
  • The β†’System lang entry refers to your OpenOffice/Desktop setting.
  • Whereas β†’ Paragraph locale respects the text language as set in the Writer status bar.
  • A manual selection dialog is brought up by the From ➜ To πŸ—Ί menu entry. (Best used in MyMemory mode)
  • Configure options in Toolsβ†’Optionsβ†’Language Settingsβ†’PageTranslate

Caveats

  • Does not yet support anything but Writer documents. (Structure is entirely distinct for Draw/Impress).
  • The plugin is also likely to crash (won't affect Writer) when encountering complex documents (embedded drawings, Calc sheets, OLE elements, etc). It's only been tested with flow text and text tables.
  • Generally there's a log file in /tmp.
  • Not sure if the toolbar icons work at all, or if that's a bug in the Linux version of LibreOffice.
  • OpenOffice support is somewhat preliminary still (albeit it's mostly Python 2.7 fallbacks and XCU variations).
  • For direct content.xml translations, there's an inconvenient tool in off/. (Each office document .odt/.odc is a zip file. Extract the content.xml, apply the script, then repackage the content.xml into the .odc)

ToDo

  • Integrate deep-translator backends (Yandex, QCRI, Pons, Linguee) and language mapping. Perhaps offer as alternative to T-P and internal variants.
  • Finalize DeepL web translation mode (for testing really). The API mode is untested, but likely faster because longer paragraphs can be translated at once. And reportedly it yields smoother/more natural translations. (No XML block translation yet.)
  • Unfortunately not sure yet how to bundle requests.
  • Nor how to craft an options/settings page.
  • Support for TextFrames
  • Figure out if getText() provides for some XML serialization, or how to traverse Paragraphs piece by piece (super slow mode: retain more formatting).