User:Violet - Revision history

Violet at 04:50, 23 November 2011

2011-11-23T04:50:52Z

Violet at 04:49, 23 November 2011

2011-11-23T04:49:24Z

Violet: /* Install Apertium */

2011-11-23T01:38:08Z

Install Apertium

Francis Tyers: /* Developing further on a language pair */

2011-11-22T07:58:06Z

Developing further on a language pair

Francis Tyers: /* Quick test that it works */

2011-11-22T07:56:46Z

Quick test that it works

Violet: Created page with '== Install Apertium == 1. Download the installer from [http://sourceforge.net/projects/apertium/files/apertium-win32-installer/ApertiumSetup.exe/download Sourceforge]. Run the ex…'

2011-11-22T00:33:44Z

Created page with '== Install Apertium == 1. Download the installer from [http://sourceforge.net/projects/apertium/files/apertium-win32-installer/ApertiumSetup.exe/download Sourceforge]. Run the ex…'

New page

== Install Apertium ==
1. Download the installer from [http://sourceforge.net/projects/apertium/files/apertium-win32-installer/ApertiumSetup.exe/download Sourceforge]. Run the executable file and read the license argreement of the Apertium installer (most parts are GNU/GPL). Click "I Agree" to continue.

[[File:Apertium_guide_for_Windows_users_Apertium_1.png]]

2. Select the components you want to install. For unexperienced users, all of them are recommended. Click "Next" to go to next page.

[[File:Apertium_guide_for_Windows_users_Apertium_2.png]]

3. Choose the desired installation location. A location without special characters (eg. a space or non-English characters) is recommended.

[[File:Apertium_guide_for_Windows_users_Apertium_3.png]]

4. Cygwin installer will appear. Choose the nearest mirror and continue.

[[File:Apertium_guide_for_Windows_users_Apertium_4.png]]

5. You will be asked to select Cygwin packages. It is okay to leave them all unmarked. Click "Next" to continue.

[[File:Apertium_guide_for_Windows_users_Apertium_5.png]]

6. The installer may list packages which are required to install to resolve dependency problems. Click "Next" to continue.

[[File:Apertium_guide_for_Windows_users_Apertium_6.png]]

7. An alert box may appear if this is the first time Apertium is being installed. Click "OK."

[[File:Apertium_guide_for_Windows_users_Apertium_7.png]]

8. Cygwin setup will give you the option to create desktop icon and a shortcut in the Start Menu. The installer will create a Start Menu shortcut for Aperitum so there is no need to select them.

[[File:Apertium_guide_for_Windows_users_Apertium_8.png]]

9. The Apertium setup will be completed and you may click "Finish" to close the process.

=== Quick test that it works ===

You should now have the core/engine of Apertium installed (but no language pairs yet).

Upon installation, start Cygwin with Apertium. If you did not click the checkbox to run Cygwin after clicking "Finish," you may find the "Cygwin Bash Shell" in the Apertium folder in your Program Files in the start menu. The black "Cygwin" terminal window should be visible. If you try typing "apertium" and enter, you should see <code>USAGE: apertium [-d datadir] [-f format] [-u] <direction> [in [out]]</code> and some more text like that. If not, something probably went wrong...

If this happens, go to the the "Apertium" folder in your Program Files from the start menu and click "Update and recompile Apertium."

== Install Apertium language pairs ==
1. Download the language pair installer from [http://sourceforge.net/projects/apertium/files/apertium-win32-installer/ApertiumLanguageSetup.exe/download Sourceforge]. Run and read the license argreement of Apertium installer. Click "I Agree" to continue.

[[File:Apertium_Language_Pairs_Installer_1.png]]

2. Select 'Minimal' as the type to install and then select the language pairs you would like. The [http://wiki.apertium.org/wiki/Main_Page Main Apertium Wiki Page] shows the possible language pairs. Click "Next" to continue. '''Full installation (selection every language pair) takes a few hours to install and is not recommended for normal users.'''

[[File:Apertium_Language_Pairs_Installer_2.png]]

3. Select the location you would like the language pair installed and click "Next". '''The location must be the same as where Apertium was installed.'''

[[File:Apertium_Language_Pairs_Installer_3.png]]

4. Allow the Cygnwin Setup to install the language pair and click "Finish" to finish the installation process.

[[File:Apertium_Language_Pairs_Installer_4.png]]

===Quick test that it works===

After the installation, the black "Cygwin" terminal window should be visible (you can also find a link to this in your Start menu under "Apertium").

If you type "apertium -l" (without the quotes) and enter, you should see a list of the codes of the installed language pairs. If this lists <code>es-ca</code>, you can try typing "echo hola mundo | apertium es-ca" (without the quotes), you should see "hola món"; similarly for other language pairs.

===Translating a file===
Example: translating an HTML file from Asturian to Spanish:
<pre>
apertium -f html ast-es $(cygpath c:\\mystuff\\asturian_input.html) $(cygpath c:\\mystuff\\spanish_output.html)
</pre>

(The cygpath stuff is unfortunately needed to get to a Windows file path from Cygwin. A Windows Power User could probably write a script to make this a right-click menu option.)

Please note that backslash needs to be escaped, by typing it twice!

<u>Note :</u> It is also possible to use UNIX syntax for paths replacing every <code>\</code> of Windows path by a <code>/</code> . I don't know if it resolves the problem of cygpath. [[User:Bech|Bech]] 09:02, 11 September 2011 (UTC)

===Developing further on a language pair===
The installer puts the language data inside the Cygwin directory <code>/home/apertium-install/languages</code>, which is really located within the Windows directory <code>C:\Apertium\home\apertium-install\languages</code>. In there you'll find directories for all the installed language pairs, and can change language data and recompile etc. as described in [[Apertium_New_Language_Pair_HOWTO]]

: or was it <code>/home/apertium-installation/...</code>?

@@ Line 44: / Line 44: @@
 </pre>
-and some more text.  If you get a "command not found error", you must set your path to find the folder where your apertium command is.  Type in:
+and some more text.  If you get a "command not found" error, you must set your path to find the folder where your apertium command is.  Type in:
 <pre>
 export PATH=/home/apertium-install/apertium/apertium
 </pre>
-and then you may type "apertium" to see the Usage instructions above.
+and then you may type "apertium" to see the Usage instructions as seen above.
 == Apertium Language Pairs Installation ==

@@ Line 1: / Line 1: @@
-== Install Apertium ==
+== Apertium Installation ==
 . Download the installer from [http://sourceforge.net/projects/apertium/files/apertium-win32-installer/ApertiumSetup.exe/download Sourceforge]. Run the executable file and read the license argreement of the Apertium installer (most parts are GNU/GPL).  Click "I Agree" to continue.
@@ Line 50: / Line 50: @@
 and then you may type "apertium" to see the Usage instructions above.
-== Install Apertium language pairs ==
+== Apertium Language Pairs Installation ==
-. Download the language pair installer from [http://sourceforge.net/projects/apertium/files/apertium-win32-installer/ApertiumLanguageSetup.exe/download Sourceforge]. Run and read the license argreement of Apertium installer.  Click "I Agree" to continue.
+. Download the language pair installer from [http://sourceforge.net/projects/apertium/files/apertium-win32-installer/ApertiumLanguageSetup.exe/download Sourceforge]. Run and read the license agreement of the installer.  Click "I Agree" to continue.
 [[File:Apertium_Language_Pairs_Installer_1.png]]
@@ Line 63: / Line 63: @@
 [[File:Apertium_Language_Pairs_Installer_3.png]]
-. Allow the Cygnwin Setup to install the language pair and click "Finish" to finish the installation process.
+. Allow the Cygwin Setup to install the language pair and click "Finish" to finish the installation process.
 [[File:Apertium_Language_Pairs_Installer_4.png]]
-===Quick test that it works===
+===Quick Test that it Works===
-After the installation, the black "Cygwin" terminal window should be visible (you can also find a link to this in your Start menu under "Apertium").
+After the installation, the black "Cygwin" terminal window should be visible.  You can also find a link to this in your Program Files from the Start menu under "Apertium".
-If you type "apertium -l" (without the quotes) and enter, you should see a list of the codes of the installed language pairs. If this lists <code>es-ca</code>, you can try typing "echo hola mundo | apertium es-ca" (without the quotes), you should see "hola món"; similarly for other language pairs.
+If you type in "apertium -l" (without the quotes) and press enter, you should see a list of the codes of the installed language pairs. If this lists <code>es-ca</code>, you can try typing "echo hola mundo | apertium es-ca" (without the quotes). you should see "hola món"; similarly for other language pairs.
-===Translating a file===
+===Translating a File===
 Example: translating an HTML file from Asturian to Spanish:
 <pre>
@@ Line 85: / Line 85: @@
 <u>Note :</u> It is also possible to use UNIX syntax for paths replacing every <code>\</code> of Windows path by a <code>/</code> . I don't know if it resolves the problem of cygpath. [[User:Bech|Bech]] 09:02, 11 September 2011 (UTC)
-===Developing further on a language pair===
+===Further Development on a Language Pair===
 The installer puts the language data inside the Cygwin directory <code>/home/apertium-install/languages</code>, which is really located within the Windows directory <code>C:\Apertium\home\apertium-install\languages</code>. In there you'll find directories for all the installed language pairs, and can change language data and recompile etc. as described in [[Apertium New Language Pair HOWTO]]
-: or was it <code>/home/apertium-install/...</code>?

@@ Line 34: / Line 34: @@
 . The Apertium setup will be completed and you may click "Finish" to close the process.
-=== Quick test that it works ===
+=== A Quick Test that it Works ===
 You should now have the core/engine of Apertium installed (but no language pairs yet).
@@ Line 44: / Line 44: @@
 </pre>
+and some more text.  If you get a "command not found error", you must set your path to find the folder where your apertium command is.  Type in:
-and some more text like that. If not, something probably went wrong...
+<pre>
+export PATH=/home/apertium-install/apertium/apertium
-If this happens, go to the the "Apertium" folder in your Program Files from the start menu and click "Update and recompile Apertium."
+</pre>
+and then you may type "apertium" to see the Usage instructions above.
 == Install Apertium language pairs ==

@@ Line 38: / Line 38: @@
 You should now have the core/engine of Apertium installed (but no language pairs yet).
-Upon installation, start Cygwin with Apertium.  If you did not click the checkbox to run Cygwin after clicking "Finish," you may find the "Cygwin Bash Shell" in the Apertium folder in your Program Files in the start menu.  The black "Cygwin" terminal window should be visible. If you try typing "apertium" and enter, you should see <code>USAGE: apertium [-d datadir] [-f format] [-u] <direction> [in [out]]</code> and some more text like that. If not, something probably went wrong...
+Upon installation, start Cygwin with Apertium.  If you did not click the checkbox to run Cygwin after clicking "Finish," you may find the "Cygwin Bash Shell" in the Apertium folder in your Program Files in the start menu.  The black "Cygwin" terminal window should be visible. If you try typing "apertium" and enter, you should see
+<pre>
+USAGE: apertium [-d datadir] [-f format] [-u] <direction> [in [out]]
+</pre>
+and some more text like that. If not, something probably went wrong...
 If this happens, go to the the "Apertium" folder in your Program Files from the start menu and click "Update and recompile Apertium."