CSS Left-to-Right to Right-to-Left converter
Ruby CSS
Switch branches/tags
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
bin
lib
tasks
test
.gitignore
Gemfile
LICENSE
README.md
Rakefile
rtlit.gemspec

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

Feel free to contribute to docs on Omniref rtlit API Documentation