cadmium_transliterator

Version, currently master branch1 version
  • master branchlatestJan 9, 2026

github.com/cadmiumcr/transliterator

No description declared in shard.yml.

7 stars
4 dependents
License: MIT

Installation

# Add this to your shard.yml
dependencies:
  cadmium_transliterator:
    github: cadmiumcr/transliterator
    branch: master

master is a branch, not a release, so this tracks it rather than pinning a version.

Then run:

shards install

shard.yml

Crystal
>= 0.34.0, < 2.0.0
License
MIT
Author
Chris Watson

Dependencies

This version declares no dependencies.

README

Transliterator

The Transliterator module provides the ability to transliterate UTF-8 strings into pure ASCII so that they can be safely displayed in URL slugs or file names.

Installation

  1. Add the dependency to your shard.yml:

    dependencies:
      cadmium_transliterator:
        github: cadmiumcr/transliterator
  2. Run shards install

Usage

require "cadmium_transliterator"
transliterator = Cadmium.transliterator

transliterator.transliterate("Привет")
# => "Privet"

transliterator.transliterate("你好朋友")
# => "Ni Hao Peng You"

# With the string extension

"މިއަދަކީ ހދ ރީތި ދވހކވ".transliterate
# => "mi'adhakee hdh reethi dhvhkv"

"こんにちは、友人".transliterate
# => konnichiwa, You Ren

Contributing

  1. Fork it (https://github.com/cadmiumcr/transliterator/fork)
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Add some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create a new Pull Request

Contributors