interscript 0.1.5 → 2.1.0a8

data/lib/interscript/version.rb

@@ -1,3 +1,3 @@
 module Interscript
-  VERSION = "0.1.5"
+  VERSION = "2.1.0a8"
 end

data/requirements.txt

@@ -0,0 +1 @@
+torch

metadata

@@ -1,12 +1,12 @@
 --- !ruby/object:Gem::Specification
 name: interscript
 version: !ruby/object:Gem::Version
-  version: 0.1.5
+  version: 2.1.0a8
 platform: ruby
 authors:
-- project_contibutors
+- Ribose Inc.
 autorequire: 
-bindir: bin
+bindir: exe
 cert_chain: []
 date: 2019-11-17 00:00:00.000000000 Z
 dependencies:
@@ -25,167 +25,13 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
-  name: debase
+  name: interscript-maps
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-- !ruby/object:Gem::Dependency
-  name: pry
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-- !ruby/object:Gem::Dependency
-  name: pycall
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-- !ruby/object:Gem::Dependency
-  name: rambling-trie
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-- !ruby/object:Gem::Dependency
-  name: rake
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-- !ruby/object:Gem::Dependency
-  name: rspec
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-- !ruby/object:Gem::Dependency
-  name: ruby-debug-ide
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-- !ruby/object:Gem::Dependency
-  name: rambling-trie-opal
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-- !ruby/object:Gem::Dependency
-  name: opal
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: 1.0.3
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: 1.0.3
-- !ruby/object:Gem::Dependency
-  name: guard
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-- !ruby/object:Gem::Dependency
-  name: guard-rake
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-- !ruby/object:Gem::Dependency
-  name: closure-compiler
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-  type: :development
+  type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
@@ -193,161 +39,80 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
 description: Interoperable script conversion systems
-email: 
+email:
+- open.source@ribose.com
 executables:
 - interscript
-- rspec
-- setup
 extensions: []
 extra_rdoc_files: []
 files:
-- README.adoc
+- ".gitignore"
+- ".rspec"
+- Gemfile
+- LICENSE.adoc
+- README.md
+- Rakefile
+- bin/console
 - bin/interscript
-- bin/rspec
+- bin/maps_analyze_staging
+- bin/maps_debug_compilers
+- bin/maps_debug_ordering
+- bin/maps_debug_ruby_compile
+- bin/maps_debug_step_by_step
+- bin/maps_optimize_order
+- bin/maps_v1_analyze_regexps
+- bin/maps_v1_to_v2
 - bin/setup
-- lib/__pycache__/g2pwrapper.cpython-38.pyc
-- lib/g2pwrapper.py
-- lib/interscript-opal.rb
+- exe/interscript
+- interscript.gemspec
 - lib/interscript.rb
 - lib/interscript/command.rb
-- lib/interscript/fs.rb
-- lib/interscript/mapping.rb
-- lib/interscript/opal.rb
-- lib/interscript/opal/maps.js.erb
-- lib/interscript/opal_map_translate.rb
+- lib/interscript/compiler.rb
+- lib/interscript/compiler/javascript.rb
+- lib/interscript/compiler/ruby.rb
+- lib/interscript/dsl.rb
+- lib/interscript/dsl/aliases.rb
+- lib/interscript/dsl/document.rb
+- lib/interscript/dsl/group.rb
+- lib/interscript/dsl/group/parallel.rb
+- lib/interscript/dsl/items.rb
+- lib/interscript/dsl/metadata.rb
+- lib/interscript/dsl/stage.rb
+- lib/interscript/dsl/symbol_mm.rb
+- lib/interscript/dsl/tests.rb
+- lib/interscript/interpreter.rb
+- lib/interscript/node.rb
+- lib/interscript/node/alias_def.rb
+- lib/interscript/node/dependency.rb
+- lib/interscript/node/document.rb
+- lib/interscript/node/group.rb
+- lib/interscript/node/group/parallel.rb
+- lib/interscript/node/group/sequential.rb
+- lib/interscript/node/item.rb
+- lib/interscript/node/item/alias.rb
+- lib/interscript/node/item/any.rb
+- lib/interscript/node/item/capture.rb
+- lib/interscript/node/item/group.rb
+- lib/interscript/node/item/repeat.rb
+- lib/interscript/node/item/stage.rb
+- lib/interscript/node/item/string.rb
+- lib/interscript/node/metadata.rb
+- lib/interscript/node/rule.rb
+- lib/interscript/node/rule/funcall.rb
+- lib/interscript/node/rule/run.rb
+- lib/interscript/node/rule/sub.rb
+- lib/interscript/node/stage.rb
+- lib/interscript/node/tests.rb
+- lib/interscript/stdlib.rb
+- lib/interscript/utils/regexp_converter.rb
 - lib/interscript/version.rb
-- lib/model-7
-- lib/tha-pt-b-7
-- maps/acadsin-zho-Hani-Latn-2002.yaml
-- maps/alalc-aze-Cyrl-Latn-1997.yaml
-- maps/alalc-bel-cyrl-latn-1997.yaml
-- maps/alalc-ben-Beng-Latn-2017.yaml
-- maps/alalc-bul-Cyrl-Latn-1997.yaml
-- maps/alalc-ell-Grek-Latn-1997.yaml
-- maps/alalc-ell-Grek-Latn-2010.yaml
-- maps/alalc-kat-Geok-Latn-1997.yaml
-- maps/alalc-kat-Geor-Latn-1997.yaml
-- maps/alalc-kor-Hang-Latn-1997.yaml
-- maps/alalc-mkd-Cyrl-Latn-2013.yaml
-- maps/alalc-mkd-cyrl-latn-1997.yaml
-- maps/alalc-rus-Cyrl-Latn-1997.yaml
-- maps/alalc-rus-Cyrl-Latn-2012.yaml
-- maps/alalc-srp-Cyrl-Latn-1997.yaml
-- maps/alalc-srp-cyrl-latn-2013.yaml
-- maps/alalc-ukr-Cyrl-Latn-1997.yaml
-- maps/alalc-ukr-Cyrl-Latn-2011.yaml
-- maps/apcbg-bul-Cyrl-Latn-1995.yaml
-- maps/bas-rus-Cyrl-Latn-2017-bss.yaml
-- maps/bas-rus-Cyrl-Latn-2017-oss.yaml
-- maps/bgn-jpn-Hrkt-Latn-1962.yaml
-- maps/bgn-kor-Hang-Latn-1943.yaml
-- maps/bgn-kor-Kore-Latn-1943.yaml
-- maps/bgna-bul-Cyrl-Latn-2006.yaml
-- maps/bgna-bul-Cyrl-Latn-2009.yaml
-- maps/bgnpcgn-arm-Armn-Latn-1981.yaml
-- maps/bgnpcgn-aze-Cyrl-Latn-1993.yaml
-- maps/bgnpcgn-bak-Cyrl-Latn-2007.yaml
-- maps/bgnpcgn-bel-cyrl-latn-1979.yaml
-- maps/bgnpcgn-bul-Cyrl-Latn-1952.yaml
-- maps/bgnpcgn-bul-Cyrl-Latn-2013.yaml
-- maps/bgnpcgn-ell-Grek-Latn-1962.yaml
-- maps/bgnpcgn-ell-Grek-Latn-1996.yaml
-- maps/bgnpcgn-jpn-Hrkt-Latn-1976.yaml
-- maps/bgnpcgn-kat-Geor-Latn-1981.yaml
-- maps/bgnpcgn-kat-Geor-Latn-2009.yaml
-- maps/bgnpcgn-kor-Hang-Latn-kn-1945.yaml
-- maps/bgnpcgn-kor-Hang-Latn-rok-2011.yaml
-- maps/bgnpcgn-kor-Kore-Latn-rok-2011.yaml
-- maps/bgnpcgn-mkd-Cyrl-Latn-1981.yaml
-- maps/bgnpcgn-mkd-Cyrl-Latn-2013.yaml
-- maps/bgnpcgn-per-Arab-Latn-1956.yaml
-- maps/bgnpcgn-rus-Cyrl-Latn-1947.yaml
-- maps/bgnpcgn-srp-Cyrl-Latn-2005.yaml
-- maps/bgnpcgn-ukr-Cyrl-Latn-1965.yaml
-- maps/bgnpcgn-ukr-Cyrl-Latn-2019.yaml
-- maps/bgnpcgn-zho-Hans-Latn-1979.yaml
-- maps/by-bel-Cyrl-Latn-1998.yaml
-- maps/by-bel-Cyrl-Latn-2007.yaml
-- maps/elot-ell-Grek-Latn-743-1982-tl.yaml
-- maps/elot-ell-Grek-Latn-743-1982-ts.yaml
-- maps/elot-ell-Grek-Latn-743-2001-tl.yaml
-- maps/elot-ell-Grek-Latn-743-2001-ts.yaml
-- maps/ggg-kat-Geor-Latn-2002.yaml
-- maps/gki-bel-cyrl-latn-1992.yaml
-- maps/gki-bel-cyrl-latn-2000.yaml
-- maps/gost-rus-cyrl-latn-16876-71-1983.yaml
-- maps/hk-yue-Hani-Latn-1888.yaml
-- maps/icao-bel-Cyrl-Latn-9303.yaml
-- maps/icao-bul-Cyrl-Latn-9303.yaml
-- maps/icao-heb-Hebr-Latn-9303.yaml
-- maps/icao-mkd-Cyrl-Latn-9303.yaml
-- maps/icao-per-Arab-Latn-9303.yaml
-- maps/icao-rus-Cyrl-Latn-9303.yaml
-- maps/icao-srp-Cyrl-Latn-9303.yaml
-- maps/icao-ukr-Cyrl-Latn-9303.yaml
-- maps/iso-ell-Grek-Latn-843-1997-t1.yaml
-- maps/iso-ell-Grek-Latn-843-1997-t2.yaml
-- maps/iso-jpn-Hrkt-Latn-3602-1989.yaml
-- maps/iso-rus-Cyrl-Latn-9-1995.yaml
-- maps/iso-tha-Thai-Latn-11940-1998.yaml
-- maps/kp-kor-Hang-Latn-2002.yaml
-- maps/lshk-yue-Hani-Latn-jyutping-1993.yaml
-- maps/mext-jpn-Hrkt-Latn-1954.yaml
-- maps/moct-kor-Hang-Latn-2000.yaml
-- maps/mofa-jpn-Hrkt-Latn-1989.yaml
-- maps/mvd-bel-Cyrl-Latn-2008.yaml
-- maps/mvd-bel-Cyrl-Latn-2010.yaml
-- maps/mvd-rus-Cyrl-Latn-2008.yaml
-- maps/mvd-rus-Cyrl-Latn-2010.yaml
-- maps/nil-kor-Hang-Hang-jamo.yaml
-- maps/odni-aze-Cyrl-Latn-2015.yaml
-- maps/odni-bel-Cyrl-Latn-2015.yaml
-- maps/odni-bul-Cyrl-Latn-2015.yaml
-- maps/odni-kat-Geor-Latn-2015.yaml
-- maps/odni-kaz-Cyrl-Latn-2015.yaml
-- maps/odni-kir-Cyrl-Latn-2015.yaml
-- maps/odni-mkd-cyrl-latn-2015.yaml
-- maps/odni-rus-Cyrl-Latn-2015.yaml
-- maps/odni-srp-Cyrl-Latn-2015.yaml
-- maps/odni-tat-Cyrl-Latn-2015.yaml
-- maps/odni-tgk-Cyrl-Latn-2015.yaml
-- maps/odni-uig-Cyrl-Latn-2015.yaml
-- maps/odni-ukr-Cyrl-Latn-2015.yaml
-- maps/odni-uzb-Cyrl-Latn-2015.yaml
-- maps/royin-tha-Thai-Latn-1939-generic.yaml
-- maps/royin-tha-Thai-Latn-1968.yaml
-- maps/royin-tha-Thai-Latn-1999-chained.yaml
-- maps/royin-tha-Thai-Latn-1999.yaml
-- maps/sac-zho-Hans-Latn-1979.yaml
-- maps/ses-ara-arab-latn-1930.yaml
-- maps/stategeocadastre-ukr-Cyrl-Latn-1993.yaml
-- maps/ua-ukr-Cyrl-Latn-1996.yaml
-- maps/un-ara-Arab-Latn-1971.yaml
-- maps/un-ara-Arab-Latn-1972.yaml
-- maps/un-ara-Arab-Latn-2017.yaml
-- maps/un-bel-Cyrl-Latn-2007.yaml
-- maps/un-ben-Beng-Latn-2016.yaml
-- maps/un-ell-Grek-Latn-1987-tl.yaml
-- maps/un-ell-Grek-Latn-1987-ts.yaml
-- maps/un-ell-Grek-Latn-phonetic-1987.yaml
-- maps/un-mon-Mong-Latn-2013.yaml
-- maps/un-rus-Cyrl-Latn-1987.yaml
-- maps/un-ukr-cyrl-latn-1998.yaml
-- maps/var-jpn-Hrkt-Latn-hepburn-1886.yaml
-- maps/var-jpn-Hrkt-Latn-hepburn-1954.yaml
-- maps/var-kor-Hang-Latn-mr-1939.yaml
-- maps/var-kor-Kore-Hang-2013.yaml
-- maps/var-kor-Kore-Latn-mr-1939.yaml
-- maps/var-tha-Thai-Thai-phonemic.yaml
-- maps/var-tha-Thai-Zsym-ipa.yaml
-- maps/var-zho-Hani-Latn-1979.yaml
-- spec/interscript/mapping_spec.rb
-- spec/interscript_spec.rb
-- spec/spec_helper.rb
-homepage: ''
+- requirements.txt
+homepage: https://www.interscript.com
 licenses:
-- MIT
-metadata: {}
+- BSD-2-Clause
+metadata:
+  homepage_uri: https://www.interscript.com
+  source_code_uri: https://github.com/interscript/interscript
 post_install_message: 
 rdoc_options: []
 require_paths:
@@ -356,18 +121,15 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '0'
+      version: 2.3.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
-  - - ">="
+  - - ">"
     - !ruby/object:Gem::Version
-      version: 2.4.0
+      version: 1.3.1
 requirements: []
-rubygems_version: 3.0.3
+rubygems_version: 3.1.6
 signing_key: 
 specification_version: 4
 summary: Interoperable script conversion systems
-test_files:
-- spec/interscript/mapping_spec.rb
-- spec/interscript_spec.rb
-- spec/spec_helper.rb
+test_files: []

data/README.adoc

@@ -1,298 +0,0 @@
-= Interscript: Interoperable Script Conversion Systems, with a Ruby implementation
-
-image:https://github.com/interscript/interscript/workflows/test/badge.svg["Ruby build status", link="https://github.com/interscript/interscript/actions?workflow=test"]
-image:https://github.com/interscript/interscript/workflows/js/badge.svg["JavaScript build status", link="https://github.com/interscript/interscript/actions?workflow=js"]
-
-== Introduction
-
-This repository contains interoperable transliteration schemes from:
-
-* ALA-LC
-* BGN/PCGN
-* ICAO
-* ISO
-* UN (by UNGEGN)
-* Many, many other script conversion system authorities.
-
-The goal is to achieve interoperable transliteration schemes allowing quality comparisons.
-
-
-
-== Demonstration
-
-These transliteration systems are used in the demo:
-
-`bgnpcgn-rus-Cyrl-Latn-1947`:: BGN/PCGN Romanization of Russian
-`iso-rus-Cyrl-Latn-9-1995`::     ISO 9 Romanization of Russian
-`icao-rus-Cyrl-Latn-9303`::    ICAO MRZ Romanization of Russian
-`bas-rus-Cyrl-Latn-2017-bss`::      Bulgaria Academy of Science Streamlined System for Russian
-
-image:demo/20191118-interscript-demo-cast.gif["interscript screencast"]
-
-
-== Installation
-
-=== Prerequisites
-
-Linux:
-
-[source,sh]
-----
-apt-get install swig python3-setuptools
-----
-
-Windows:
-
-[source,sh]
-----
-choco install --no-progress swig
-----
-
-Interscript depends on Python and the https://github.com/sequitur-g2p/sequitur-g2p[`sequitur-g2p`] module
-
-[source,sh]
-----
-pip3 install setuptools numpy
-curl -sSL -o sequitur-g2p.zip https://github.com/sequitur-g2p/sequitur-g2p/archive/806273f.zip
-pip3 install sequitur-g2p.zip
-----
-
-Interscript depends on Ruby. Once you manage to install Ruby, it's easy.
-
-[source,sh]
-----
-gem install interscript
-----
-
-== Usage
-
-Assume you have a file ready in the source script like this:
-
-[source,sh]
-----
-cat <<EOT > rus-Cyrl.txt
-Эх, тройка! птица тройка, кто тебя выдумал? знать, у бойкого народа ты
-могла только родиться, в той земле, что не любит шутить, а
-ровнем-гладнем разметнулась на полсвета, да и ступай считать версты,
-пока не зарябит тебе в очи. И не хитрый, кажись, дорожный снаряд, не
-железным схвачен винтом, а наскоро живьём с одним топором да долотом
-снарядил и собрал тебя ярославский расторопный мужик. Не в немецких
-ботфортах ямщик: борода да рукавицы, и сидит чёрт знает на чём; а
-привстал, да замахнулся, да затянул песню — кони вихрем, спицы в
-колесах смешались в один гладкий круг, только дрогнула дорога, да
-вскрикнул в испуге остановившийся пешеход — и вон она понеслась,
-понеслась, понеслась!
-
-Н.В. Гоголь
-EOT
-----
-
-You can run `interscript` on this text using different transliteration systems.
-
-[source,sh]
-----
-interscript rus-Cyrl.txt \
-  --system=bgnpcgn-rus-Cyrl-Latn-1947 \
-  --output=bgnpcgn-rus-Latn.txt
-
-interscript rus-Cyrl.txt \
-  --system=iso-rus-Cyrl-Latn-9-1995 \
-  --output=iso-rus-Latn.txt
-
-interscript rus-Cyrl.txt \
-  --system=icao-rus-Cyrl-Latn-9303 \
-  --output=icao-rus-Latn.txt
-
-interscript rus-Cyrl.txt \
-  --system=bas-rus-Cyrl-Latn-2017-bss \
-  --output=bas-rus-Latn.txt
-----
-
-It is then easy to see the exact differences in rendering between the systems.
-
-[source,sh]
-----
-diff bgnpcgn-rus-Latn.txt bas-rus-Latn.txt
-----
-
-== Adding transliteration system
-
-Transliteration systems stored in a `maps/` directory as YAML files.
-You can create a new file and add it to the directory.
-
-The file should be named as `<system-code>.yaml`, where `system-code`
-is in accordance with
-http://calconnect.gitlab.io/tc-localization/csd-transcription-systems[ISO/CC 24229].
-
-=== File structure
-
-[source,yaml]
-----
-authority_id: bgnpcgn
-id: 1947
-language: rus
-source_script: Cyrl
-destination_script: Latn
-name: ROMANIZATION OF RUSSIAN, BGN/PCGN 1947 System
-url: https://assets.publishing.service.gov.uk/government/uploads/system/uploads/attachment_data/file/807920/ROMANIZATION_OF_RUSSIAN.pdf
-creation_date: 1947
-confirmation_date: 2019-06
-description: The BGN/PCGN system for Russian was adopted ...
-
-notes:
-  - The character e should be romanized ye initially, after the vowel ...
-
-tests:
-  - source: ДЛИННОЕ ПОКРЫВАЛО
-    expected: DLINNOYE POKRYVALO
-  - source: Еловая шишка
-    expected: Yelovaya shishka
-
-map:
-  rules:
-    - pattern: (?<=[АаЕеЁёИиОоУуЫыЭэЮюЯяЙйЪъЬь])\u0415 # Е after a, e, ё, и, о, у, ы, э, ю, я, й, ъ, ь
-      result: Ye
-    - pattern: \b\u0415 # Е initially
-      result: Ye
-
-  characters:
-    "\u0410": "A"
-    "\u0411": "B"
-    "\u0412": "V"
-----
-
-
-=== Rules
-
-The subsection `rules` is placed under the `map` key. All rules are applied in order they are placed before the subsection `characters` applying. Rules apply to an original text, not to a result of previous rules applying.
-
-Each rule has `pattern` and `result` elements.
-
-Pattern is a regex expression. It should be representing as a string without `//` or `%r{}` parentheses. For example `\b\u0415`. In case a rule is depend on previous or next content, lookahead or lookbehind could be used. For example a rule with the pattern `(?<=[АаЕеЁёИиОоУуЫыЭэЮюЯяЙйЪъЬь])\u0415` find every Е after upper or lower case symbols a, e, ё, и, о, у, ы, э, ю, я, й, ъ, ь.
-
-Result is a replacement a for pattern's match. It can contain a string, an Unicode characters specified by a hexadecimal number, a captured group reference. String with hexadecimal number or captured group reference should be double quoted. For example `"Y\u00eb"` or `"\\1\u00b7\\2"`. Captured group are referred by double backslash and group's number.
-
-Because rules are applied in order, multiple rules applicable to the same segment of a string can be addressed by rule ordering, and rules can be used as priority over characters. For example:
-
-[source,yaml]
-----
-map:
-  rules:
-    - pattern: \u03B3\u03B3    # γ (before Γ, Ξ, Χ)
-      result: ng
-    - pattern: (?<![Γγ])\u03B3(?=[ΕεέΗηήΙιίΥυύ])    # γ (before front vowels)
-      result: y
-----
-
-(γι maps to `yi`; but γγ maps to `ng`. In the case of γγι, the first rule takes priority, and the transliteration is `ngi`: it makes the second rule impossible.)
-
-[source,yaml]
-----
-map:
-  rules:
-    - pattern: (?<=\b)\u03BC[πΠ]  # μπ (initially)
-      result: b
-    - pattern: \u03BC[πΠ]         # μπ (medially)
-      result: mb
-----
-
-(The first rule applies at the start of a word; the second rule does not specify a context, as it applies in all other cases not covered by the first rule.)
-
-[source,yaml]
-----
-map:
-  rules:
-    - pattern: ";"
-      result: "?"
-
-  characters
-    "\u00B7": ";
-----
-
-(This guarantees that any `;` are converted to `?` before any new `;` are introduced; because all three are Latin script, they could be mixed up in ordering.)
-
-Normally rules "`bleed`" each other: once a rule applies to a segment, that segment cannot trigger other rules, because it is already converted to Roman. Exceptionally, it will be necessary to have a rule add or remove characters in the original script, rather than transliterate them, so that the same context can be invoked by two rules in succession:
-
-[source,yaml]
-----
-map:
-  rules:
-    - pattern: (?<=[АаЕеЁёИиОоУуЫыЭэЮюЯя])\u042b # Ы after any vowel character
-      result: "\u00b7Ы"
-    - pattern: \u042b(?=[АаУуЫыЭэ])              # Ы before а, у, ы, or э
-      result: "Ы\u00b7"
-----
-
-(If the result were `\u00B7Y`, the second rule could not be applied afterwards; but we want ОЫУ to transliterate as `O·Y·U`. In order to make that happen, we preserve the Ы during the rules phase, resulting in О·Ы·У; we only convert the letters to Roman script in the `characters` phase.)
-
-=== Testing transliteration systems
-
-To test all transliteration systems in the `maps/` directory, run:
-
-[source,sh]
-----
-bundle exec rspec
-----
-
-The command takes `source` texts from the `test` section, transforms
-them using `rules` and `charmaps` from the `map` key, and compares the
-results with `expected:` text from the `source:` section.
-
-To test a specific transliteration system, set the environment variable
-`TRANSLIT_SYSTEM` to the system code of the desired system
-(i.e. the "`basename`" of the system's YAML file):
-
-[source,sh]
-----
-TRANSLIT_SYSTEM=bgnpcgn-rus-Cyrl-Latn-1947 bundle exec rspec
-----
-
-
-== ISCS system codes
-
-In accordance with
-http://calconnect.gitlab.io/tc-localization/csd-transcription-systems[ISO/CC 24229],
-the system code identifying a script conversion system has the following components:
-
-e.g. `bgnpcgn-rus-Cyrl-Latn-1947`:
-
-`bgnpcgn`:: the authority identifier
-`rus`:: an ISO 639-{1,2,3,5} language code that this system applies to (For 639-2, use (T) code)
-`Cyrl`:: an ISO 15924 script code, identifying the source script
-`Latn`:: an ISO 15924 script code, identifying the target script
-`1947`:: an identifier unit within the authority to identify this system
-
-
-== Covered languages
-
-Currently the schemes cover Cyrillic, Armenian, Greek, Arabic and Hebrew.
-
-
-== Samples to play with
-
-* `rus-Cyrl-1.txt`: Copied from the XLS output from http://www.primorsk.vybory.izbirkom.ru/region/primorsk?action=show&global=true&root=254017025&tvd=4254017212287&vrn=100100067795849&prver=0&pronetvd=0&region=25&sub_region=25&type=242&vibid=4254017212287
-
-* `rus-Cyrl-2.txt`: Copied from the XLS output from http://www.yaroslavl.vybory.izbirkom.ru/region/yaroslavl?action=show&root=764013001&tvd=4764013188704&vrn=4764013188693&prver=0&pronetvd=0&region=76&sub_region=76&type=426&vibid=4764013188704
-
-
-== References
-
-Reference documents are located at the
-https://github.com/interscript/interscript-references[interscript-references repository].
-Some specifications that have distribution limitations may not be reproduced there.
-
-
-== Links to system definitions
-
-* https://www.iso.org/committee/48750.html[ISO/TC 46 (see standards published by WG 3)]
-* http://geonames.nga.mil/gns/html/romanization.html[BGN/PCGN and BGN Romanization systems (BGN)]
-* https://www.gov.uk/government/publications/romanization-systems[BGN/PCGN Romanization systems (PCGN)]
-* https://www.loc.gov/catdir/cpso/roman.html[ALA-LC Romanization systems in current use]
-* http://catdir.loc.gov/catdir/cpso/roman.html[ALA-LC Romanization systems from 1997]
-* http://www.eki.ee/wgrs/[UN Romanization systems]
-* http://www.eki.ee/knab/kblatyl2.htm[EKI KNAB systems]
-
-== Copyright and license
-
-This is a Ribose project. Copyright Ribose.
-