Giter Club home page Giter Club logo

grunt-rtlcss's Introduction

GitHub version NPM version Build Status DEPENDENCIES

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]

  • v1.3.0 [26 Oct 2014]

  • v1.2.0 [28 Sep 2014]

  • v1.1.0 [27 Sep 2014]

  • v1.0.0 [24 Aug 2014]

  • v0.7.0 [11 Aug 2014]

    • Remove duplicate postcss dependency.
    • Upgrade to RTLCSS v0.9.0
  • v0.6.0 [4 Jul 2014]

  • v0.5.0 [4 Jul 2014]

  • v0.4.1 [15 May 2014]

    • Add POSTCSS to dependencies list.
  • v0.4.0 [6 Apr. 2014]

  • v0.3.0 [5 Apr. 2014]

  • v0.2.0 [20 Mar. 2014]

    • Upgrade to RTLCSS v0.2.1
    • Support generating source maps.
  • v0.1.2 [7 Mar. 2014]

  • v0.1.1 [6 Mar. 2014]

    • Fix typo in README.md
  • v0.1.0 [6 Mar. 2014]

    • Initial commit.

grunt-rtlcss's People

Contributors

gaborbata avatar mohammadyounes avatar ocean90 avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar  avatar  avatar  avatar

grunt-rtlcss's Issues

RTL Control Directives not working

I try to add ignore Control Directives but it's not working like your online version.

for example:

.owl-carousel.owl-rtl{direction:rtl; /*rtl:ignore*/ } 
.owl-carousel.owl-rtl .owl-item{float:right; /*rtl:ignore*/} 

not working :(

Exclude option

Salamu Alaykum,

Can you please add exclude option ?
Thank you for such tool it as very helpful ๐Ÿ‘

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.