README.md

grunt-cssjanus

Grunt plugin to convert CSS stylesheets between left-to-right and right-to-left.

Getting Started

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-cssjanus --save-dev

Once the plugin has been installed, enable it inside your Gruntfile:

grunt.loadNpmTasks( 'grunt-cssjanus' );

Options

Run this task with the grunt cssjanus command.

options.swapLtrRtlInUrl

Type: Boolean Default value: true

Whether to replace 'ltr' with 'rtl' and vice versa in urls.

options.swapLeftRightInUrl

Type: Boolean Default value: false

Whether to replace 'left' with 'right' and vice versa in urls.

options.generateExactDuplicates

Type: Boolean Default value: false

Whether to generate the RTL file if it ends up being the same as the LTR file.

options.processContent

Type: Callback Default value: false

If set, the function will be called on the CSS after CSSJanus has run.

Usage

This plugin uses the standard Grunt multi task for file operations. See Configuring tasks for all supported options and formats.

Basic distribution

grunt.initConfig({
  cssjanus: {
    build: {
      files: {
      	'dist/head.rtl.css': 'src/head.css',
      	'dist/main.rtl.css': 'src/main.css'
      }
    }
  }
});

Contribute

• Issue tracker: https://phabricator.wikimedia.org/tag/cssjanus/
• Source code: https://gerrit.wikimedia.org/g/mediawiki/tools/grunt-cssjanus
• Submit patches via Gerrit: https://www.mediawiki.org/wiki/Developer_account