Serbo-Croatian* (`apertium-hbs`)
===============================================================================

This is an Apertium monolingual language package for Serbo-Croatian. What
you can use this language package for:

* Morphological analysis of Serbo-Croatian
* Morphological generation of Serbo-Croatian
* Part-of-speech tagging of Serbo-Croatian

Note: By Serbo-Croatian we mean Bosnian, Croatian and Serbian. The analyser 
supports both Ijekavian and Ekavian for analysis and generation.

Requirements
===============================================================================

You will need the following software installed:

* lttoolbox (>= 3.3.0)
* apertium (>= 3.3.0)
* vislcg3 (>= 0.9.9.10297)

If this does not make any sense, we recommend you look at: www.apertium.org

Compiling
===============================================================================

Given the requirements being installed, you should be able to just run:

```
$ ./configure
$ make
```

You can use `./autogen.sh` instead of `./configure` if you're compiling
from GitHub.

If you're doing development, you don't have to install the data, you
can use it directly from this directory.

If you are installing this language package as a prerequisite for an
Apertium translation pair, then do (typically as root / with sudo):

```
# make install
```

You can give a `--prefix` to `./configure` to install as a non-root user,
but make sure to use the same prefix when installing the translation
pair and any other language packages.

Testing
===============================================================================

If you are in the source directory after running make, the following
commands should work:

```
$ echo "Otišla si bez pozdrava" | apertium -d . hbs-morph
^Otišla/otići<vblex><perf><iv><lp><nt><pl>/otići<vblex><perf><iv><lp><f><sg>$ 
^si/biti<vbser><clt><pres><p2><sg>/sebe<prn><ref><clt><pers><mfn><sp><dat>$ 
^bez/bez<pr><gen>$ ^pozdrava/pozdrav<n><mi><sg><gen>/pozdrav<n><mi><pl><gen>$
^./.<sent>$
```

```
$ echo "Otišla si bez pozdrava" | apertium -d . hbs-supernew-cg-tagger
^otići<vblex><perf><iv><lp><f><sg>$ ^biti<vbser><clt><pres><p2><sg>$ 
^bez<pr><gen>$ ^pozdrav<n><mi><sg><gen>$^.<sent>$
```

Files and data
===============================================================================

* `apertium-hbs.hbs.metadix`        - Monolingual dictionary
* `hbs.prob`                        - Tagger model
* `apertium-hbs.hbs.rlx`            - Constraint Grammar disambiguation rules
* `apertium-hbs.post-hbs.dix`       - Post-generator
* `modes.xml`                       - Translation modes

For more information
===============================================================================

* http://wiki.apertium.org/wiki/Installation
* http://wiki.apertium.org/wiki/apertium-hbs
* http://wiki.apertium.org/wiki/Using_an_lttoolbox_dictionary

Help and support
===============================================================================

If you need help using this language pair or data, you can contact:

* Mailing list: apertium-stuff@lists.sourceforge.net
* IRC: `#apertium` on `irc.freenode.net`

See also the file AUTHORS included in this distribution.

