Difference between revisions of "Installation"
(user vs hacker split) |
|||
| Line 2: | Line 2: | ||
{{Main page header}} |
{{Main page header}} |
||
== If you just want a simple way to translate offline == |
|||
* [[Apertium Simpleton UI]] is a simple UI for '''Windows''' or '''Mac OS X''' that lets you easily install language pairs and translate text |
|||
| ⚫ | |||
* Other '''Unix''' users should add Tino's repository as described below (currently there is no maintained UI for GNU/Linux or BSD's) |
|||
See [[Tools]] for more graphical user interfaces. |
|||
== If you want to hack on Apertium / do more advanced stuff == |
|||
'''Unix''' users (GNU/Linux, Mac, BSD) who wish to hack on Apertium should follow these three stages to installing the core packages and language data: |
'''Unix''' users (GNU/Linux, Mac, BSD) who wish to hack on Apertium should follow these three stages to installing the core packages and language data: |
||
| Line 21: | Line 32: | ||
For '''Windows''' users who wish to hack on Apertium, the best method is to download the [[Apertium VirtualBox]], which lets you run a Unix in your Windows, and comes with Apertium from SVN (and one language pair) pre-installed. Once you've got the VirtualBox, you can install more language pairs as shown in [[Minimal installation from SVN]]. <small>Alternatively, you can compile it for Windows using Cygwin; documentation for how to compile on Windows manually is at [[Apertium on Windows]]; there is also a script at [[Apertium guide for Windows users]], but it is currently out-of-date and in need of updating.</small> |
For '''Windows''' users who wish to hack on Apertium, the best method is to download the [[Apertium VirtualBox]], which lets you run a Unix in your Windows, and comes with Apertium from SVN (and one language pair) pre-installed. Once you've got the VirtualBox, you can install more language pairs as shown in [[Minimal installation from SVN]]. <small>Alternatively, you can compile it for Windows using Cygwin; documentation for how to compile on Windows manually is at [[Apertium on Windows]]; there is also a script at [[Apertium guide for Windows users]], but it is currently out-of-date and in need of updating.</small> |
||
* If you just want to translate text offline with a simple graphical interface on Windows, try [http://apertium.projectjj.com/win32/apertium-simpleton-win32.zip Apertium Simpleton UI]. |
|||
| Line 27: | Line 37: | ||
There are released tarball packages on the [http://www.apertium.org/?id=downloading official download page]. These are meant for packagers, and '''users who are not planning to develop''' on apertium. These are installed like the SVN packages, except you use <code>./configure</code> instead of <code>./autogen.sh</code>. Many systems now also have pre-packaged apertium language pairs, but the official Debian/MacPorts/… repositories are often quite outdated compared to the SVN versions – use TinoDidriksen's nightly packages as instructed in the "Prerequisites" pages above. |
There are released tarball packages on the [http://www.apertium.org/?id=downloading official download page]. These are meant for packagers, and '''advanced users who are not planning to develop''' on apertium. These are installed like the SVN packages, except you use <code>./configure</code> instead of <code>./autogen.sh</code>. Many systems now also have pre-packaged apertium language pairs, but the official Debian/MacPorts/… repositories are often quite outdated compared to the SVN versions – use TinoDidriksen's nightly packages as instructed in the "Prerequisites" pages above. |
||
| ⚫ | |||
Revision as of 19:00, 27 August 2015
|
Installation • Resources • Contact • Documentation • Development • Tools |
If you just want a simple way to translate offline
- Apertium Simpleton UI is a simple UI for Windows or Mac OS X that lets you easily install language pairs and translate text
- Android users can download the Apertium offline translator app (more info at Apertium Android) or the more advanced Mitzuli app.
- Other Unix users should add Tino's repository as described below (currently there is no maintained UI for GNU/Linux or BSD's)
See Tools for more graphical user interfaces.
If you want to hack on Apertium / do more advanced stuff
Unix users (GNU/Linux, Mac, BSD) who wish to hack on Apertium should follow these three stages to installing the core packages and language data:
- Install prerequisites specific to your operating system:
- Ubuntu / Debian / other Debian-based
- RHEL / CentOS / Fedora / OpenSUSE
- openSUSE
- Mac OS X
- Arch Linux
- Fedora
- Gentoo
- FreeBSD (untested)
- (Mandriva seems to have some trouble)
- Install apertium and related packages from SVN.
- Follow Minimal installation from SVN, this should be general enough to cover all the above operating systems.
- Fix any problems :)
- Search the page Installation Troubleshooting for your error message.
For Windows users who wish to hack on Apertium, the best method is to download the Apertium VirtualBox, which lets you run a Unix in your Windows, and comes with Apertium from SVN (and one language pair) pre-installed. Once you've got the VirtualBox, you can install more language pairs as shown in Minimal installation from SVN. Alternatively, you can compile it for Windows using Cygwin; documentation for how to compile on Windows manually is at Apertium on Windows; there is also a script at Apertium guide for Windows users, but it is currently out-of-date and in need of updating.
Some language pairs require extra packages like Constraint Grammar (vislcg3) or HFST in addition to apertium/lttoolbox/apertium-lex-tools. For most systems, the "Prerequisites" pages will show how to install these through your package manager, but see the section on installing vislcg3 and HFST, respectively if you're on a not-yet-supported system. You can tell if a package requires CG if it has an .rlx file, and HFST if it has a .lexc file.
There are released tarball packages on the official download page. These are meant for packagers, and advanced users who are not planning to develop on apertium. These are installed like the SVN packages, except you use ./configure instead of ./autogen.sh. Many systems now also have pre-packaged apertium language pairs, but the official Debian/MacPorts/… repositories are often quite outdated compared to the SVN versions – use TinoDidriksen's nightly packages as instructed in the "Prerequisites" pages above.
