README.md

Translation Gummy

Translation Gummy is a magical gadget which enables user to be able to speak and understand other languages. ※ Supported journals are listed here.

Installation

1. Install Translation-Gummy (There are two ways to install):
   • Install from PyPI (recommended):

     $ sudo pip install Translation-Gummy

   • Alternatively: install Translation-Gummy from the GitHub source:

     $ git clone https://github.com/iwasakishuto/Translation-Gummy.git
     $ cd Translation-Gummy
     $ sudo python setup.py install

2. Install wkhtmltopdf
   • Debian/Ubuntu:

     $ sudo apt-get install wkhtmltopdf

   • macOS:

     $ brew install homebrew/cask/wkhtmltopdf

3. Install driver for selenium: Selenium requires a driver to interface with the chosen browser, so please visit the documentation to install it.

   # Example: Chrome
   # visit "chrome://settings/help" to check your chrome version.
   # visit "https://chromedriver.chromium.org/downloads" to check <Suitable.Driver.Version> for your chrome.
   $ wget https://chromedriver.storage.googleapis.com/<Suitable.Driver.Version>/chromedriver_mac64.zip
   $ unzip chromedriver_mac64.zip
   $ mv chromedriver /usr/local/bin/chromedriver
   $ chmod +x /usr/local/bin/chromedriver

Quick example

• example notebooks
• Translation:
  • Python Module:

  >>> from gummy import TranslationGummy
  >>> model = TranslationGummy(translator="deepl")
  DRIVER_TYPE: local
  >>> model.en2ja("This is a pen.")
  DeepLTranslator query no.1 01/15 [#-------------------]  6.67% - 1.091[s]
  'これはペンです。'

  • Command line:

  $ gummy-translate "This is a pen."
  [success] local driver can be built.
  [failure] remote driver can't be built.
  DRIVER_TYPE: local
  DeepLTranslator query no.1 01/15 [#-------------------]  6.67% - 1.096[s]
  これはペンです。

  • Output
• Create PDF (with translation)
  • Python Module:

  >>> from gummy import TranslationGummy
  >>> model = TranslationGummy(gateway="utokyo", translator="deepl")
  >>> pdfpath = model.toPDF(url="https://www.nature.com/articles/ncb0800_500", delete_html=True)

  • Command line:

  $ gummy-journal "https://www.nature.com/articles/ncb0800_500"

  • Output