Dakov.Transliterator 1.3.1

Dakov.Transliterator

A lightweight and extensible .NET library for bidirectional transliteration between Cyrillic and Latin alphabets. Supports Bulgarian and Macedonian rule sets, basic character mapping, and customizable overrides via configuration.

If this library saved you time or proved useful, feel free to share it with your friends or colleagues.
And if you'd like to support the project—you can always buy me a beer! 🙂

A small thank you

I truly appreciate every bit of support If you choose to donate, I’d be happy to feature your name, project, or anything you'd like to share in the Friends and Supporters section.

I’m also open to simple ad or link exchanges

Donation options

The following wallets are supported via Bitfinex.
Please make sure to check the latest details before sending a transaction.

• Bitcoin (BTC)
  Address - 3FqXqTzGhzxosERosz832F7rGDXMteMjRh

• Ethereum (ETH) At this time Bitfinex does not accept transactions sent from smart contracts.
  Address - 0x818E07acD7d75d1812B2E7067e417C5Bc80d327E

• XRP (XRP) Sending XRP requires both an address and a Tag
  Address - rLW9gnQo7BQhU6igk5keqYnH3TVrCxGRzm
  Tag - 2345006832

• Dogecoin (DOGE)
  Address - DNXrvtmrSWVyBKfmPizXQsreqLSRJQpqCv

• Bitcoin Cash Node (BCHN) Depositing anything other than BCH Node WILL RESULT IN LOSS OF FUNDS. Bitfinex currently is not supporting automated chain splits.
  Address - bitcoincash:qz4tu69cn50gryhdahemytrszdtnn9vwtqexclhleq

• Litecoin (LTC)
  Address - MD7ngCjhUbLNZfnvLdXkVu1LUkXwZMTHmF

• Monero (XMR)
  Address - 86GNkvtYzbEZwq5MxpVvzP7kZ2tUgea5SKy8FTJ4S48fY8hz3DYBPWwJsLNz2woi7dQi34TYkcPDpZKh7iZLaaMLGHrSTwZ

Note: Please check the transaction fees before sending, as they can sometimes be quite high.

Installation

Its can be installed and use via NuGet:

Package Manager

Install-Package Dakov.Transliterator

.NET CLI

dotnet add package Dakov.Transliterator

How to use it

We should include the library after the installation.

using Dakov.Transliterator;

Code snippets show how to call the methods.

var cyrillicText = "Съученичките Мария и Дияна скачаха с бънджи.";

var options1 = new TransliterationOption
{
    TransliterationRuleset = TransliterationRuleset.Basic,
    UrlCompatibility = false,
    WordSeparator = '-',
};

// If we miss the TransliterationOption param we will use the basic values.
// We can see it in the example above "option1".
var latinText0 = Transliterator.CyrillicToLatin(cyrillicText);
// The result is : Sauchenichkite Mariya i Diyana skachaha s bandzhi.

var latinText1 = Transliterator.CyrillicToLatin(cyrillicText, options1);
// The result is : Sauchenichkite Mariya i Diyana skachaha s bandzhi.

var options2 = new TransliterationOption
{
    TransliterationRuleset = TransliterationRuleset.Bulgarian,
};

var latinText2 = Transliterator.CyrillicToLatin(cyrillicText, options2);
// The result is : Sauchenichkite Maria i Diyana skachaha s bandzhi.
// One of the differences between the Basic and Bulgarian rule set you can see in the name "Мария".
// According to the Article 5(2) of the Transliteration Law.

var options3 = new TransliterationOption
{
    TransliterationRuleset = TransliterationRuleset.Bulgarian,
    UrlCompatibility = true,
};

var latinText3 = Transliterator.CyrillicToLatin(cyrillicText, options3);
// The result is : sauchenichkite-maria-i-diyana-skachaha-s-bandzhi

var options4 = new TransliterationOption
{
    TransliterationRuleset = TransliterationRuleset.Bulgarian,
    UrlCompatibility = true,
    WordSeparator = '_',
};

var latinText4 = Transliterator.CyrillicToLatin(cyrillicText, options4);
// The result is : sauchenichkite_maria_i_diyana_skachaha_s_bandzhi

// Macedonian example
var macedonianText = "Скопје е главен град.";
var macedonianOptions = new TransliterationOption
{
    TransliterationRuleset = TransliterationRuleset.Macedonian,
};

var macedonianLatin = Transliterator.CyrillicToLatin(macedonianText, macedonianOptions);
// The result is : Skopje e glaven grad.

var listOfCyrillicTexts = new List<string>()
{
    "Съученичките Мария и Дияна скачаха с бънджи.",
    "Полета от високо е опасен и вдига адреналина.",
    "На следващият ден двете момичета разказаха на приятелите си."
};

var listOfCyrillicTexts0 = Transliterator.CyrillicToLatin(listOfCyrillicTexts);
// The result is :
// - Sauchenichkite Mariya i Diyana skachaha s bandzhi.
// - Poleta ot visoko e opasen i vdiga adrenalina.
// - Na sledvashtiyat den dvete momicheta razkazaha na priyatelite si.

var listOfCyrillicTexts1 = Transliterator.CyrillicToLatin(listOfCyrillicTexts, options1);

var latinText = "Sauchenichkite Mariya i Diyana skachaha s bandzhi.";
var cyrillicText = Transliterator.LatinToCyrillic(latinText);
// The result is : Саученичките Мария и Дияна скачаха с банджи.
// But in transliteration via Basic ruleset from Latin to Cyrillic have small percentage inaccuracies.

Transliteration law

Basic character pairs

Bulgarian ruleset

The full text on Transliteration Law you can read here (on Bulgarian).

Macedonian ruleset

Official orthography (pages 169–170):
https://www.pollitecon.com/Assets/Ebooks/Pravopis-na-Makedonskiot-Jazik.pdf |

Friends and Supporters

Waiting for the first friends! 😃

To-Do List

• Acception generic objects as parameters in transliteration methods.
• Extending exception support.
• Adding specific rules for other languages.

Author

Petar Dakov

• LinkedIn
• Personal Website

License