Apertium guide for Windows users

From Apertium
Revision as of 13:14, 1 December 2010 by Chalet16 (talk | contribs)
Jump to navigation Jump to search

This tutorial will guide you how to use Apertium Installer to install :

  • Apertium
  • Apertium language pairs
  • TortoiseSVN (GUI SVN client for Windows)
  • Notepad++ (Good open source text editor)

With Apertium Installer for Windows, there is no need to install tools such as Cygwin, Subversion, GCC etc. (which another guide such as Apertium_on_Windows require you to install).


Install Apertium

1. Download the installer from Sourceforge. Run and read the license argument of Apertium installer (most parts are GNU/GPL) then click "I Agree" to continue.

Apertium guide for Windows users Apertium 1.png

2. Select components to install (All of them are recommended for unexperienced users) then click "Next" to go to next page.

Apertium guide for Windows users Apertium 2.png

3. Choose the desired install location, location without special characters (eg. space, non-English characters) is recommended

Apertium guide for Windows users Apertium 3.png

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

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.

Apertium guide for Windows users Apertium 5.png

6. Installer will list packages which are required to install to resolve dependency problems. Click "Next" to continue.

Apertium guide for Windows users Apertium 6.png

7. There will be an alert box around the first time installation, just ignore and click "OK"

Apertium guide for Windows users Apertium 7.png

8. Cygwin setup will ask to create desktop icon and shortcut in Start Menu. Apertium installer will also create Start Menu shortcut so there is no need to select them.

Apertium guide for Windows users Apertium 8.png

9. Thent there will be a console recompiling Apertium and lttoolbox. It will take around 30-60 minutes. (It is fine to do other things during the waiting)


Install Apertium language pairs

1. Download the installer from Sourceforge. Run and read the license argument of Apertium installer (most parts are GNU/GPL) then click "I Agree" to continue.

Apertium Language Pairs Installer 1.png

2. Select language pairs you would like to install and click "Next" to continue. Full installation take few hours to install and not recomment for normal user.

Apertium Language Pairs Installer 2.png

3. Select location to install and click "Next". (Must be the same location that Apertium had been installed.)

Apertium Language Pairs Installer 3.png

4. Click Finish to finish installation process.

Apertium Language Pairs Installer 4.png


Install TortoiseSVN(optional)

See also: Using SVN with TortoiseSVN

1. Download TortoiseSVN from Offical downloads page. Run and click next to skip introduction step.

Apertium guide for Windows users TortoiseSVN 1.png

2. Read EULA and select "I accept the terms in the License Agreement", click "Next" to continue.

Apertium guide for Windows users TortoiseSVN 2.png

3. Select components to install, you can leave it as it is and click "Next" to continue.

Apertium guide for Windows users TortoiseSVN 3.png

4. The installer will show the finish page, click next and it will ask you to restart. You need to restart your machine to start using TortoiseSVN.

Apertium guide for Windows users TortoiseSVN 4.png

5. After TortoiseSVN there will be a menu item in context menu of every files and directories. To checkout SVN click "SVN checkout..."

Apertium guide for Windows users TortoiseSVN 5.png

6. You can now type URL of repository in Checkout dialog and click OK to start SVN checkout.

Apertium guide for Windows users TortoiseSVN 6.png


Install Notepad++(optional)

1. Download Notepad++ from offical site. Run and click "Next" to continue.

Apertium guide for Windows users NotepadPlus 1.png

2. Read license agreement and click "I agree" to continue.

Apertium guide for Windows users NotepadPlus 2.png

3. Select install location (recommmend default) and click "Next" to continue.

Apertium guide for Windows users NotepadPlus 3.png

4. Select components to install, just leave it as default and click "Next" to continue.

Apertium guide for Windows users NotepadPlus 4.png

5. The installer will start to process. After that you can select to run Notepad++ for first time.

Apertium guide for Windows users NotepadPlus 5.png

6. You can edit any files with Notepad++ by right click on them and click on a menu item named "Edit with Notepad++".

Apertium guide for Windows users NotepadPlus 6.png


How to commit changes to SVN using TortoiseSVN

1. Right click on directory you would like to commit changes and click "SVN Commit..." (Language pairs will normally located in C:\Apertium\home\apertium-install\languages)

TortoiseSVN Commit 1.png

2. Type message describe your changes and select file you wish to commit. Then click "OK" to start the process.

TortoiseSVN Commit 2.png

3. There will be a dialog ask your username and password. Fill the information and click "OK"

TortoiseSVN Commit 3.png

4. You will see a dialog show committing progress. Just wait and click "OK" after the process finished.

TortoiseSVN Commit 4.png