michaskruzelka/lacinka

Belarusian "Lacinka" Converter

Sunday, October 9, 2016
by michaskruzelka
Repository
1 Watchers
0 Stars
14 Installations

PHP
0 Dependents
0 Suggesters
0 Forks
0 Open issues
5 Versions
0 % Grown

The README.md

Belarusian "Lacinka" Converter

The tool provides you with API that enables you to convert from Belarusian Latin script to Belarusian Cyrillic script and backward., _(*1)

Basic usage

Composer

$ composer require michaskruzelka/lacinka

PHP

use Michaskruzelka\Lacinka\Converter;

$converter = new Converter();

Conversion to Belarusian Traditional Latin alphabet:, _(*2)

$text = "
    Лацінка — іміджавая рэч, яна стварае зусім іншае ўражанне ад мовы, нязвыклае, больш еўрапейскае
    — яна злучае нас з блізкімі нам народамі Цэнтральнай і Ўсходняй Еўропы: палякамі, чэхамі, харватамі,
    якім лацінка адкрывае беларускую мову як мову блізкую і зразумелую. Можа і камусь з беларусаў
    яе існаванне можа дадаць цікавасці да беларускай мовы?
";

$convertedText = $converter->convert($text);

To Belarusian Academic (Geographic) Latin alphabet:, _(*3)

$convertedText = $converter->setVersion('geographic')->convert($text);

To Belarusian Cyrillic alphabet:, _(*4)

$text = "
    Łacinka — imidžavaja reč, jana stvaraje zusim inšaje ŭražannie ad movy, niazvykłaje, bolš jeŭrapiejskaje
    — jana złučaje nas z blizkimi nam narodami Centralnaj i Ŭschodniaj Jeŭropy: palakami, čechami, charvatami,
    jakim łacinka adkryvaje biełaruskuju movu jak movu blizkuju i zrazumiełuju. Moža i kamuś z biełarusaŭ
    jaje isnavannie moža dadać cikavasci da biełaruskaj movy?
";

$convertedText = $converter->directToCyrillic()->convert($text);

Advanced questions

The conversion rules are not comprehensive. How can I improve them?, _(*5)

You don't have to modify anything in business logic. Instead, all rules are stored in the /config/rules.xml file where you can add, remove or modify any rule. Your rule should be structured as follows:, _(*6)

<rule name="[rule_name]">
   <sort>[number]</sort>
   <renderer>
       <name>[Some implementation of RendererInterface]</name>
       <search>[Search Pattern, can include <back> or <forth> inheriting nodes]</search>
       <replace>[Replacement, can include <back> or <forth> inheriting nodes]</replace>
   </renderer>
   <directions>
       <back>[true|false][From latin to cyrillic]</back>
       <forth>[true|false][From cyrillic to latin]</forth>
   </directions>
   <versions>
       <[version]>[true|false]</[version]>
       ...
   </versions>
   <orthographies>
       <[orthography]>[true|false]</[orthography]>
       ...
   </orthographies>
   <pairs>
       <pair>
           <cyrillic>[letter|word|etc]</cyrillic>
           <latin>[letter|word|etc]</latin>
           <versions>...</versions>
           <orthographies>...</orthographies>
           <directions>...</directions>
       </pair>
       ...
   </pairs>
</rule>

Moreover, you can apply your own rules in any xml file:, _(*7)

$converter = (new Converter(false))->initRules([path_to_the_xml_file]);

Is it possible to add another version of Belarusian Latin script (for instance, Archaic)?, _(*8)

Yes. Every version of the alphabet must be specified in /config/settings.php file., _(*9)

...
'versions' => [
    'traditional',
    'geographic',
    '[your_version]'
],
...

$converter->setVersion([your_version]);

How to extend functionality of the converter?, _(*10)

You can add new renderers. They must implement 'Michaskruzelka\Lacinka\Renderers\RendererInterface'., _(*11)

library lacinka