PHPackages                             michaskruzelka/lacinka - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. michaskruzelka/lacinka

ActiveLibrary[Utility & Helpers](/categories/utility)

michaskruzelka/lacinka
======================

Belarusian "Lacinka" Converter

1.0.0(9y ago)484MITPHPPHP >=5.5

Since Sep 11Pushed 2y ago1 watchersCompare

[ Source](https://github.com/michaskruzelka/lacinka)[ Packagist](https://packagist.org/packages/michaskruzelka/lacinka)[ RSS](/packages/michaskruzelka-lacinka/feed)WikiDiscussions master Synced 4w ago

READMEChangelog (5)Dependencies (1)Versions (5)Used By (0)

Belarusian "Lacinka" Converter
==============================

[](#belarusian-lacinka-converter)

The tool provides you with API that enables you to convert from Belarusian Latin script to Belarusian Cyrillic script and backward.

Basic usage
-----------

[](#basic-usage)

### Composer

[](#composer)

```
$ composer require michaskruzelka/lacinka
```

### PHP

[](#php)

```
use Michaskruzelka\Lacinka\Converter;

$converter = new Converter();
```

Conversion to Belarusian Traditional Latin alphabet:

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

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

To Belarusian Academic (Geographic) Latin alphabet:

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

To Belarusian Cyrillic alphabet:

```
$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
------------------

[](#advanced-questions)

> The conversion rules are not comprehensive. How can I improve them?

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:

```

   [number]

       [Some implementation of RendererInterface]
       [Search Pattern, can include  or  inheriting nodes]
       [Replacement, can include  or  inheriting nodes]

       [true|false][From latin to cyrillic]
       [true|false][From cyrillic to latin]

       [true|false]
       ...

       [true|false]
       ...

           [letter|word|etc]
           [letter|word|etc]
           ...
           ...
           ...

       ...

```

Moreover, you can apply your own rules in any xml file:

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

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

Yes. Every version of the alphabet must be specified in /config/settings.php file.

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

```
$converter->setVersion([your_version]);
```

> How to extend functionality of the converter?

You can add new renderers. They must implement 'Michaskruzelka\\Lacinka\\Renderers\\RendererInterface'.

Links
-----

[](#links)

- [Belarusian Latin Alphabet (Wikipedia)](https://en.wikipedia.org/wiki/Belarusian_Latin_alphabet)
- [ГІСТОРЫЯ МОВЫ Беларуская лацінка (Мова Нанова)](http://www.movananova.by/zaniatki/gistoryya-movy-belaruskaya-lacinka.html)
- [Лацінка вяртаецца (Наша Ніва)](http://nn.by/?c=ar&i=32647)
- [Як правільна пісаць беларускай лацінкай? (Наша Ніва)](http://nn.by/?c=ar&i=147849)

###  Health Score

29

—

LowBetter than 57% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity16

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity61

Established project with proven stability

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~4 days

Total

4

Last Release

3567d ago

Major Versions

0.1.4 → 1.0.02016-09-23

### Community

Maintainers

![](https://www.gravatar.com/avatar/890003c999f47f496f39b070f5b14b81268c88d47444faceb636096e9e60bdfa?d=identicon)[michaskruzelka](/maintainers/michaskruzelka)

---

Top Contributors

[![proton-neutron](https://avatars.githubusercontent.com/u/12134529?v=4)](https://github.com/proton-neutron "proton-neutron (4 commits)")

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/michaskruzelka-lacinka/health.svg)

```
[![Health](https://phpackages.com/badges/michaskruzelka-lacinka/health.svg)](https://phpackages.com/packages/michaskruzelka-lacinka)
```

###  Alternatives

[mjanssen/laravel-5-breadcrumbs

A simple and powerfull way to create breadcrumbs in Laravel 5+

1546.1k](/packages/mjanssen-laravel-5-breadcrumbs)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)