View source for Install Apertium core using packaging

You are using a Debian/Red Hat-based operating system. You want a fast clean install.

==Using public repositories, such as Debian Stable==
{{TOCD}}
<span style="color:darkred;">'''Not recommended'''</span>, except for assessment. See the next section on the Apertium private repository.

Apertium is a mature project, so you will find packages for Apertium in well-known public repositories. Moreover, the Apertium core is well-developed, so often backwards-compatible.  If you use one of these package downloads, they will work, and can give you a good idea of what Apertium is and can do.

In Debian repositories, Apertium core is listed simply as,

<pre>
apertium
</pre>

And can be installed by <code>sudo apt get</code> or similar method. Also, several language translation pairs will be available. For various reasons, the author has successfully developed language pairs using public repository versions of Apertium core.

There are good reasons not to use these downloads. First, although Apertium is often backwards-compatible, this is not a key aim of the project. The code may break between versions. Next, although Apertium is an older project, it is actively developed. Honest! Although Apertium core does not change often, it has been changed, and may be changed again. And Apertium has found a place, for example, supporting languages under threat. This is work without end. Check the main repository and you will find a steady stream of contributions. And then we can talk about the many projects surrounding Apertium. Despite organisation, key contributors can not always remember what is available, and where it is! And, finally, contributors to Apertium put a lot of effort into maintaining a package system that is up-to-date and ready to go.

Sometimes there is a good reason not to use the Apertium-provided packages. A workplace may place a restriction on install or rollout. Go ahead, use versions from a public repository. But the Apertium-provided packages are reliable, a key resource, and most people should use them.


== The Apertium private repository packages ==
[[User:Tino Didriksen|Tino Didriksen]] provides a repository of Debian/RPM packages. Downloading packages from there, you can install all prerequisites and Apertium tools.  You also get, for optional install; release-level language pairs, service providers, constraint grammar code, and more. All under package management.

Before we start, a comment from the mail list, by an admin-level contributor,

<blockquote>
If you're going to be developing, I'd say pick nightly. The -release
versions of lttoolbox and apertium might not be up-to-date with what
apertium-init expects.
</blockquote>


=== Debian-based ===
If you have a Debain or Debain-based system (e.g. Ubuntu, Mint...).

First, remove any Apertium packages you have installed from operating system repositories. They will be out-of-date, sometimes by years.

Add the repository,

<pre>
# Pick one:
# Release, stable:
wget https://apertium.projectjj.com/apt/install-release.sh -O - | sudo bash
# Nightly, unstable:
wget https://apertium.projectjj.com/apt/install-nightly.sh -O - | sudo bash
</pre>


You should see messages. 

Install dev tools,

<pre>
sudo apt-get -f install apertium-all-dev
</pre>


====About the Debian repository install====
Check the script installed Apertium repository details,

<pre>
pt-cache policy | grep apertium
</pre>

Unfortunately, due to the seamless upgrading of Debian packaging, it is difficult to see which packages the new repository has added, and where. Even Synaptic, the wonder GUI, has no way through. You could try this brute force commandline,

<pre>
find /var/lib/apt/lists/ |grep projectjj.*Packages | xargs grep -h Package
</pre>

Which will, if nothing else, tell you a lot about byways of the Apertium project.


=== Red Hat-based ===
If you have a RHEL/CentOS/Fedora/OpenSUSE or similar system.

First, remove any Apertium packages you have installed from operating system repositories. They will be out-of-date, sometimes by years.
 
Add the repository,

<pre>
# Pick one
# Release, stable:
wget https://apertium.projectjj.com/rpm/install-release.sh -O - | sudo bash
# Or nightly, unstable:
wget https://apertium.projectjj.com/rpm/install-nightly.sh -O - | sudo bash
</pre>

Install dev tools,

<pre>
# RHEL/CentOS:
sudo yum install apertium-all-devel
# Fedora:
sudo dnf install apertium-all-devel
# OpenSUSE:
sudo zypper install apertium-all-devel
</pre>


== And now... ==
Maybe you want to test this is working. So download a test language, [[Install language data using packaging]]. Then [[Install quick tests]] can make you sure.

If you are developing, now you can [[Install language data by compiling]] or [[Start a new language pair]]. If you are not, [[Install language data using packaging]] and go speak many languages :)


[[Category:Installation]]
[[Category:Documentation in English]]