LingTranSoft.info

Installation Instructions

Installation Instructions when using the Windows 10 Linux Subsystem for Apertium (recommended)

This is the recommended installation because it does not require you to have a virtual machine installed. The Fall 2017 update to the Windows 10 Creator's Edition is required.

IMPORTANT: FLExTrans is a Windows tool that uses an application called FLExTools. FLExTools is part of the download for FLEXTrans. FLExTools requires Python which must be installed separately. Please see these instructions on the FLExTools Wiki.

Installation Steps:

  1. Unzip the FLExToolsWithFLExTrans.zip file somewhere on your harddrive.
  2. Install the Windows Subsystem for Linux: https://msdn.microsoft.com/en-us/commandline/wsl/install_guide)
  3. Install the Apertium system in the Linux subsystem:
    1. Open a Bash window (press the Windows key, type "bash" and Enter)
    2. Type: wget https://apertium.projectjj.com/apt/install-nightly.sh -O - | sudo bash
    3. Type: sudo apt-get -f install apertium-all-dev
  4. Install Python for use with WSL:
    1. In the Bash window, type the following: sudo apt-get install python
    2. Follow the prompts
  5. Try a test translation!
    1. Restore the two sample FLEx projects, German-FLExTrans-Sample and Swedish-FLExTrans-Sample which are located in the Sample Projects folder under the FLExToolsX.X.X folder. You can restore them by double-clicking on them.
    2. Close both sample FLEx projects.
    3. Start FlexTools by double-clicking on FlexTools.vbs in the FLExToolsX.X.X folder (You will get a Security Warning box that comes up. Untick the box that says "Always ask before opening this file" and click Open.)
    4. Click on the Run All (Modify) button to run all the FLExTrans modules.
    5. The German sentence 'Ich liebe dich.' (I love you.) will get translated to the Swedish 'Jag älskar dig.'
    6. Open the Swedish-FLExTrans-Sample FLEx project and refresh the list of texts. You should see Text1 appear with the Swedish translation in it.

Installation Instructions when using the Apertium virtual machine

After setting up the Apertium virtual machine. Transfer rules are automatically processed. A virtual machine is required to use the Live Rule Tester Tool.

  1. Unzip the FLExToolsWithFLExTrans.zip 1.3.10 file somewhere on your harddrive.
  2. If you haven't already, install VirtualBox.
  3. Download the virtual hard drive zip file - 1.03 GB.
  4. Unzip the file. There should be exactly one thing in the unzipped folder - the virtual disk file called ApertiumFLExTrans.vdi.
  5. Start VirtualBox and click "New" to create a new virtual machine.
  6. Give it a name (e.g. FLExTrans Apertium).
  7. For the OS Type, select Linux and Ubuntu (64-bit).
  8. For Memory, give it 512 MB RAM.
  9. For Hard Disk, select the "Use an existing virtual hard disk file" radio button. Pick ApertiumFLExTrans.vdi from the drop-down menu, or if it isn't there, click the folder icon with the green arrow to the right and navigate to wherever you unzipped the file to. Finish the process by clicking "Create".
  10. Set up a shared folder for the virtual machine.
    1. Select Machine > Settings > Shared Folders from the menu.
    2. Click the plus icon to add a new shared folder. For the folder path, navigate to where you unzipped the FLExToolsWithFLExTrans.zip file down to the FLExToolsX.X.X\FlexTools\Output folder.
    3. The Folder Name should be set to Output. Make sure you tick the "Auto-mount" option.
  11. You can now start the new virtual machine. On first boot it should look like this.this
  12. On the desktop double-click on the icon labeled "flextrans-setup". If you are prompted for the password for apertium, use the password: apertium. Running this script will set permissions and start a "cron" job which does the automatic processing of the transfer file.
  13. Try a test translation!
    1. Restore the two sample FLEx projects, German-FLExTrans-Sample and Swedish-FLExTrans-Sample which are located in the Sample Projects folder under the FLExToolsX.X.X folder. You can restore them by double-clicking on them.
    2. Close both sample FLEx projects.
    3. Start FlexTools by double-clicking on FlexTools.vbs in the FLExToolsX.X.X folder
    4. Click on the Run All (Modify) button to run all the FLExTrans modules.
    5. The German sentence 'Ich liebe dich.' (I love you.) will get translated to the Swedish 'Jag älskar dig.'
    6. Open the Swedish-FLExTrans-Sample FLEx project and refresh the list of texts. You should see Text1 appear with the Swedish translation in it.

Installation Instructions when not using the Apertium virtual machine

Without the Apertium virtual machine, transfer rules need to be processed "manually" by posting them to a website. This requires an internet connection. This could be a preferred option if there is not enough bandwidth to download the large virtual machine file. With this option you will not be able to use the Live Rule Tester Tool which relies on the Apertium virtual machine.