grunt-rtlcss

grunt plugin for RTLCSS, a framework for transforming CSS from LTR to RTL.

Getting Started

This plugin requires Grunt ~0.4.5

If you haven't used Grunt before, be sure to check out the Getting Started guide, as it explains how to create a Gruntfile as well as install and use Grunt plugins. Once you're familiar with that process, you may install this plugin with this command:

npm install grunt-rtlcss --save-dev

Once the plugin has been installed, it may be enabled inside your Gruntfile with this line of JavaScript:

grunt.loadNpmTasks('grunt-rtlcss');

RTLCSS task

Run this task with the grunt rtlcss command.

Task targets, files and options may be specified according to the grunt Configuring tasks guide.

Options

options.opts

Description: Specifies RTLCSS options.

Type: Object

Default:

{
    "autoRename": false,
    "autoRenameStrict": false,
    "blacklist":{},
    "clean": true,
    "greedy": false,
    "processUrls": false,
    "stringMap":[]
}

options.plugins

Description: Specifies custom RTLCSS plugins.

Type: Array

Default: []

options.map

Description: Specifies whether to generate source maps or not, If you want more control over source map generation, you can define the map option as an object. (see postcss docs).

Type: Boolean or Object

Default: false

saveUnmodified

Description: Specifies whether to save unmodified files or not.

Type: Boolean

Default: true

Usage Example

rtlcss: {
  myTask:{
    // task options
    options: {
      // generate source maps
      map: {inline: false},
      // rtlcss options
      opts: {
        clean:false
      },
      // rtlcss plugins
      plugins:[],
      // save unmodified files
      saveUnmodified: true,
    },
    expand : true,
    cwd    : 'ltr/',
    dest   : 'rtl/',
    src    : ['**/*.css']
  }
}

Release History

• v2.0.2 [23 Nov 2019]

  • Fail in case of CSS errors or inability to write output file.

• v2.0.1 [18 Feb 2016]

  • Fix internal bug.

• v2.0.0 [18 Feb 2016]

  • Upgrade to RTLCSS v2.x
  • options.config renamed to options.opts (avoids confusion with RTLCSS Config).
  • options.rules, options.declarations and options.properties removed in favor of the new options.plugins.

  RTLCSS options have changed, to view a summary of changes, see RTLCSS Upgrade guide.

• v1.6.0 [15 Mar 2015]

  • Upgrade dependency (chalk v1.x.x).

• v1.5.1 [14 Feb 2015]

  • Colorize log messages. Thanks @ocean90.

• v1.5.0 [14 Feb 2015]

  • New option saveUnmodified:true to control whether to save unmodified files or not. Thanks @ocean90.

• v1.4.0 [30 Jan 2015]

  • Upgrade to RTLCSS v1.x.x

• v1.3.0 [26 Oct 2014]

  • Upgrade to RTLCSS v1.4.2

• v1.2.0 [28 Sep 2014]

  • Upgrade to RTLCSS v1.3.0

• v1.1.0 [27 Sep 2014]

  • Upgrade to RTLCSS v1.2.0

• v1.0.0 [24 Aug 2014]

  • Upgrade to RTLCSS v1.0.0

• v0.7.0 [11 Aug 2014]

  • Remove duplicate postcss dependency.
  • Upgrade to RTLCSS v0.9.0

• v0.6.0 [4 Jul 2014]

  • Upgrade to RTLCSS v0.7.0

• v0.5.0 [4 Jul 2014]

  • Upgrade to RTLCSS v0.6.0

• v0.4.1 [15 May 2014]

  • Add POSTCSS to dependencies list.

• v0.4.0 [6 Apr. 2014]

  • Upgrade to RTLCSS v0.4.0

• v0.3.0 [5 Apr. 2014]

  • Upgrade to RTLCSS v0.3.0

• v0.2.0 [20 Mar. 2014]

  • Upgrade to RTLCSS v0.2.1
  • Support generating source maps.

• v0.1.2 [7 Mar. 2014]

  • Upgrade to RTLCSS v0.1.3

• v0.1.1 [6 Mar. 2014]

  • Fix typo in README.md

• v0.1.0 [6 Mar. 2014]

  • Initial commit.