An Gramadóir:
Download/Installation/Usage

Users

If you just want to install and use the Irish grammar checker, you probably don't need to download anything from this site; instead you should install the Perl module Lingua::GA::Gramadoir as described below.

Developers

All developers will need the latest version of the developers' pack, which contains the scripts for converting rule sets into an installable Perl module.

All of the language-dependent input files used by the developers' pack (lexicons, rule sets, etc.) are contained in the following language packs:


Installation and Usage

Linux and Mac OS X

For Mac OS X, if you don't like installing packages from the command line, you can buy a standalone version of the grammar checker called "Ceart", produced in collaboration with Cruinneog.

The Irish grammar checker is distributed as the Perl module Lingua::GA::Gramadoir. If you are using Linux or some other Unix-like operating system (including Mac OS X), you surely already have Perl installed and you can install the module using CPAN.pm, for example, like this:

$ cpan
cpan> install Lingua::GA::Gramadoir

You probably need to have root permission to do this; if you don't, or you don't know what this means, ask a system administrator for help. Also, if this is the first time you're running cpan, you'll be guided through some configuration steps before you can do the installation.

Alternatively, you can also install everything by hand: download Lingua::GA::Gramadoir, unpack the archive, and try the following standard procedure:

% perl Makefile.PL
% make
% make install

You should now have the front-end script gram-ga.pl installed. To check the grammar of an Irish language text file called gaeilge.txt, use the following from the shell prompt:

% gram-ga.pl gaeilge.txt

More detailed usage instructions can be found using:

% gram-ga.pl --help

Windows

Things are somewhat more painful if you're running something like Windows.

  1. Install the latest version of ActiveState Perl.
  2. Go the DOS prompt (for the youngsters, you can get there by going to Start->Accessories->Command Prompt)
  3. Enter "perl -v" to verify that perl was installed correctly and is in your path; you should see something like this:
    C:> perl -v
    
    This is perl, v.5.8.6 built for MSWin32-x86-multi-thread
    (with 3 registered patches, see perl -V for more detail)
    
    Copyright 1987-2004, Larry Wall
    ...
    
  4. Now install An Gramadóir using the ActivePerl package manager ppm:
    C:> ppm
    ppm> install Lingua::GA::Gramadoir
    ppm> quit
    
  5. You should now have the front-end script gram-ga.pl installed. Unfortunately, by default DOS isn't capable of displaying the ANSI control codes that are used to highlight the errors in color. Also, you need to tell An Gramadóir to display messages in the default DOS character encoding (ibm-850). Therefore, to check an Irish language text file called gaeilge.txt, use the following:

    C:> gram-ga.pl --aschod=cp850 --dath=none gaeilge.txt
    

    Addendum (3 April 2012): I'm grateful to Chris Snedigar for pointing out this trick for enabling the ANSI color codes!


Creative Commons License
This work is licensed under a Creative Commons Attribution-ShareAlike 3.0 Unported License.