Yaziv

Text converter between different writing systems and transliteration schemes. Data for 9 Caucasian languages is currently provided: Abaza, Abkhaz, Aghul, Georgian, Kumyk, Kaitag, Lezgi, Ossetian, and Tsakhur. Contributions welcome!

🚀 Quick Start

npm install
npm run dev

Test your conversions live at yaziv.raxys.app/editor

🔄 How It Works

The system uses a hub-and-spoke model where all conversions flow through a central script.

Example with Abaza:

• Central script: Cyrillic (most complete)
• Conversion: Latin → Cyrillic → IPA
• Any script can convert to any other through the hub

🤝 Contributing Languages

Contributions of new languages and writing systems are welcome! Here's how to add support:

File Structure

app/data/langs/[lang-id]/
├── config.json          # Language configuration
└── mappings/
    ├── script1.json     # Writing system mappings
    └── script2.json

public/flags/[iso-code].png  # Optional PNG flag

Configuration (config.json)

{
  "iso": "xyz",
  "sample": "Sample text in the language",
  "defaultPair": ["script1", "script2"],
  "mappings": ["script1", "script2", "ipa"]
}

Mapping File (mappings/[script].json)

Each mapping file defines a writing system. The id field must match the filename, and all IDs must be listed in the config's mappings array:

{
  "id": "lat", // Filename: lat.json
  "name": { "en": "Latin", "ru": "Латиница" },
  "constraint": ">", // Optional: "<" (output-only) or ">" (input-only)
  "rtl": false, // Optional: true for right-to-left
  "lowercase": false, // Optional: apply lowercase first
  "pairs": [
    ["sch", "щ"], // Longest patterns first!
    ["ch", "ч"], // Critical: Order by length
    ["sh", "ш"], // Digraphs before single chars
    ["c", "ц"], // Single characters last
    ["s", "с"]
  ]
}

Note: All language and mapping names must be provided in both English (en) and Russian (ru).

How order matters:

// ✅ Correct - "sch" matches before "ch"
["sch", "щ"], ["ch", "ч"], ["c", "ц"]

// ❌ Wrong - "c" would match first, breaking "ch" and "sch"
["c", "ц"], ["ch", "ч"], ["sch", "щ"]

One-Directional Constraints

Restrict mappings to one direction using the optional constraint field:

File-Level ("constraint": "<" or ">")

• "<" = output-only (can only convert TO this script, like IPA)
• ">" = input-only (rarely used)

Pair-Level (third array element: "<" or ">")

• ">" = deprecated (accept as input, don't generate: ["к1", "кь", ">"])
• "<" = output-only (rarely used, auto-created when reversing)

Order still matters:

// ✅ Correct - longer deprecated form first
[["къкъ", "ҡҡ", ">"], ["къ", "ҡҡ"]]

// ❌ Wrong - shorter form matches first
[["къ", "ҡҡ"], ["къкъ", "ҡҡ", ">"]]

Language Registry

Add your language to /app/data/langs.json:

{
  "id": "xyz",
  "name": { "en": "Language Name", "ru": "Название языка" }
}

Common Script IDs

• cyr - Cyrillic
• lat - Latin
• lat_[variant] - Latin variants (e.g., lat_chirikba)
• ipa - International Phonetic Alphabet
• translit_[standard] - Transliteration schemes

Testing Your Mappings

Before submitting, test your conversions using the live editor at yaziv.raxys.app/editor:

• Import your JSON mappings directly
• Test bidirectional conversion
• Verify pattern precedence works
• Check edge cases

📜 License

MIT License - feel free to use and modify!