Difference between revisions of "Apertium VirtualBox"

From Apertium
Jump to navigation Jump to search
(→‎Clipboard: todo more readable)
(Updated all packages, new image, same 16.04.)
(11 intermediate revisions by 5 users not shown)
Line 3: Line 3:
 
Since so many have problems getting Apertium to run on Windows or OS X, or are limited in bandwidth, [[User:Tino_Didriksen|Tino Didriksen]] has put together a ready-to-use VirtualBox VDI:
 
Since so many have problems getting Apertium to run on Windows or OS X, or are limited in bandwidth, [[User:Tino_Didriksen|Tino Didriksen]] has put together a ready-to-use VirtualBox VDI:
   
* http://tinodidriksen.com/uploads/Apertium-VirtualBox-20141028.7z
+
* http://tinodidriksen.com/uploads/Apertium-VirtualBox-20170911.7z
* 702640383 bytes (671 MB)
+
* 678677052 bytes (648 MB)
  +
* SHA-1: 79494105757e789095c1e22c72218cbd28b28d15
* SHA-1: 695f2ee09153a86c9a80338b2ffd95432c287e5a
 
   
 
...or if you prefer a ZIP file:
 
...or if you prefer a ZIP file:
* http://tinodidriksen.com/uploads/Apertium-VirtualBox-20141028.zip
+
* http://tinodidriksen.com/uploads/Apertium-VirtualBox-20170911.zip
* 1007785071 bytes (962 MB)
+
* 1059056234 bytes (1010 MB)
  +
* SHA-1: ed10d516e7ea699d455971a58675ce1e56145655
* SHA-1: c68a29bad24a69190e78d739f90324f2c6b4f9b9
 
   
The archive decompresses to a 3.3 GB vdi file.
+
The archive decompresses to a 3.26 GB vdi file.
  +
  +
<span style="color: #f00;">'''Important:''' If you just want to translate, you do not need the VirtualBox image. You can instead use the much smaller [[Apertium Simpleton UI]].</span>
   
 
==Contents==
 
==Contents==
   
* Xubuntu 14.10, so Xfce4 instead of Unity (Ubuntu's fancy-yet-useless interface), trimmed of all non-essential packages
+
* Lubuntu 16.04, trimmed of all non-essential packages
* VirtualBox 4.3.18 Guest Additions
+
* VirtualBox Guest Additions
 
* XChat, set to automatically connect to Freenode #apertium as nick ap-vbox (appending -2 or -3 on conflict), preconfigured in UTF-8 mode
 
* XChat, set to automatically connect to Freenode #apertium as nick ap-vbox (appending -2 or -3 on conflict), preconfigured in UTF-8 mode
 
* Firefox, homepage set to Apertium Wiki
 
* Firefox, homepage set to Apertium Wiki
* Gedit
 
   
Core tools installed via apt-get from repository http://apertium.projectjj.com/apt/ :
+
Core tools installed via apt-get from repository https://apertium.projectjj.com/apt/ :
  +
* HFST
* Foma 0.17
 
* HFST 3.8.0
+
* CG-3
 
* Apertium
* CG-3 0.9.9
 
 
* lttoolbox
* Apertium 3.3.0
 
 
* apertium-lex-tools
* lttoolbox 3.3.0
 
* apertium-lex-tools 0.1.0
 
   
It automatically logs in to a 1024x768 desktop. All passwords set to 'apertium' for when root is needed. Keyboard and timezone are set to Danish, but there is a shortcut for Keyboard configuration on the desktop.
+
It automatically logs in to a 1024x768 desktop. All passwords set to 'apertium' for when root is needed. Keyboard and timezone are set to Danish, but you can change the keyboard layout from the top right widget.
   
On first boot, it looks like:
+
On first boot, it looks something like:
   
 
http://tinodidriksen.com/uploads/Apertium-VirtualBox-20140418.png
 
http://tinodidriksen.com/uploads/Apertium-VirtualBox-20140418.png
Line 53: Line 53:
 
==Step-by-Step Installation Instructions==
 
==Step-by-Step Installation Instructions==
   
1. Download the file (http://tinodidriksen.com/uploads/Apertium-VirtualBox-20141028.7z).
+
1. Download the file (http://tinodidriksen.com/uploads/Apertium-VirtualBox-20170911.7z).
   
2. Use 7-Zip or a similar program to unzip the file. There should be exactly one thing in the unzipped folder - the Virtual Disk Image (VDI) entitled Apertium (Xubuntu 14.10).
+
2. Use 7-Zip or a similar program to unzip the file. There should be exactly one thing in the unzipped folder - the Virtual Disk Image (VDI) entitled Apertium (Lubuntu 16.04).
   
 
3. Start VirtualBox and click "New" to create a new virtual machine.
 
3. Start VirtualBox and click "New" to create a new virtual machine.
   
4. For the OS Type, select Linux, Ubuntu.
+
4. For the OS Type, select Linux, Ubuntu (32 bit).
   
5. For Memory, give it at least 512 MB RAM - it might run with less, but the more the better.
+
5. For Memory, give it at least 1024 MB RAM - it might run with less, but the more the better.
   
6. For Hard Disk, select the "Use an existing virtual hard drive file" radio button. Pick Apertium (Xubuntu 14.10).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".
+
6. For Hard Disk, select the "Use an existing virtual hard drive file" radio button. Pick Apertium (Lubuntu 16.04).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".
   
 
7. You can now run the new virtual box. On first boot it should look like this: http://tinodidriksen.com/uploads/Apertium-VirtualBox-20140418.png
 
7. You can now run the new virtual box. On first boot it should look like this: http://tinodidriksen.com/uploads/Apertium-VirtualBox-20140418.png
   
   
Now you should have a system with all the prerequisites installed, and you should be able to follow [[Minimal installation from SVN]] to install a language pair (and possibly any required language modules).
+
Now you should have a system with all the prerequisites installed, and you should be able to follow [[How to bootstrap a new pair]] to install a language pair (and possibly any required language modules).
   
 
==Clipboard==
 
==Clipboard==
To get the clipboard working between the virtualbox and e.g. Windows, go into Options of that VBox -> General -> Advanced tab -> Clipboard -> Bidirectional.
+
To get the clipboard working between the virtualbox and Windows/OS X, go into Options of that VBox -> General -> Advanced tab -> Clipboard -> Bidirectional.
   
 
==Copying files between Windows and the Virtualbox==
 
==Copying files between Windows and the Virtualbox==
 
You can have Virtualbox mount the Windows drive through VBox's shared folder feature:
<pre>
 
  +
<TinoDidriksen> You can just have VirtualBox mount the Windows drive through
 
  +
* Click "Devices" → "Shared Folders" and find a windows folder you want to share, giving it a name like <code>Shared</code>. Tick "Make Permanent".
VBox's shared folder feature.
 
  +
* Create a directory in the virtualbox to share it to: <code>sudo mkdir /media/windows-shared</code>
<TinoDidriksen> No need for any network.
 
  +
* Mount it like this: <code>sudo mount -t vboxsf Shared /media/windows-shared</code>
</pre>
 
  +
* To mount it on each reboot, do <code>sudo gedit /etc/rc.local</code> and write <code>sudo mount -t vboxsf Shared /media/windows-shared</code> before the "exit" line.
  +
  +
== Use ==
  +
It's easy to install a new language pair on Apertium VirtualBox. The instructions differ for released apertium pairs and unreleased pairs. To get a list of released apertium pairs, run the following in a terminal:
  +
  +
$ apt-cache search apertium- | grep trans
  +
  +
=== Installing a released pair ===
  +
To install a released apertium language pair in Apertium VirtualBox, just run the following, substituting "nno-nob" (Nynorsk-Bokmål) with the language pair of your choice.
  +
  +
$ sudo apt-get install apertium-nno-nob
  +
  +
=== Installing an unreleased pair ===
  +
  +
=== Using a language pair ===
  +
  +
There are several ways you can use a language pair.
  +
  +
1. You can pipe text through it, e.g.
  +
$ echo "this is random text" | apertium nno-nob
  +
  +
2. You can use it in interactive mode, by running it and typing text, e.g.
  +
$ apertium nno-nob
  +
this is random text
  +
  +
3. You can use it to translate a file; if you add a second filename, it'll output to that file, e.g.
  +
$ apertium nno-nob infile.txt outfile.txt
  +
  +
4. You can also run a file through it by piping the file's contents through it, e.g.
  +
$ cat file.txt | apertium nno-nob
  +
  +
You can then use the
  +
  +
  +
   
 
[[Category:Installation]]
 
[[Category:Installation]]
  +
[[Category:Documentation in English]]

Revision as of 12:20, 11 September 2017

Apertium-VirtualBox.png

Since so many have problems getting Apertium to run on Windows or OS X, or are limited in bandwidth, Tino Didriksen has put together a ready-to-use VirtualBox VDI:

...or if you prefer a ZIP file:

The archive decompresses to a 3.26 GB vdi file.

Important: If you just want to translate, you do not need the VirtualBox image. You can instead use the much smaller Apertium Simpleton UI.

Contents

  • Lubuntu 16.04, trimmed of all non-essential packages
  • VirtualBox Guest Additions
  • XChat, set to automatically connect to Freenode #apertium as nick ap-vbox (appending -2 or -3 on conflict), preconfigured in UTF-8 mode
  • Firefox, homepage set to Apertium Wiki

Core tools installed via apt-get from repository https://apertium.projectjj.com/apt/ :

  • HFST
  • CG-3
  • Apertium
  • lttoolbox
  • apertium-lex-tools

It automatically logs in to a 1024x768 desktop. All passwords set to 'apertium' for when root is needed. Keyboard and timezone are set to Danish, but you can change the keyboard layout from the top right widget.

On first boot, it looks something like:

http://tinodidriksen.com/uploads/Apertium-VirtualBox-20140418.png

On the desktop is apertium-kaz-tat which works - compiling and testing that language pair should pretty much guarantee all required tools are installed and functional.

Nothing else from svn is left checked out - all was wiped after installing in order to save space.

The image is set up as a dynamically expanding hdd with max size 64 GB, where 8 GB is allocated to swap space.

Prerequisites

Step-by-Step Installation Instructions

1. Download the file (http://tinodidriksen.com/uploads/Apertium-VirtualBox-20170911.7z).

2. Use 7-Zip or a similar program to unzip the file. There should be exactly one thing in the unzipped folder - the Virtual Disk Image (VDI) entitled Apertium (Lubuntu 16.04).

3. Start VirtualBox and click "New" to create a new virtual machine.

4. For the OS Type, select Linux, Ubuntu (32 bit).

5. For Memory, give it at least 1024 MB RAM - it might run with less, but the more the better.

6. For Hard Disk, select the "Use an existing virtual hard drive file" radio button. Pick Apertium (Lubuntu 16.04).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".

7. You can now run the new virtual box. On first boot it should look like this: http://tinodidriksen.com/uploads/Apertium-VirtualBox-20140418.png


Now you should have a system with all the prerequisites installed, and you should be able to follow How to bootstrap a new pair to install a language pair (and possibly any required language modules).

Clipboard

To get the clipboard working between the virtualbox and Windows/OS X, go into Options of that VBox -> General -> Advanced tab -> Clipboard -> Bidirectional.

Copying files between Windows and the Virtualbox

You can have Virtualbox mount the Windows drive through VBox's shared folder feature:

  • Click "Devices" → "Shared Folders" and find a windows folder you want to share, giving it a name like Shared. Tick "Make Permanent".
  • Create a directory in the virtualbox to share it to: sudo mkdir /media/windows-shared
  • Mount it like this: sudo mount -t vboxsf Shared /media/windows-shared
  • To mount it on each reboot, do sudo gedit /etc/rc.local and write sudo mount -t vboxsf Shared /media/windows-shared before the "exit" line.

Use

It's easy to install a new language pair on Apertium VirtualBox. The instructions differ for released apertium pairs and unreleased pairs. To get a list of released apertium pairs, run the following in a terminal:

 $ apt-cache search apertium- | grep trans

Installing a released pair

To install a released apertium language pair in Apertium VirtualBox, just run the following, substituting "nno-nob" (Nynorsk-Bokmål) with the language pair of your choice.

 $ sudo apt-get install apertium-nno-nob

Installing an unreleased pair

Using a language pair

There are several ways you can use a language pair.

1. You can pipe text through it, e.g.

 $ echo "this is random text" | apertium nno-nob

2. You can use it in interactive mode, by running it and typing text, e.g.

 $ apertium nno-nob
 this is random text

3. You can use it to translate a file; if you add a second filename, it'll output to that file, e.g.

 $ apertium nno-nob infile.txt outfile.txt

4. You can also run a file through it by piping the file's contents through it, e.g.

 $ cat file.txt | apertium nno-nob

You can then use the