!!!Installing a North Saami speller for php-enchant

This document describes how to install a North Saami spellchecker for php using voikko/enchant as a provider.


!!Adding hfst-macports as MacPorts source

Open a terminal and write:

{{{
cd
git clone https://github.com/albbas/hfst-macports.git
cd hfst-macports
pwd
}}}

Open a second terminal. Edit the MacPorts sources.conf file, e.g.

{{{
sudo vim /opt/local/etc/macports/sources.conf
}}}

Above the line:
{{{
rsync://rsync.macports.org
}}}

Add
{{{
file://<the answer pwd gave in the first terminal>
}}}

In my case the line will become:
{{{
file:///Users/albbas/hfst-macports
}}}

Notice the __three__ slashes after "file:"

Save and close the sources.conf file.

To check that this local port is active, write

{{{
port search libvoikko
}}}

in the terminal

The answer should be

{{{
libvoikko @4.0 (textproc, devel)
    Spell-checking library for Finnish and other languages
}}}

If the answer is

{{{
No match for libvoikko found
}}}

then check that your __file__ line in sources.conf is correct.

!!Install hfst-ospell

{{{
sudo port install hfstospell
}}}

!!Install python3

libvoikko needs python3

{{{
sudo port install python35
sudo port select --set python3 python35  
}}}

!!Install libvoikko

{{{
sudo port install libvoikko
}}}

!!Install enchant with support for libvoikko

{{{
sudo port -v install enchant +libvoikko
}}}

!!Install enchant for php

(Here it is assumed that php 5.6 is the active php version. Substitute php56 with your active version, eg php53)

{{{
sudo port install php56-enchant
}}}

When this install is finished, write this in a terminal:

{{{
enchant-lsmod
}}}

The answer should show this:
{{{
aspell (Aspell Provider)
ispell (Ispell Provider)
myspell (Myspell Provider
voikko (Voikko Provider)
}}}

where Voikko Provider is the interesting case for us

!!!Install the North Saami spellchecker

As the enchant/voikko combo only provides fi as of now (20151204), the North Saami spellchecker has to be shoehorned in. This means that to get North Saami spellchecking, one must specify fi as the speller language and install the spellchecker the way it is described below.

In the terminal write this:
{{{
sudo mkdir -p /opt/local/lib/voikko/3/
curl -o fi.zhfst http://divvun.no/static_files/zhfsts/se_avvir.zhfst
sudo cp fi.zhfst /opt/local/lib/voikko/3/
}}}


!!!Testing the North Saami spellchecker

To check if php/enchant/libkvoikko works as expected, you can fetch a
test script from the Divvun/Giellatekno repository.

Write this in the terminal

{{{
wget --no-check-certificate https://gtsvn.uit.no/langtech/trunk/gt/script/prooftools/test-enchant.php
php56 test-enchant.php
}}}

This should result in:

{{{
Current broker provides the following backend(s):
Array
(
    [0] => Array
        (
            [name] => aspell
            [desc] => Aspell Provider
            [file] => /opt/local/lib/enchant/libenchant_aspell.so
        )

    [1] => Array
        (
            [name] => ispell
            [desc] => Ispell Provider
            [file] => /opt/local/lib/enchant/libenchant_ispell.so
        )

    [2] => Array
        (
            [name] => myspell
            [desc] => Myspell Provider
            [file] => /opt/local/lib/enchant/libenchant_myspell.so
        )

    [3] => Array
        (
            [name] => voikko
            [desc] => Voikko Provider
            [file] => /opt/local/lib/enchant/libenchant_voikko.so
        )

)
Array
(
    [0] => Array
        (
            [lang_tag] => fi
            [provider_name] => voikko
            [provider_desc] => Voikko Provider
            [provider_file] => /opt/local/lib/enchant/libenchant_voikko.so
        )

)
dictionary fi provides:
Array
(
    [lang] => fi
    [name] => voikko
    [desc] => Voikko Provider
    [file] => /opt/local/lib/enchant/libenchant_voikko.so
)
Suggestions for 'nuvviDspeller':Array
(
    [0] => Divvun speller for Northern Sami
    [1] => se version 0.1, 04.12.2015, rev
    [2] => Built using HFST 3.8.3, rev4409
    [3] => nuvvispellet
    [4] => nuvvispiller
)
}}}