Francis Tyers

Introduction

Getting started

On a Mac:

You will then need to add the install location to your path. Brew will tell you what to do but if you forget you can find the install location using:

$ brew list icu4c | grep uconv

And then add the location of uconv to your PATH in your ~/.bash_profile.

On a machine running Windows:

Windows subsystem for Linux

Use these instructions, you may need to be administrator.

For the Linux platform, a good choice is Ubuntu or Debian

Virtual machine

You can follow the screencast to get installation instructions.

$ sudo apt-get update
$ sudo apt-get install git

Installing HFST

On a Mac:

http://apertium.projectjj.com/osx/nightly/
  1. Download hfst-latest.tar.bz2
  2. Extract the archive tar -xjvf hfst-latest.tar.bz2
  3. Add hfst/bin to your path: 
     export PATH=$PATH:<path_to_hfst_bin>
  4. Add path to ~/.bashrc or ~/.bash_profile

On Windows/Linux:

sudo apt-get -f install apertium-all-dev

Version control

Set up a GitHub account

Follow WikiHow instructions.

Fork repository

Link to the repository.

Quick guide to using git

You can clone your repository by doing:

$ git clone https://github.com/<USERNAME>/morph-xyz.git

Once you’ve made an edit, commit it using:

$ git commit -a -m "My commit message"

And push the changes using:

$ git push

If you get a message from git asking you to identify yourself, do:

$ git config --global user.email "my@email.address"
$ git config --global user.name "My Name"

If you want to compare your version against the last pushed version, do:

$ git diff

And if you want to see if there are any changes that haven’t yet been committed, do:

$ git status

Glossary