gulp-rtlcss

Gulp plugin that uses RTLCSS to convert LTR CSS to RTL.

Install

1$ npm install --save-dev gulp-rtlcss

Basic Usage

1var gulp = require('gulp');
2var rtlcss = require('gulp-rtlcss');
3
4gulp.task('default', function () {
5	return gulp.src('styles.css')
6		.pipe(rtlcss())
7		.pipe(gulp.dest('dist'));
8});

Configuration

The plugin optionally accepts RTLCSS configuration either as an argument or with a file named .rtlcssrc or .rtlcssrc.json.

See the RTLCSS documentation for more information about accepted configuration.

Example

The below example will result in 2 copies of each stylesheet, one LTR stylesheet and one RTL stylesheet (with "-rtl" appended to the filename before the extension). The example uses autoprefixer, this is just an example of other CSS post-processing being used before rtlcss.

1var gulp = require('gulp');
2var autoprefixer = require('gulp-autoprefixer');
3var rtlcss = require('gulp-rtlcss');
4var rename = require('gulp-rename');
5var sourcemaps = require('gulp-sourcemaps');
6
7gulp.task('styles', function () {
8    return gulp.src(['/styles/*.css'])
9		.pipe(sourcemaps.init())
10        .pipe(autoprefixer(["last 2 versions", "> 1%"])) // Other post-processing.
11        .pipe(gulp.dest('dist')) // Output LTR stylesheets.
12        .pipe(rtlcss()) // Convert to RTL.
13        .pipe(rename({ suffix: '-rtl' })) // Append "-rtl" to the filename.
14		.pipe(sourcemaps.write('dist')) // Output source maps.
15        .pipe(gulp.dest('dist')); // Output RTL stylesheets.
16});

Change Log

See CHANGELOG.md.