interscript-maps 2.4.3 → 2.5.0

data/maps/bgnpcgn-pus-Arab-Latn-1968.isc

@@ -0,0 +1,245 @@
+system "BGN-PCGN:pus-Arab:Latn:1968" {
+
+metadata {
+  authority_id bgnpcgn
+  id 1968
+  language iso-639-2:pus
+  source_script Arab
+  destination_script Latn
+  name Romanization of Pashto (1968)
+  url https://assets.publishing.service.gov.uk/government/uploads/system/uploads/attachment_data/file/693760/ROMANIZATION_OF_PASHTO.pdf
+  creation_date 1968
+  confirmation_date 2017-11
+  description {    Pashto is an Indo-Iranian language and is one of two
+    nationally official languages in Afghanistan and one of
+    five regionally recognised languages in Pakistan. The
+    romanization system presented here may be applied to all
+    Pashto geographical names. Although the BGN/PCGN policy for
+    geographical names in Afghanistan is to apply the BGN/PCGN
+    national system of romanization for Afghanistan (2007),
+    which incorporates Dari elements, when applied to a Pashto
+    geographical name, the romanized results of the BGN/PCGN
+    national system for Afghanistan are the same as those of
+    this Pashto romanization system1 . The Pashto alphabet uses
+    a modified form of the Perso-Arabic script, and contains
+    twelve additional consonants not present in standard
+    Arabic, as well as three additional vowel characters and an
+    additional vowel point. ڼ گ ښ ژ ږ ړ ډ ځ څ چ ټ پ :Consonants
+    ٙ :Point Vowel; ې ۍ ى :Vowels The points used in Arabic to
+    mark short vowels and certain other diacritical marks are
+    not written in Pashto. Consequently, a reference source may
+    sometimes be required to aid correct identification of the
+    standard spellings and proper vowels and elimination of
+    dialectal and idiosyncratic variations. In the interests of
+    clarity, a column showing vowel pointing from Arabic to
+    indicate short vowels has been included in the examples
+    below, alongside the unpointed form that will usually be
+    encountered. However it should be noted that the
+    pronunciation of short vowels will vary. (Note: it is
+    recommended that a font such as Scheherazade, available
+    from www.sil.org, which includes the Unicode extended
+    Arabic sub-range, be used to view this system2 .)
+  }
+
+  notes {
+    note "1. Alif ( ‫ا‬ ) should be romanized as follows\n a. Initially,it indicates that the word begins with a vowel or\n diphthong; the alif itself is not romanized, but rather the\n short vowel it “carries” is romanized; e.g., Aslam Zhrandah\n ‫ه‬ َ‫د‬ ‫ن‬ ‫ژر‬ ‫سلَم‬ َ‫أ‬ ‫ميړ‬ → b. When it carries a\n maddah (‫)آ‬ (see vowel table, row 3), it represents ā;\n e.g., Band. Mīṟ ‫د‬ ‫ن‬ ‫ب‬ َ ‫آب‬ → Āb c. Medially and\n finally it represents ā (see table 2, row 2); e.g., ‫ۍ‬\n ‫ماڼ‬ → Māṉêy d. Medially and finally in words of Arabic\n origin, alif may serve as the bearer of hamzah, e.g.\n ‫رأس‬ → ra’s. See also note 4."
+
+    note "2. The characters tsē ( ‫څ‬ ) and dzē ( ‫ځ‬ ) may be\n romanized t͡ s and d͡ z (the combining double breve (\n Unicode 0361) appearing over the digraph) when for special\n reasons it is desired that confusion be avoided between\n ‫ت‬ (t) plus ‫س‬ (s) and between ‫د‬ (d) plus ‫ز‬ (z),\n respectively."
+
+    note "3. Occasionally the character sequences ‫ه‬ ‫ك‬ , ‫ه‬ ‫ز‬ ,\n ‫ه‬ ‫س‬ , and ‫ه‬ ‫گ‬ occur . They may be romanized k·h, z·\n h, s·h, and g·h in order to differentiate these\n romanizations from the digraphs kh, zh, sh, and gh, which\n are used to represent the characters ‫خ‬ , ‫ژ‬, ‫ش‬ , and\n ‫غ‬ respectively ."
+
+    note "4. Hamzah ( ‫ء‬ ) should be romanized as follows a. In\n word-initial position, where it will appear either above or\n below alif ( indicates a short vowel and should not itself\n be romanized. romanized by an apostrophe, e.g. ‫أ‬ or\n ‫إ‬ ), it In other positions it should be ‫جُزء‬ → juz’. b.\n Yeh with hamzah ( ‫ئ‬ ) should be romanized êy, unless it\n represents the compound (iẕāfah) morpheme, in which case it\n is romanized according to note 9 below."
+
+    note "5. The division of words utilized in Pashto writing is\n followed in romanization, except that the elements –ābād, -\n khwā, -shahr, -zādah, -zay and -ullāh are always romanized\n as part of the preceding word, e.g. ‫آباد‬ ‫ت‬ ‫م‬ َ ْ‫ح‬\n ‫ر‬ َ → Raḩmatābād and ‫الله‬ ‫ت‬ ‫م‬ َ ْ‫ح‬ ‫ر‬ َ →\n Raḩmatullāh. However, when the word for God ( ‫الله‬ )\n appears as a standalone word it should be written Allāh.\n Note also the “dagger alif” ( ٙ) above the second ‫ل‬ (lām)\n in the word ‫الله‬ ; this, like the short vowels, is not\n written in Pashto but should be romanized ā, like a full-\n size alif. Persian derivational endings such as –vand and\n endings of Turkish origin such as –lar, -lī, -lū, -i, -u, -\n si, and –su, should be written together with the preceding\n word."
+
+    note "6. The Pashto preposition ‫د‬ should be romanized dê in\n agreement with its pronunciation, despite the fact that\n it is sometimes pointed with kasrah ( ٙ )."
+
+    note "7. In names of Arabic origin, the l of the definite article\n al/ul is assimilated before the ‘sun letters’ t, s̄ , d,\n z̄ , r, z, s, sh, ş, ẕ, ţ, z̧ , l and n. In romanization,\n the article will be written al or its assimilated\n equivalent in name-initial position but ul or its\n assimilated equivalent elsewhere; the article should be\n separated from the name it precedes and should not be\n capitalized, except at the beginning of a name, e.g. جَبَل\n السَرَاج → Jabal us Sarāj"
+
+    note "8. In Arabic names, a shaddah, ٙ is used to denote the\n doubling of a particular consonant character, e.g. ‫مَّد‬\n َ‫ح‬ ‫م‬ ُ → Muḩammad. However, in Pashto this ‘doubling’\n is frequently omitted in both Perso-Arabic script and the\n resulting romanization. Guidance on doubling may be taken\n from an authoritative names source, such as an Afghan\n government source or Pashto dictionary; for example, it is\n usual to see Ḩājī without and ‘Abbās with the doubled\n consonant. The doubled y consonant is almost always\n retained, as in Sayyid or Qayyūm"
+
+    note "9. The iẕāfah morpheme is not a grammatical feature of\n Pashto and, if encountered in a linguistically hybrid\n geographical name (i.e. combining features of both Pashto\n and Dari), it should be treated according to the BGN/PCGN\n national system of romanization for Afghanistan, 2007, as –\n e, unless the preceding word ends with a silent heh (‫)ه‬\n or a vowel when it should be shown – ye, e.g. 10. The\n character sequence ‫خو‬ , ‫صار‬ ‫ح‬ ِ ‫غر‬ → Ghar-e Ḩişār;\n ‫و‬ ‫ن‬ َ ‫ه‬ ٔ ‫لع‬ َ ‫ق‬ َ → when followed by ‫ا‬ or\n ‫ی‬ , Qal‘ah-ye Now."
+
+    note "10. The character sequence خو when followed by ‫ا‬ or\n ‫ی‬ ,should be romanized khw, although the w is either not\n pronounced, or only weakly pronounced; e.g. ‫خواجه‬ →\n khwājah."
+
+    note "11. An inventory of letter-diacritic combinations in addition to the unmodified letters of the\n basic Roman script is\n ‘ (U+2018)\n ʼ (U+2019)\n Ā (U+0100)\n ā (U+0101)\n Á (U+00C1)\n á (U+00E1)\n Ḏ (U+0044+0031)\n ḏ (U+0064+00031)\n Ē (U+0112)\n ē (U+0113)\n Ê (U+00CA)\n ê (U+00EA)\n Ḩ (U+1E28)\n ḩ (U+1E29)\n Ī (U+012A)\n ī (U+012B)\n N̄ (U+004E+0304)\n n̄ (U+004E+0304)\n Ō (U+014C)\n ō (U+014D)\n Ṟ (U+0052+0031)\n ṟ (U+0072+0031)\n Ş (U+015E)\n ş (U+015F)\n S̄ (U+0053+0304)\n s̄ (U+0073+0304)\n Ṯ (U+0054+0031)\n ṯ (U+0074+0031)\n Ţ (U+0162)\n ţ (U+0163)\n Ū (U+016A)\n ū (U+016B)\n Z̧ (U+005A+0327)\n z̧ (U+007A+0327)\n Z̄ (U+005A+0304)\n z̄ (U+007A+0304)\n Ẕ (U+005A+0331)\n ẕ (U+007A+0331)\n Z͟ H (U+005A+0048+035F)\n z͟ h (U+007A+0068+035F)"
+  }
+}
+
+tests {
+   "بَغْلان" ->  "Baghlān"
+   "پُوټَكَى" ->  "Pōṯakay"
+   "شِيرِين تَگَاب" ->  "Shīrīn Tagāb"
+   "کُوْټ" ->  "Kōṯ"
+   "ثَابِر" ->  "S̄ābir"
+   "جَلال آبَاد" ->  "Jalālābād"
+   "چَارِيكَار" ->  "Chārīkār"
+   "ځَدْرَاڼ" ->  "Dzadrāṉ"
+   "څَوکۍ" ->  "Tsowkêy"
+   "حَضْرَتِ إِمَام" ->  "Ḩaẕrat-e Imām"
+   "خُوْسْت" ->  "Khōst"
+   "سْپِين بُوْلْدَک" ->  "Spīn Bōldak"
+   "ډَنْډ وَ پَتَان" ->  "Ḏanḏ Wa Patān"
+   "كَنْدَهَار" ->  "Kandahār"
+   "أَنْدَړ" ->  "Andaṟ"
+   "كُنْدُز" ->  "Kunduz"
+   "مِير أَسْلَم ژْرَنْدَه" ->  "Mīr Aslam Zhrandah"
+   "ږِيرَه" ->  "Z͟hīrah"
+   "سَمَنْگَان" ->  "Samangān"
+   "كښٙتَه كَلا" ->  "Ks͟hêtah Kalā"
+   "قَيْصَار" ->  "Qayşār"
+   "فَيض آبَاد" ->  "Faīẕābād"
+   "حَضْرَتِ سُلْطَان" ->  "Ḩaẕrat-e Sulţān"
+   "ظَاهِر كَلا" ->  "Z̧āhir Kalā"
+   "پُلِ عَلَم" ->  "Pul-e ‘Alam"
+   "غَزْنِي" ->  "Ghaznī"
+   "مَزَارِ شَرِيف" ->  "Mazār-e Sharīf"
+   "قَيْصَار" ->  "Qayşār"
+   "كَنْدَهَار" ->  "Kandahār"
+   "گَرْدېز" ->  "Gardēz"
+   "کَابُل" ->  "Kābul"
+   "مَيمَنَه" ->  "Maīmanah"
+   "خَان آبَاد" ->  "Khānābād"
+   "مَاڼۍ" ->  "Māṉêy"
+   "وَاخَان" ->  "Wākhān"
+   "يَنْگِي قَلعَه" ->  "Yangī Qal‘ah"
+   "جَلال آبَاد" ->  "Jalālābād"
+   "مُرْغَاب کَابُل" ->  "Murghāb Kābul"
+   "گٙردُون" ->  "Gêrdōn"
+   "آب بَنْد" ->  "Āb Band"
+   "سْپِين بُوْلْدَک" ->  "Spīn Bōldak"
+   "جَوزجَان" ->  "Jowzjān"
+   "گَرْدېز" ->  "Gardēz"
+   "مَیدان شَهْر" ->  "Maīdān Shahr"
+   "ډَنْډِ سُفْلىٰ" ->  "Ḏanḏ-e Suflá"
+   "جَبَل السَرَاج" ->  "Jabal us Sarāj"
+}
+
+dependency "bgnpcgn-prs-Arab-Latn-2007" as arablatn
+
+stage main {
+
+  run  map.arablatn.stage.main
+
+  # CHARACTERS
+  parallel {
+
+    sub "\u0650" "i"
+    sub "\u064f" "u"
+
+    sub {
+    from "\u0650" + boundary
+    to "-e"
+  }
+
+    sub {
+    from space + "\u0627\u0644\u0644\u0651\u064e\u0647"
+    to "ullāh"
+  }
+    sub {
+    from space + "\u062E\u0648\u0627"
+    to "khwā"
+  }
+    sub {
+    from space + "\u0634\u064E\u0647\u0631"
+    to "shahr"
+  }
+    sub {
+    from space + "\u0632\u0627\u062F\u0629"
+    to "zādah"
+  }
+    sub {
+    from space + "\u0632\u064E\u064a"
+    to "zay"
+  }
+    sub "\u0652" ""
+    sub "\u0659" "ê"
+
+    # Sun letters
+    sub {
+    from boundary + "\u0627\u0644\u062a" + maybe("\u0651")
+    to "ut t"
+  }
+    sub {
+    from boundary + "\u0627\u0644\u062b" + maybe("\u0651")
+    to "us̄ s̄"
+  }
+    sub {
+    from boundary + "\u0627\u0644\u062f" + maybe("\u0651")
+    to "ud d"
+  }
+    sub {
+    from boundary + "\u0627\u0644\u0630" + maybe("\u0651")
+    to "uz̄ z̄"
+  }
+    sub {
+    from boundary + "\u0627\u0644\u0631" + maybe("\u0651")
+    to "ur r"
+  }
+    sub {
+    from boundary + "\u0627\u0644\u0632" + maybe("\u0651")
+    to "uz z"
+  }
+    sub {
+    from boundary + "\u0627\u0644\u0633" + maybe("\u0651")
+    to "us s"
+  }
+    sub {
+    from boundary + "\u0627\u0644\u0634" + maybe("\u0651")
+    to "ush sh"
+  }
+    sub {
+    from boundary + "\u0627\u0644\u0635" + maybe("\u0651")
+    to "uş ş"
+  }
+    sub {
+    from boundary + "\u0627\u0644\u0636" + maybe("\u0651")
+    to "uẕ ẕ"
+  }
+    sub {
+    from boundary + "\u0627\u0644\u0637" + maybe("\u0651")
+    to "uţ ţ"
+  }
+    sub {
+    from boundary + "\u0627\u0644\u0638" + maybe("\u0651")
+    to "uz̧ z̧"
+  }
+    sub {
+    from boundary + "\u0627\u0644\u0644" + maybe("\u0651")
+    to "ul l"
+  }
+    sub {
+    from boundary + "\u0627\u0644\u0646" + maybe("\u0651")
+    to "un n"
+  }
+
+    sub "\u0626" "êy"
+  }
+
+  # POSTRULES
+  sub {
+    from any("\u0061".."\uFFFF")
+    to upcase
+    before boundary
+    not_before boundary + any("‘’'-")
+  }
+  # don't capitalize defined article in the middle of a sentence
+  sub " Ut T" " ut T"
+  sub " Us̄ S̄" " us̄ S̄"
+  sub " Ud D" " ud D"
+  sub " Uz̄ Z̄" " uz̄ Z̄"
+  sub " Ur R" " ur R"
+  sub " Uz Z" " uz Z"
+  sub " Us S" " us S"
+  sub " As S" " us S"
+  sub " Ush Sh" " ush Sh"
+  sub " Uş Ş" " uş Ş"
+  sub " Uẕ Ẕ" " uẕ Ẕ"
+  sub " Uţ Ţ" " uţ Ţ"
+  sub " Uz̧ Z̧" " uz̧ Z̧"
+  sub " Ul L" " ul L"
+  sub " Un n" " un N"
+
+  compose
+}
+}

data/maps/bgnpcgn-ron-Cyrl-Latn-2002.isc

@@ -0,0 +1,218 @@
+system "BGN-PCGN:ron-Cyrl:Latn:2002" {
+
+metadata {
+  authority_id bgnpcgn
+  id 2002
+  language iso-639-2:ron
+  source_script Cyrl
+  destination_script Latn
+  name Table of Correspondences for Moldovan (Cyrillic-Roman) (2002 Agreement)
+  url https://assets.publishing.service.gov.uk/government/uploads/system/uploads/attachment_data/file/816780/TABLE_OF_CORRESPONDENCES_FOR_MOLDOVAN.pdf
+  creation_date 2002
+  confirmation_date 2019
+  description {    In 1990, the Moldovan authorities adopted the Roman alphabet to replace the existing Cyrillic
+    alphabet. The presentation below provides a table of correspondences between the former Cyrillic alphabet
+    and the current Roman alphabet. When Moldovan Roman-alphabet spellings are not available, this table
+    can be used to convert Moldovan Cyrillic spellings. It should be noted that Moldovan is little used as a
+    language label now, and is usually considered as Romanian.
+  }
+
+  notes {
+    note "      This Roman-script form is used before e, i and iu."
+
+    note "      This Roman-script form is used before a."
+
+    note "      The letter ‘i’ is used to represent Ь at the end of a word."
+
+    note "      An inventory of letter-diacritic combinations, with their Unicode encoding, in addition to the\n      unmodified letters of the basic Roman script is:\n          Ț (U+021A) ț (U+021B)\n          Ș (U+0218) ș (U+0219)\n          Î (U+00CE) î (U+00EE)\n          Ă (U+0102) ă (U+0103)"
+
+    note "      The Roman-script columns show only lowercase forms but, when applying the table, uppercase and\n      lowercase Roman letters as appropriate should be used."
+  }
+}
+
+tests {
+  # https://www.tourister.ru/world/europe/moldova-republic-of/publications/507
+   "Бунэ диминеа'ца!" ->  "Bună diminea'ţa!"
+   "Ну неам вэзут де ун кар де ань!" ->  "Nu neam văzut de un car de ani!" # note[3]
+   "Перми'тецимь сэ вэ салут ын нумеле..." ->  "Permi'teţimi să vă salut în numele..." # note[3]
+   "Сэ фий сэнэтос!" ->  "Să fii sănătos!"
+   "Ку ун груп де туришть" ->  "Cu un grup de turişti" # note[3]
+   "Пе соци'я меа" ->  "Pe soţi'ea mea"
+   "хотелул" ->  "hotelul"
+   "Че са ынтымплат?" ->  "Ce sa întîmplat?"
+   "Драджь" ->  "Dradzhi" # note[3]
+   "Че есте ачаста?" ->  "Ce este aceasta?" # note[1] note[2]
+   "черюрй" ->  "ceriuri" # note[1]
+   "феричире!" ->  "fericire!"
+   "ӂэужык" ->  "giăuzhîc"
+
+   "БУНЭ ДИМИНЕА'ЦА!" ->  "BUNĂ DIMINEA'ŢA!"
+   "НУ НЕАМ ВЭЗУТ ДЕ УН КАР ДЕ АНЬ!" ->  "NU NEAM VĂZUT DE UN CAR DE ANI!" # note[3]
+   "ПЕРМИ'ТЕЦИМЬ СЭ ВЭ САЛУТ ЫН НУМЕЛЕ..." ->  "PERMI'TEŢIMI SĂ VĂ SALUT ÎN NUMELE..." # note[3]
+   "СЭ ФИЙ СЭНЭТОС!" ->  "SĂ FII SĂNĂTOS!"
+   "КУ УН ГРУП ДЕ ТУРИШТЬ" ->  "CU UN GRUP DE TURIŞTI" # note[3]
+   "ПЕ СОЦИ'Я МЕА" ->  "PE SOŢI'EA MEA"
+   "ХОТЕЛУЛ" ->  "HOTELUL"
+   "ЧЕ СА ЫНТЫМПЛАТ?" ->  "CE SA ÎNTÎMPLAT?"
+   "ДРАДЖЬ" ->  "DRADZHI" # note[3]
+   "ЧЕ ЕСТЕ АЧАСТА?" ->  "CE ESTE ACEASTA?" # note[1] note[2]
+   "ЧЕРЮРЙ" ->  "CERIURI" # note[1]
+   "ФЕРИЧИРЕ!" ->  "FERICIRE!"
+   "Ӂэужык" ->  "GIăuzhîc"
+}
+
+stage main {
+
+  # RULES
+  # note[1]
+  sub {
+    from "\u0413"
+    to "Gh"
+    after any("ЕеИиЙйЮю")
+  }
+  sub {
+    from "\u0433"
+    to "gh"
+    after any("ЕеИиЙйЮю")
+  }
+  sub {
+    from "\u04C1"
+    to "Gh"
+    after any("ЕеИиЙйЮю")
+  }
+  sub {
+    from "\u04C1"
+    to "gh"
+    after any("ЕеИиЙйЮю")
+  }
+  sub {
+    from "\u041A"
+    to "Ch"
+    after any("ЕеИиЙйЮю")
+  }
+  sub {
+    from "\u043A"
+    to "ch"
+    after any("ЕеИиЙйЮю")
+  }
+  sub {
+    from "\u0427"
+    to "C"
+    after any("ЕеИиЙйЮю")
+  }
+  sub {
+    from "\u0447"
+    to "c"
+    after any("ЕеИиЙйЮю")
+  }
+
+  # note[2]
+  sub {
+    from "\u04C1"
+    to "Ge"
+    after any("Аа")
+  }
+  sub {
+    from "\u04C1"
+    to "ge"
+    after any("Аа")
+  }
+  sub {
+    from "\u0427"
+    to "CE"
+    after any("А")
+  }
+  sub {
+    from "\u0427"
+    to "Ce"
+    after any("а")
+  }
+  sub {
+    from "\u0447"
+    to "ce"
+    after any("Аа")
+  }
+
+  # note[3]
+  sub {
+    from "\u042C"
+    to "I"
+    after boundary
+  }
+  sub {
+    from "\u044C"
+    to "i"
+    after boundary
+  }
+
+
+  # CHARACTERS
+  parallel {
+    sub "\u0410" "A"
+    sub "\u0411" "B"
+    sub "\u0412" "V"
+    sub "\u0413" "G"
+    sub "\u0414" "D"
+    sub "\u0415" "E"
+    sub "\u0416" "ZH"
+    sub "\u04C1" "GI"
+    sub "\u0417" "Z"
+    sub "\u0418" "I"
+    sub "\u0419" "I"
+    sub "\u041A" "C"
+    sub "\u041B" "L"
+    sub "\u041C" "M"
+    sub "\u041D" "N"
+    sub "\u041E" "O"
+    sub "\u041F" "P"
+    sub "\u0420" "R"
+    sub "\u0421" "S"
+    sub "\u0422" "T"
+    sub "\u0423" "U"
+    sub "\u0424" "F"
+    sub "\u0425" "H"
+    sub "\u0426" "Ţ"
+    sub "\u0427" "CI"
+    sub "\u0428" "Ş"
+    sub "\u042B" "Î"
+    sub "\u042C" "’"
+    sub "\u042D" "Ă"
+    sub "\u042E" "IU"
+    sub "\u042F" "EA"
+
+    sub "\u0430" "a"
+    sub "\u0431" "b"
+    sub "\u0432" "v"
+    sub "\u0433" "g"
+    sub "\u0434" "d"
+    sub "\u0435" "e"
+    sub "\u0436" "zh"
+    sub "\u04C2" "gi"
+    sub "\u0437" "z"
+    sub "\u0438" "i"
+    sub "\u0439" "i"
+    sub "\u043A" "c"
+    sub "\u043B" "l"
+    sub "\u043C" "m"
+    sub "\u043D" "n"
+    sub "\u043E" "o"
+    sub "\u043F" "p"
+    sub "\u0440" "r"
+    sub "\u0441" "s"
+    sub "\u0442" "t"
+    sub "\u0443" "u"
+    sub "\u0444" "f"
+    sub "\u0445" "h"
+    sub "\u0446" "ţ"
+    sub "\u0447" "ci"
+    sub "\u0448" "ş"
+    sub "\u044B" "î"
+    sub "\u044C" "’"
+    sub "\u044D" "ă"
+    sub "\u044E" "iu"
+    sub "\u044F" "ea"
+  }
+
+}
+
+}

data/maps/bgnpcgn-rue-Cyrl-Latn-2016.isc

@@ -0,0 +1,130 @@
+system "BGN-PCGN:rue-Cyrl:Latn:2016" {
+
+metadata {
+  authority_id bgnpcgn
+  id 2016
+  language iso-639-3:rue
+  source_script Cyrl
+  destination_script Latn
+  name Romanization of Rusyn (2016)
+  url https://geonames.nga.mil/gns/html/Romanization/ROMANIZATION%20OF%20RUSYN.pdf
+  creation_date 2016
+  confirmation_date 2017
+  description {    The BGN/PCGN system for Rusyn was designed for use in romanizing names written in the Rusyn
+    alphabet. There are two primary dialects of the Rusyn language: Carpatho‐Rusyn and Pannonian Rusyn.
+    The Rusyn alphabet is almost identical to the Ukrainian alphabet, but contains three characters not
+    present in the Ukrainian alphabet: ё, ы, and ъ. These letters are also absent from the alphabet used by
+    Pannonian Rusyn. This table applies to both dialects of Rusyn.
+  }
+
+  notes {
+    note "      The letters ё, ы, and ъ are present in the orthography of the Carpatho‐Rusyn variant of the Rusyn\n      language. This variant is predominant among Rusyn speakers in Ukraine, Poland, Slovakia, Hungary, and\n      Romania. The letters are absent from the orthography of Pannonian Rusyn, which is predominant in\n      Serbia and Croatia."
+
+    note "      Unicode for Latin‐script characters: Ž/ž (017D, 017E); Č/č (010C, 010D); Š/š (0160, 0161); ’ (0027)."
+
+    note "      The Romanization columns show only lowercase forms but, when romanizing, uppercase and\n      lowercase Roman letters as appropriate should be used."
+  }
+}
+
+tests {
+  # Based on https://ru.wikipedia.org/wiki/Русинский_язык#Примеры_текста
+   "русиньскый язык" ->  "rusyn'skyj yazyk"
+   "руська бисіда" ->  "rus'ka bysida"
+   "руснацькый язык" ->  "rusnac'kyj yazyk"
+   "руски язик" ->  "rusky yazyk"
+   "Чоловік найчастїше споминать на молоды часы. Є то цалком нормалне.\nТадь то рокы, кідь зазнаме всякого. І доброго, і планого. В тім часї ся чоловік находить, як кібы в скаралущі.\nРозвивать ся, як цвіт на черешни. Выпхати ся мож з того обалу лем тогды, як прийде час, кідь цалком дозріє.\nДаколи стачіть ся неограбаным способом дотулити білого домику, такой ся пораниш, што ті буде тякнути на цілый жывот.\nА кідь ся народиш в теплї, обколесеный ласков, розвиваш ся в добрых условіях, выпадеш із скаралущі, як міцна істота.\nТакым потім буде і твій далшый жывот. Із добрї заложеным фундаментом. Было бы смішно сі робити надїй, же жывот є лем єдна рівна путь…\nКібы то так чоловік знав… Кібы ся міг іщі раз народити і піти по тій істій пути…" ->  "Čolovik najčastjiše spomynat' na molody časy. Je to calkom normalne.\nTad' to roky, kid' zazname vsyakogo. I dobrogo, i planogo. V tim časji sya čolovik nachodyt', yak kiby v skaralušči.\nRozvyvat' sya, yak cvit na čerešny. Vypchaty sya mož z togo obalu lem togdy, yak pryjde čas, kid' calkom dozrije.\nDakoly stačit' sya neograbanym sposobom dotulyty bilogo domyku, takoj sya poranyš, što ti bude tyaknuty na cilyj žyvot.\nA kid' sya narodyš v teplji, obkolesenyj laskov, rozvyvaš sya v dobrych usloviyach, vypadeš iz skaralušči, yak micna istota.\nTakym potim bude i tvij dalšyj žyvot. Iz dobrji založenym fundamentom. Bylo by smišno si robyty nadjij, že žyvot je lem jedna rivna put'…\nKiby to tak čolovik znav… Kiby sya mig išči raz narodyty i pity po tij istij puty…"
+  # Based on http://www.philology.ru/linguistics3/suprun-89.htm
+   "Вишло слунко красне, ясне,\nи цму швета розогнало -\nжем желену, били хмарки\nяк зоз златом да обцагло." ->  "Vyšlo slunko krasne, yasne,\ny cmu šveta rozognalo -\nžem želenu, byly chmarky\nyak zoz zlatom da obcaglo."
+   "шнїг" ->  "šnjig"
+   "жем" ->  "žem"
+   "дзень" ->  "dzen'"
+   "спомнуц" ->  "spomnuc"
+   "крава" ->  "krava"
+  # Based on https://lingvoforum.net/index.php?topic=43545.0
+   "дївка" ->  "djivka"
+   "дрыв" ->  "dryv"
+   "фёрд" ->  "fjord"
+   "Ёзеф" ->  "Jozef"
+   "пастырї" ->  "pastyrji"
+}
+
+stage main {
+
+  # CHARACTERS
+  parallel {
+    sub "А" "A"
+    sub "Б" "B"
+    sub "В" "V"
+    sub "Г" "H"
+    sub "Д" "D"
+    sub "Е" "E"
+    sub "Є" "Je"
+    sub "Ё" "Jo"
+    sub "Ж" "Ž"
+    sub "З" "Z"
+    sub "И" "Y"
+    sub "І" "I"
+    sub "Ы" "Y"
+    sub "Ї" "Ji"
+    sub "Й" "J"
+    sub "К" "K"
+    sub "Л" "L"
+    sub "М" "M"
+    sub "Н" "N"
+    sub "О" "O"
+    sub "П" "P"
+    sub "Р" "R"
+    sub "С" "S"
+    sub "Т" "T"
+    sub "У" "U"
+    sub "Ф" "F"
+    sub "Х" "Ch"
+    sub "Ц" "C"
+    sub "Ч" "Č"
+    sub "Ш" "Š"
+    sub "Щ" "ŠČ"
+    sub "Ю" "Yu"
+    sub "Я" "Ya"
+    sub "Ь" "'"
+    sub "Ъ" "'"
+
+    sub "а" "a"
+    sub "б" "b"
+    sub "в" "v"
+    sub "г" "g"
+    sub "д" "d"
+    sub "е" "e"
+    sub "є" "je"
+    sub "ё" "jo"
+    sub "ж" "ž"
+    sub "з" "z"
+    sub "и" "y"
+    sub "і" "i"
+    sub "ы" "y"
+    sub "ї" "ji"
+    sub "й" "j"
+    sub "к" "k"
+    sub "л" "l"
+    sub "м" "m"
+    sub "н" "n"
+    sub "о" "o"
+    sub "п" "p"
+    sub "р" "r"
+    sub "с" "s"
+    sub "т" "t"
+    sub "у" "u"
+    sub "ф" "f"
+    sub "х" "ch"
+    sub "ц" "c"
+    sub "ч" "č"
+    sub "ш" "š"
+    sub "щ" "šč"
+    sub "ю" "yu"
+    sub "я" "ya"
+    sub "ь" "'"
+    sub "ъ" "'"
+  }
+
+}
+
+}