heldinz/gulp-convert-encoding

Plugin for gulp to convert files from one encoding to another.

gulp-convert-encoding

Convert files from one encoding to another using iconv-lite.

Install

$ npm install --save-dev gulp-convert-encoding

Usage

var gulp = require('gulp');
var convertEncoding = require('gulp-convert-encoding');

gulp.task('default', function () {
	return gulp.src('src/file.txt')
		.pipe(convertEncoding({to: 'iso-8859-15'}))
		.pipe(gulp.dest('dist'));
});

API

convertEncoding(options)

options

One or both of the original and/or target file encodings must be specified.

Supported encodings are listed on the iconv-lite wiki.

from

Type: string
Default: utf8

The original file encoding.

to

Type: string
Default: utf8

The target file encoding.

iconv

Type: object
Default: {decode: {}, encode: {}}

Allows you to pass additional options into iconv-lite, for example BOM Handling.

License

MIT © Alice Rose

gulp-convert-encoding's Issues

gulp-util is deprecated

Hi there! )

I've some warning of npm with your package.

Now, I run this:
npm i gulp-convert-encoding --save-dev

and see this:
npm WARN deprecated [email protected]: gulp-util is deprecated - replace it, following the guidelines at https://medium.com/gulpjs/gulp-util-ca3b1f9f9ac5

Then I read this description of deprecation gupl-util. Please, read this too.

Not working for utf-8 to iso-8859-2

source.html.zip

Update
The conversion turned out to be correct.
But the encoding operation must be the last operation on the stream. Otherwise the encoding can be messed up by other plugins.

Add support for streams

Enhancement: Convert from any encoding

Using something like jschardet, detect the current encoding and use that as the "from" value instead of UTF8. This is useful in cases where the encoding is not known until runtime, and it is difficult in gulp to conditionally set the "from" param.

I might be able to assist with a PR.