https://github.com/adnikiforov/iuliia-rb
Russian transliteration using nalgeon/iuliia schemas
https://github.com/adnikiforov/iuliia-rb
Last synced: 4 months ago
JSON representation
Russian transliteration using nalgeon/iuliia schemas
- Host: GitHub
- URL: https://github.com/adnikiforov/iuliia-rb
- Owner: adnikiforov
- License: mit
- Created: 2020-04-30T10:08:43.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2021-11-25T09:41:35.000Z (almost 4 years ago)
- Last Synced: 2025-07-23T11:21:27.903Z (4 months ago)
- Language: Ruby
- Homepage:
- Size: 83 KB
- Stars: 10
- Watchers: 2
- Forks: 1
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE.txt
Awesome Lists containing this project
- nlp-with-ruby - iuliia
README
# Iuliia
Small gem to properly transliterate cyrillic to latin. Use https://github.com/nalgeon/iuliia for transliteration schemas.
## Installation
#### Gem has been renamed to `iuliia`. This is the last version of `iuliia-rb`. Please, use `iuliia` instead.
Add this line to your application's Gemfile:
```ruby
gem 'iuliia'
```
And then execute:
$ bundle
Or install it yourself as:
$ gem install iuliia
## Usage
Get available schemas (dynamically generated from JSON definitions in `lib/schemas`)
```ruby
Iuliia::Schema.available_schemas
[
['mvd_310', 'MVD 310-1997 transliteration schema'],
['bs_2979', 'British Standard 2979:1958 transliteration schema'],
['gost_779_alt', 'GOST 7.79-2000 (aka ISO 9:1995) transliteration schema'],
['icao_doc_9303', 'ICAO DOC 9303 transliteration schema'],
['mvd_310_fr', 'MVD 310-1997 transliteration schema'],
['mvd_782', 'MVD 782-2000 transliteration schema'],
['iso_9_1968_alt', 'ISO/R 9:1968 transliteration schema'],
['mosmetro', 'Moscow Metro map transliteration schema'],
['gost_7034', 'GOST R 7.0.34-2014 transliteration schema'],
['gost_16876_alt', 'GOST 16876-71 (aka GOST 1983) transliteration schema'],
['gost_52290', 'GOST R 52290-2004 transliteration schema'],
['ungegn_1987', 'UNGEGN 1987 V/18 transliteration schema'],
['telegram', 'Telegram transliteration schema'],
['gost_16876', 'GOST 16876-71 (aka GOST 1983) transliteration schema'],
['gost_779', 'GOST 7.79-2000 (aka ISO 9:1995) transliteration schema'],
['wikipedia', 'Wikipedia transliteration schema'],
['bgn_pcgn', 'BGN/PCGN transliteration schema'],
['iso_9_1968', 'ISO/R 9:1968 transliteration schema'],
['yandex_money', 'Yandex.Money transliteration schema'],
['ala_lc', 'ALA-LC transliteration schema.'],
['yandex_maps', 'Yandex.Maps transliteration schema'],
['gost_52535', 'GOST R 52535.1-2006 transliteration schema'],
['bgn_pcgn_alt', 'BGN/PCGN transliteration schema'],
['iso_9_1954', 'ISO/R 9:1954 transliteration schema'],
['bs_2979_alt', 'British Standard 2979:1958 transliteration schema'],
['scientific', 'Scientific transliteration schema'],
['ala_lc_alt', 'ALA-LC transliteration schema.']
]
```
Pick one and transliterate
```ruby
Iuliia.translate('Юлия, съешь ещё этих мягких французских булок из Йошкар-Олы, да выпей алтайского чаю', schema: 'mvd_782')
"Yuliya, syesh' eshche etikh myagkikh frantsuzskikh bulok iz Yoshkar-Oly, da vypey altayskogo chayu"
```
## TODO
* ~~Add documentation~~
* Maybe some more specs
* Implement reverse translit (not available for all schemas though): https://github.com/adnikiforov/iuliia-rb/issues/3
## Development
Check out repo:
```
git clone git@github.com:adnikiforov/iuliia-rb.git
```
Check out submodule with schemas:
```
git submodule update --init
```
Setup dependencies:
```
bin/setup
```
Run specs:
```
bundle exec rspec
```
Or open console to try it:
```
bin/console
```
To install this gem onto your local machine, run `bundle exec rake install`.
## Support
## License
The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).