Difference between revisions of "Become a language pair developer for Apertium"

From Apertium
Jump to navigation Jump to search
(A step-by-step guide on using a development vesion of Apertium to make a change in a language pair.)
 
Line 1: Line 1:
{{TOCD}}This is a Step-by-step guide on how to use a development version of Apertium to make a change in a language pair. These instructions assume that you are using Ubuntu or Debian; if not then please see [http://wiki.apertium.org/wiki/Installation Installation] for installation on other OS's such as Mac OS X or Windows.
{{TOCD}}This is a Step-by-step guide on how to use a development version of Apertium to make a change in a language pair. These instructions assume that you are using Ubuntu or Debian; if not then please see [http://wiki.apertium.org/wiki/Installation this page] for installation on other OS's such as Mac OS X or Windows.


== Step 1: Install the Prerequisites ==


== Part 1: Installation ==
A development version of Apertium and the language pair you want to change has to be installed on your computer in order to change the language pair.


'''Step 1: Get the Prerequisites
Start by opening a new Terminal. [[File:Ubuntu_terminalIcon.png]]
'''

A development version of Apertium and the language pair you want to change has to be installed on your computer first before you can change something about the language pair.

Start by opening a new Terminal.


Then, use this command to install the prerequisites:
Then, use this command to install the prerequisites:
<pre>
<pre>
$ sudo apt-get install subversion build-essential g++ pkg-config gawk libxml2 \
sudo apt-get install subversion build-essential g++ pkg-config gawk libxml2 \
> libxml2-dev libxml2-utils xsltproc flex automake autoconf libtool libpcre3-dev
> libxml2-dev libxml2-utils xsltproc flex automake autoconf libtool libpcre3-dev
</pre>
</pre>

The Terminal will then ask you for your password to begin. ''Note:'' Keep track of how you type your password in your head. The Terminal will not display characters related to your password.
The Terminal will then ask you for your password to begin. ''Note:'' Keep track of how you type your password in your head. The Terminal will not display characters related to your password.


After you have entered your password, press the "Enter" key and wait for your computer to download and install the packages.
After you have entered your password, press the "Enter" key and wait for your computer to download and install the packages.


== Step 2: Get Apertium, lttoolbox, and Your Language Pair(s) ==
'''Step 2: Get Apertium, lttoolbox, and Your Language Pair(s)'''


Using the same Terminal, you can download the entire language pairs tree from SVN using the command:
Using the same Terminal, you can download the entire language pairs tree from SVN using the command:
<pre>
<pre>
$ svn co https://apertium.svn.sourceforge.net/svnroot/apertium
svn co https://apertium.svn.sourceforge.net/svnroot/apertium
</pre>
</pre>
Keep in mind that the full tree is over 4GB. If you have a slow connection or a limited data transfer amount, this is not recommended. However, if you want to focus on a small number of language pairs you can easily download and add language pairs with a command such as:
Keep in mind that the full tree is over 4GB. If you have a slow connection or a limited data transfer amount, installing the whole tree is not recommended. However, if you want to focus on a small number of language pairs you can easily download and add language pairs with a command such as:
<pre>
<pre>
$ svn co http://apertium.svn.sourceforge.net/svnroot/apertium/trunk/lttoolbox
svn co https://apertium.svn.sourceforge.net/svnroot/apertium/trunk/<modulename>
$ svn co http://apertium.svn.sourceforge.net/svnroot/apertium/trunk/apertium
$ svn co https://apertium.svn.sourceforge.net/svnroot/apertium/trunk/<modulename>
</pre>
</pre>
These commands download Apertium, lttoolbox, and the language pair that you want to use.
In the area where it says <modulename>, you can replace this with the module that you want to use such as the Spanish/English module.

These next commands download Apertium, lttoolbox, and the language pair that you want to use.
<pre>
svn co http://apertium.svn.sourceforge.net/svnroot/apertium/trunk/lttoolbox
svn co http://apertium.svn.sourceforge.net/svnroot/apertium/trunk/apertium
svn co https://apertium.svn.sourceforge.net/svnroot/apertium/trunk/<modulename>
</pre>



For example, if you wanted to get Apertium, lttoolbox, and the Spanish/English pair you could enter:
For example, if you wanted to get Apertium, lttoolbox, and the Spanish/English module you could enter:
<pre>
<pre>
$ svn co http://apertium.svn.sourceforge.net/svnroot/apertium/trunk/lttoolbox
svn co http://apertium.svn.sourceforge.net/svnroot/apertium/trunk/lttoolbox
$ svn co http://apertium.svn.sourceforge.net/svnroot/apertium/trunk/apertium
svn co http://apertium.svn.sourceforge.net/svnroot/apertium/trunk/apertium
$ svn co https://apertium.svn.sourceforge.net/svnroot/apertium/trunk/apertium-en-es
svn co https://apertium.svn.sourceforge.net/svnroot/apertium/trunk/apertium-en-es
</pre>
</pre>

Revision as of 03:52, 12 December 2011

This is a Step-by-step guide on how to use a development version of Apertium to make a change in a language pair. These instructions assume that you are using Ubuntu or Debian; if not then please see this page for installation on other OS's such as Mac OS X or Windows.


Part 1: Installation

Step 1: Get the Prerequisites

A development version of Apertium and the language pair you want to change has to be installed on your computer first before you can change something about the language pair.

Start by opening a new Terminal.

Then, use this command to install the prerequisites:

sudo apt-get install subversion build-essential g++ pkg-config gawk libxml2 \
> libxml2-dev libxml2-utils xsltproc flex automake autoconf libtool libpcre3-dev

The Terminal will then ask you for your password to begin. Note: Keep track of how you type your password in your head. The Terminal will not display characters related to your password.

After you have entered your password, press the "Enter" key and wait for your computer to download and install the packages.

Step 2: Get Apertium, lttoolbox, and Your Language Pair(s)

Using the same Terminal, you can download the entire language pairs tree from SVN using the command:

svn co https://apertium.svn.sourceforge.net/svnroot/apertium

Keep in mind that the full tree is over 4GB. If you have a slow connection or a limited data transfer amount, installing the whole tree is not recommended. However, if you want to focus on a small number of language pairs you can easily download and add language pairs with a command such as:

svn co https://apertium.svn.sourceforge.net/svnroot/apertium/trunk/<modulename>

In the area where it says <modulename>, you can replace this with the module that you want to use such as the Spanish/English module.

These next commands download Apertium, lttoolbox, and the language pair that you want to use.

svn co http://apertium.svn.sourceforge.net/svnroot/apertium/trunk/lttoolbox
svn co http://apertium.svn.sourceforge.net/svnroot/apertium/trunk/apertium
svn co https://apertium.svn.sourceforge.net/svnroot/apertium/trunk/<modulename>


For example, if you wanted to get Apertium, lttoolbox, and the Spanish/English module you could enter:

svn co http://apertium.svn.sourceforge.net/svnroot/apertium/trunk/lttoolbox
svn co http://apertium.svn.sourceforge.net/svnroot/apertium/trunk/apertium
svn co https://apertium.svn.sourceforge.net/svnroot/apertium/trunk/apertium-en-es