Module: Philiprehberger::Slug::Transliterator

Defined in:
lib/philiprehberger/slug/transliterator.rb

Overview

Unicode to ASCII character transliteration

Constant Summary collapse

MAPPING = 
{
  # Latin diacritics
  'À' => 'A', 'Á' => 'A', 'Â' => 'A', 'Ã' => 'A', 'Ä' => 'A', 'Å' => 'A',
  'à' => 'a', 'á' => 'a', 'â' => 'a', 'ã' => 'a', 'ä' => 'a', 'å' => 'a',
  'È' => 'E', 'É' => 'E', 'Ê' => 'E', 'Ë' => 'E',
  'è' => 'e', 'é' => 'e', 'ê' => 'e', 'ë' => 'e',
  'Ì' => 'I', 'Í' => 'I', 'Î' => 'I', 'Ï' => 'I',
  'ì' => 'i', 'í' => 'i', 'î' => 'i', 'ï' => 'i',
  'Ò' => 'O', 'Ó' => 'O', 'Ô' => 'O', 'Õ' => 'O', 'Ö' => 'O', 'Ø' => 'O',
  'ò' => 'o', 'ó' => 'o', 'ô' => 'o', 'õ' => 'o', 'ö' => 'o', 'ø' => 'o',
  'Ù' => 'U', 'Ú' => 'U', 'Û' => 'U', 'Ü' => 'U',
  'ù' => 'u', 'ú' => 'u', 'û' => 'u', 'ü' => 'u',
  'Ñ' => 'N', 'ñ' => 'n', 'Ý' => 'Y', 'ý' => 'y', 'ÿ' => 'y',
  'Ç' => 'C', 'ç' => 'c', 'Đ' => 'D', 'đ' => 'd',
  'ß' => 'ss', 'Æ' => 'AE', 'æ' => 'ae', 'Œ' => 'OE', 'œ' => 'oe',
  'Ş' => 'S', 'ş' => 's', 'Ğ' => 'G', 'ğ' => 'g', 'İ' => 'I', 'ı' => 'i',
  'Ž' => 'Z', 'ž' => 'z', 'Č' => 'C', 'č' => 'c', 'Š' => 'S', 'š' => 's',
  'Ř' => 'R', 'ř' => 'r', 'Ď' => 'D', 'ď' => 'd', 'Ť' => 'T', 'ť' => 't',
  'Ň' => 'N', 'ň' => 'n', 'Ě' => 'E', 'ě' => 'e', 'Ů' => 'U', 'ů' => 'u',
  'Ł' => 'L', 'ł' => 'l', 'Ą' => 'A', 'ą' => 'a', 'Ę' => 'E', 'ę' => 'e',
  'Ś' => 'S', 'ś' => 's', 'Ź' => 'Z', 'ź' => 'z', 'Ż' => 'Z', 'ż' => 'z',
  'Ć' => 'C', 'ć' => 'c', 'Ń' => 'N', 'ń' => 'n',
  # Cyrillic
  'А' => 'A', 'Б' => 'B', 'В' => 'V', 'Г' => 'G', 'Д' => 'D', 'Е' => 'E',
  'Ё' => 'Yo', 'Ж' => 'Zh', 'З' => 'Z', 'И' => 'I', 'Й' => 'Y', 'К' => 'K',
  'Л' => 'L', 'М' => 'M', 'Н' => 'N', 'О' => 'O', 'П' => 'P', 'Р' => 'R',
  'С' => 'S', 'Т' => 'T', 'У' => 'U', 'Ф' => 'F', 'Х' => 'Kh', 'Ц' => 'Ts',
  'Ч' => 'Ch', 'Ш' => 'Sh', 'Щ' => 'Shch', 'Ъ' => '', 'Ы' => 'Y', 'Ь' => '',
  'Э' => 'E', 'Ю' => 'Yu', 'Я' => 'Ya',
  'а' => 'a', 'б' => 'b', 'в' => 'v', 'г' => 'g', 'д' => 'd', 'е' => 'e',
  'ё' => 'yo', 'ж' => 'zh', 'з' => 'z', 'и' => 'i', 'й' => 'y', 'к' => 'k',
  'л' => 'l', 'м' => 'm', 'н' => 'n', 'о' => 'o', 'п' => 'p', 'р' => 'r',
  'с' => 's', 'т' => 't', 'у' => 'u', 'ф' => 'f', 'х' => 'kh', 'ц' => 'ts',
  'ч' => 'ch', 'ш' => 'sh', 'щ' => 'shch', 'ъ' => '', 'ы' => 'y', 'ь' => '',
  'э' => 'e', 'ю' => 'yu', 'я' => 'ya',
  # Greek
  'Α' => 'A', 'Β' => 'B', 'Γ' => 'G', 'Δ' => 'D', 'Ε' => 'E', 'Ζ' => 'Z',
  'Η' => 'I', 'Θ' => 'Th', 'Ι' => 'I', 'Κ' => 'K', 'Λ' => 'L', 'Μ' => 'M',
  'Ν' => 'N', 'Ξ' => 'X', 'Ο' => 'O', 'Π' => 'P', 'Ρ' => 'R', 'Σ' => 'S',
  'Τ' => 'T', 'Υ' => 'Y', 'Φ' => 'F', 'Χ' => 'Ch', 'Ψ' => 'Ps', 'Ω' => 'O',
  'α' => 'a', 'β' => 'b', 'γ' => 'g', 'δ' => 'd', 'ε' => 'e', 'ζ' => 'z',
  'η' => 'i', 'θ' => 'th', 'ι' => 'i', 'κ' => 'k', 'λ' => 'l', 'μ' => 'm',
  'ν' => 'n', 'ξ' => 'x', 'ο' => 'o', 'π' => 'p', 'ρ' => 'r', 'σ' => 's',
  'τ' => 't', 'υ' => 'y', 'φ' => 'f', 'χ' => 'ch', 'ψ' => 'ps', 'ω' => 'o',
  'ς' => 's',
  # Greek accented vowels
  'ά' => 'a', 'έ' => 'e', 'ή' => 'i', 'ί' => 'i', 'ό' => 'o', 'ύ' => 'y', 'ώ' => 'o',
  'Ά' => 'A', 'Έ' => 'E', 'Ή' => 'I', 'Ί' => 'I', 'Ό' => 'O', 'Ύ' => 'Y', 'Ώ' => 'O',
  'ϊ' => 'i', 'ϋ' => 'y', 'ΐ' => 'i', 'ΰ' => 'y'
}.freeze
MAPPING_REGEX = 
Regexp.union(MAPPING.keys).freeze

Class Method Summary collapse

Class Method Details

.call(string, custom_mapping: nil) ⇒ String

Transliterate Unicode characters to ASCII equivalents

Parameters:

  • string (String) —

    input string

  • custom_mapping (Hash, nil) (defaults to: nil) —

    custom character replacements

Returns:

  • (String) —

    transliterated string



65
66
67
68
69
70
71
72
73
 
# File 'lib/philiprehberger/slug/transliterator.rb', line 65

def self.call(string, custom_mapping: nil)
  if custom_mapping
    merged = MAPPING.merge(custom_mapping)
    regex = Regexp.union(merged.keys)
    string.gsub(regex) { |match| merged[match] }
  else
    string.gsub(MAPPING_REGEX) { |match| MAPPING[match] }
  end
end