TransliteratorUkrainian 1.0.1

Ukrainian Transliterator

A C# tool for transliterating Ukrainian Cyrillic text to Latin (and back) following the official CMU Resolution No. 55 rules. Works with Excel files, plain text, and stdin.

Features

• Forward transliteration (Cyrillic → Latin) with position-aware rules
• Reverse transliteration (Latin → Cyrillic)
• Excel processing: reads .xlsx files, outputs .csv with proper escaping (RFC 4180)
• Multi-sheet support: process all sheets or specific ones
• Selective column transliteration: choose which columns to transliterate
• Interactive modes: --text and --stdin for quick transliterations
• Reusable library: TransliteratorUkrainian.Core can be referenced from any .NET project

Project Structure

TransliteratorUkrainian.sln
├── TransliteratorUkrainian.Core/       # Class library (reusable)
├── TransliterateUkrainian/             # Console app (CLI)
└── TransliteratorUkrainian.Tests/      # Unit tests (xUnit)

Requirements

• .NET 9.0 or later

Build & Test

dotnet build
dotnet test

Usage

Quick text transliteration

# Forward (Cyrillic → Latin)
dotnet run -- --text "Шевченко"
# Output: Shevchenko

# Reverse (Latin → Cyrillic)
dotnet run -- --text --reverse "Shevchenko"
# Output: Шевченко

Stdin mode

echo "Юлія" | dotnet run -- --stdin
# Output: Yuliia

echo "Yuliia" | dotnet run -- --stdin --reverse
# Output: Юлія

Excel mode

# Default: reads input.xlsx, writes output.csv
dotnet run

# Custom files
dotnet run -- input.xlsx output.csv

# Process all sheets (outputs output_Sheet1.csv, output_Sheet2.csv, ...)
dotnet run -- input.xlsx output.csv --sheets all

# Process specific sheets
dotnet run -- input.xlsx output.csv --sheets 1,3

# Only transliterate columns 2 and 4 (others pass through unchanged)
dotnet run -- input.xlsx output.csv --columns 2,4

# Reverse transliteration on Excel file
dotnet run -- input.xlsx output.csv --reverse

Library Usage

Reference TransliteratorUkrainian.Core in your project:

using TransliteratorUkrainian.Core;

// Forward
string latin = UkrainianTransliterator.Transliterate("Шевченко");  // "Shevchenko"

// Reverse
string cyrillic = ReverseTransliterator.Transliterate("Shevchenko");  // "Шевченко"

Note: Reverse transliteration is inherently lossy. The letters и, і, ї, й all map to "y" or "i" in Latin depending on position, making perfect reversal impossible without a dictionary. Soft signs (ь) also cannot be recovered.

Transliteration Rules

Position-dependent letters use different forms at word start vs. mid-word:

Special case: зг → zgh (to distinguish from ж → zh).

Example

Input (input.xlsx):

Output (output.csv):

Andrii,Shevchenko

License

This project is open-source and free to use.