README.md

RTLit

CSS left-to-right to right-to-left converter.

Takes CSS, LESS, SASS files and converts them from a left-to-right orientation to a right-to-left orientation. Useful when trying to convert English / Latin / LTR based stylesheets to support RTL languages like Hebrew / Arabic.

Installation

Add this line to your application's Gemfile:

gem 'rtlit'

And then execute:

$ bundle

Or install it yourself as:

$ gem install rtlit

Usage

You can use RTLit in one of three ways

In your code

Include RTLit in your application and convert any CSS string to RTL

require 'rtlit'

ltr_css = File.open('/path/to/ltr/file.css','r') { |f| f.read }
rtl_css = RTLit::Converter.to_rtl ltr_css

As a Rake task

Convert a single file with RTLit

rake rtlit:convert[/path/to/src.css,/path/to/dest.css]

Convert a directory with RTLit

rake rtlit:convert[/path/to/src/,/path/to/dest/]

Convert files in a directory filtered by extension

rake rtlit:convert[/path/to/src/,/path/to/dest/, less] # will convert only *.less files in /path/to/src/

As a CLI command

$ rtlit /path/to/src/file.css /path/to/dest/file-rtl.css # convert /path/to/src/file.css and output to /path/to/dest/file-rtl.css

$ rtlit /path/to/src /path/to/dest # convert all files in /path/to/src/ and output to /path/to/dest

$ rtlit -x less /path/to/src /path/to/dest # convert only *.less files in /path/to/src/

Contributing

1. Fork it
2. Create your feature branch (git checkout -b my-new-feature)
3. Commit your changes (git commit -am 'Added some feature')
4. Push to the branch (git push origin my-new-feature)
5. Create new Pull Request