README.md in excel2local-0.1.0 vs README.md in excel2local-0.1.1

- old
+ new

@@ -1,39 +1,103 @@ -# Excel2local - -Welcome to your new gem! In this directory, you'll find the files you need to be able to package up your Ruby library into a gem. Put your Ruby code in the file `lib/excel2local`. To experiment with that code, run `bin/console` for an interactive prompt. - -TODO: Delete this and the text above, and describe your gem - -## Installation - -Add this line to your application's Gemfile: - -```ruby -gem 'excel2local' -``` - -And then execute: - - $ bundle - -Or install it yourself as: - - $ gem install excel2local - -## Usage - -TODO: Write usage instructions here - -## Development - -After checking out the repo, run `bin/setup` to install dependencies. You can also run `bin/console` for an interactive prompt that will allow you to experiment. - -To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and tags, and push the `.gem` file to [rubygems.org](https://rubygems.org). - -## Contributing - -Bug reports and pull requests are welcome on GitHub at https://github.com/[USERNAME]/excel2local. - -## License - -The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT). +# Excel2local +Hey! You want to EASY manage your localise? +Correct and change the location in Excel. Send it for transfer to outsourcing. Save time, spend it on yourself. + +## Installation + +Add this line to your application's Gemfile: +```ruby +gem 'excel2local' +``` + +And then execute: + + $ bundle + +Or install it yourself as: + + $ gem install excel2local + +## Usage if rails +Correct file localises.xlsx and place it to yiur your_rails_app/config/locales/ +and type command in config.ru (for make localises file befoure every start rails) or there where you want to make locales +```ruby +Excel2local::localize! './config/locales/locales.xlsx','./config/locales' +``` +notice: old locales files will be deleted + +## Usage if not rails +require gem if not rails +```ruby +require 'excel2local' + +Excel2local::localize! '****.xlsx','locales path' +``` + +## Correct localises.xlsx or other *.xlsx +Such Excel configuration = 3 files of locales: en.yml, ru.yml,ru_fan.yml + +--- | en | ru | ru_fun | +--- | --- | --- | --- | +hello | hello | привет | приувет | +hello.world | hello world | привет мир | YO! | +head.info.true | true | правда | тру | +head.info.connect | connect to server | соединение | контакт | +head.true.test | test | тест | эй бро | + + +en.yml +```ruby +en: + hello: 'hello' + world: 'hello world' + head: + info: + 'true': 'true' + connect: 'connect to server' + 'true': + test: 'test' +``` +ru.yml +```ruby +ru: + hello: 'привет' + world: 'привет мир' + head: + info: + 'true': 'правда' + connect: 'соединение' + 'true': + test: 'тест' +``` +ru_fun +```ruby +ru_fun: + hello: 'приувет' + world: 'YO!' + head: + info: + 'true': 'тру' + connect: 'контакт ' + 'true': + test: 'эй бро' +``` + +You see, that the specific is correctly processed (true = 'true') +and for example +x1.y1.n1 = +```ruby +x1: + y1: + n1: +``` +## Development +gem uses beautiful gem - "roo" --> https://github.com/roo-rb/roo + + +## Contributing + +Bug reports and pull requests are welcome on GitHub at https://github.com/eliseevTech/excel2local or eliseevmail@ya.ru + +## License + +The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).