Difference between revisions of "Using the tools on your own system"

From LING073
Jump to: navigation, search
m (→‎Misc tools)
(rearranged for 2021)
Line 1: Line 1:
−
There are two ways to use many of the tools we use in class on another system.  The easiest is to set up a copy of the virtual machine we run.  You may also install the tools on your own system.  The instructions for both approaches follow.
+
It's possible to use the tools we make use of in class on your own system.
  
−
== Installing the VM ==
+
The following is the complete list of tools you'll need:
−
If you want to use a copy of the VM we use in class, you can grab a copy hosted by SCCS ([http://www.sccs.swarthmore.edu/users/faculty/jnw/Debian.ova Debian.ova]—'''WARNING: 2.5GB file!''').  Just install VirtualBox on your system and import that file.
+
* The core tools:
 +
** Apertium, with <code>lttoolbox</code> and other dependencies
 +
** <code>apertium-lex-tools</code>, <code>apertium-separable</code>, <code>apertium-recursive</code>, <code>apertium-anaphora</code>
 +
** HFST
 +
** CG-3
 +
** <code>lexd</code>
 +
* <code>udpipe</code> (not needed Spring 2021)
 +
* Miscellaneous tools (from repo)
  
−
== Installing the tools ==
+
== Installing core tools ==
−
If you're running linux, Mac OS X, or Windows 10, you should be able to use the tools in the course on your own system.
+
There are three main methods to install the core tools:
 +
* If you run Linux, set up your package manager to use Apertium's repos
 +
* If you run Windows 10, set up WSL and set up the package manager to use Apertium's repos
 +
* If you run macOS, [[#Apertium installation on Mac using homebrew|use homebrew]] to install them
  
−
=== Apertium ===
+
Alternatively, you can install VirtualBox and use a [https://wiki.apertium.org/wiki/Apertium_VirtualBox Linux virtual machine with Apertium tools installed].
  
−
See the [[:apertium:Installation#If_you_want_to_add_language_data_.2F_do_more_advanced_stuff|Installation]] page on Apertium's wiki.
 
  
−
=== Apertium-quality ===
+
=== Apertium installation on Mac using homebrew ===
  
−
Install from github as described on Apertium's wiki: [[:apertium:Apertium-quality/Installation|Apertium quality installation]].
+
==== Install homebrew ====
  
−
=== UDpipe ===
+
[https://brew.sh Homebrew] is a package manager for Mac.  To install it, open a terminal run the following:
−
Follow [https://ufal.mff.cuni.cz/udpipe/install these instructions].
 
−
 
 
−
=== Misc tools ===
 
−
 
 
−
Clone <code>git@github.swarthmore.edu:Ling073-sp18/tools.git</code> and run <code>sudo make</code>.
 
−
 
 
−
=== ibus-m17n (for keyboard layouts) ===
 
−
If you want to test your keyboard layout, install <code>ibus-m17n</code> on your linux system.
 
−
 
 
−
== Apertium installation on Mac using brew ==
 
−
 
 
−
=== Install homebrew ===
 
−
 
 
−
[https://brew.sh Homebrew] is a package manager for Mac.  To install it, run the following:
 
  
−
  $ /usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
+
  $ /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
  
 
This will take several minutes.
 
This will take several minutes.
Line 37: Line 32:
 
''Note that you'll probably need the XCode developer tools from Apple to install homebrew.  If you don't have them installed, Homebrew may direct you to install them—perhaps automatically—but it may not.''
 
''Note that you'll probably need the XCode developer tools from Apple to install homebrew.  If you don't have them installed, Homebrew may direct you to install them—perhaps automatically—but it may not.''
  
−
=== Install dependencies from homebrew ===
+
==== Install dependencies from homebrew ====
  
−
  $ brew install gawk subversion autoconf automake pkgconfig wget python3
+
  $ brew install gperftools help2man pcre icu4c perl518 gawk autoconf automake pkg-config cmake wget gcc
  
−
This will take a couple minutes.  You'll also want yaml if you install [[:apertium:Apertium-quality/Installation|apertium-quality]].
+
This will take a couple minutes.  You'll also want yaml if you install [[#Misc tools|morph-test]] from the misc tools.
  
 
  $ pip3 install PyYAML
 
  $ pip3 install PyYAML
  
−
=== Install apertium core tools and HFST ===
+
==== Install apertium core tools and HFST ====
  
 
  $ wget https://apertium.projectjj.com/osx/install-nightly.sh -O - | bash
 
  $ wget https://apertium.projectjj.com/osx/install-nightly.sh -O - | bash
  
 
This will take a minute.
 
This will take a minute.
 +
 +
== UDpipe ==
 +
Follow [https://ufal.mff.cuni.cz/udpipe/install these instructions].
 +
 +
== Misc tools ==
 +
 +
Clone <code>git@github.swarthmore.edu:Ling073-sp21/tools.git</code> and run <code>make</code> or <code>sudo make</code>.
 +
  
 
[[Category:Tutorials]]
 
[[Category:Tutorials]]
 
[[Category:Tools]]
 
[[Category:Tools]]

Revision as of 21:06, 24 January 2021

It's possible to use the tools we make use of in class on your own system.

The following is the complete list of tools you'll need:

  • The core tools:
    • Apertium, with lttoolbox and other dependencies
    • apertium-lex-tools, apertium-separable, apertium-recursive, apertium-anaphora
    • HFST
    • CG-3
    • lexd
  • udpipe (not needed Spring 2021)
  • Miscellaneous tools (from repo)

Installing core tools

There are three main methods to install the core tools:

  • If you run Linux, set up your package manager to use Apertium's repos
  • If you run Windows 10, set up WSL and set up the package manager to use Apertium's repos
  • If you run macOS, use homebrew to install them

Alternatively, you can install VirtualBox and use a Linux virtual machine with Apertium tools installed.


Apertium installation on Mac using homebrew

Install homebrew

Homebrew is a package manager for Mac. To install it, open a terminal run the following: 

$ /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

This will take several minutes.

Note that you'll probably need the XCode developer tools from Apple to install homebrew. If you don't have them installed, Homebrew may direct you to install them—perhaps automatically—but it may not.

Install dependencies from homebrew

$ brew install gperftools help2man pcre icu4c perl518 gawk autoconf automake pkg-config cmake wget gcc

This will take a couple minutes. You'll also want yaml if you install morph-test from the misc tools. 

$ pip3 install PyYAML

Install apertium core tools and HFST

$ wget https://apertium.projectjj.com/osx/install-nightly.sh -O - | bash

This will take a minute.

UDpipe

Follow these instructions.

Misc tools

Clone git@github.swarthmore.edu:Ling073-sp21/tools.git and run make or sudo make.

Retrieved from "http://wikis.swarthmore.edu/ling073/index.php?title=Using_the_tools_on_your_own_system&oldid=10754"