[Pkg-javascript-commits] [node-iconv-lite] 77/83: Update README.md

matthew pideil mpideil-guest at moszumanska.debian.org
Tue Apr 1 19:56:53 UTC 2014


This is an automated email from the git hooks/post-receive script.

mpideil-guest pushed a commit to branch master
in repository node-iconv-lite.

commit 328722b893b09be5f9211b6079d19b709e2523e6
Author: Alexander Shtuchkin <ashtuchkin at gmail.com>
Date:   Thu Dec 26 10:40:23 2013 -0800

    Update README.md
---
 README.md | 37 ++++++++++++++++++++-----------------
 1 file changed, 20 insertions(+), 17 deletions(-)

diff --git a/README.md b/README.md
index ba30a32..503b1e8 100644
--- a/README.md
+++ b/README.md
@@ -1,39 +1,39 @@
-iconv-lite - pure javascript character encoding conversion
-======================================================================
+# Iconv-lite: character encoding conversion in javascript
 
+[![NPM Stats](https://nodei.co/npm/iconv-lite.png?downloads=true)](https://npmjs.org/packages/iconv-lite/)
 [![Build Status](https://secure.travis-ci.org/ashtuchkin/iconv-lite.png?branch=master)](http://travis-ci.org/ashtuchkin/iconv-lite)
 
 ## Features
 
-*   Pure javascript. Doesn't need native code compilation.
-*   Easy API.
-*   Works on Windows and in sandboxed environments like [Cloud9](http://c9.io).
-*   Encoding is much faster than node-iconv (see below for performance comparison).
+ * Doesn't need native code compilation. Works on Windows and in sandboxed environments like [Cloud9](http://c9.io).
+ * Intuitive encode/decode API.
+ * Encoding is faster than [node-iconv](https://github.com/bnoordhuis/node-iconv) (see below for performance comparison).
+ * Used in popular projects like [Grunt](http://gruntjs.com/), [Nodemailer](http://www.nodemailer.com/), [Yeoman](http://yeoman.io/) and others.
+ * License: MIT.
 
 ## Usage
 
     var iconv = require('iconv-lite');
     
-    // Convert from an encoded buffer to string.
+    // Convert from an encoded buffer to js string.
     str = iconv.decode(buf, 'win1251');
     
-    // Convert from string to an encoded buffer.
+    // Convert from js string to an encoded buffer.
     buf = iconv.encode("Sample input string", 'win1251');
 
     // Check if encoding is supported
     iconv.encodingExists("us-ascii")
 
-
 ## Supported encodings
 
-*   All node.js native encodings: 'utf8', 'ucs2', 'ascii', 'binary', 'base64'
-*   All widespread single byte encodings: Windows 125x family, ISO-8859 family, 
+ *  All node.js native encodings: 'utf8', 'ucs2', 'ascii', 'binary', 'base64'
+ *  All widespread single byte encodings: Windows 125x family, ISO-8859 family, 
     IBM/DOS codepages, Macintosh family, KOI8 family. 
     Aliases like 'latin1', 'us-ascii' also supported.
-*   Multibyte encodings: 'gbk', 'gb2313', 'Big5', 'cp950'.
+ *  Multibyte encodings: 'gbk', 'gb2313', 'Big5', 'cp950'.
 
 Others are easy to add, see the source. Please, participate.
-Most encodings are generated from node-iconv. Thank you Ben Noordhuis and iconv authors!
+Most encodings are generated automatically from [node-iconv](https://github.com/bnoordhuis/node-iconv). Thank you Ben Noordhuis and iconv authors!
 
 Not supported yet: EUC family, Shift_JIS.
 
@@ -66,7 +66,10 @@ Untranslatable characters are set to � or ?. No transliteration is currently s
 
 ## TODO
 
-*   Support streaming character conversion, something like util.pipe(req, iconv.fromEncodingStream('latin1')).
-*   Add more encodings.
-*   Add transliteration (best fit char).
-*   Add tests and correct support of variable-byte encodings (currently work is delegated to node).
+ * Support streaming character conversion, something like util.pipe(req, iconv.fromEncodingStream('latin1')).
+ * Add more encodings.
+ * Add transliteration (best fit char).
+ * Add tests and correct support of variable-byte encodings (currently work is delegated to node).
+
+## Adoption
+[![NPM](https://nodei.co/npm-dl/iconv-lite.png)](https://nodei.co/npm/iconv-lite/)

-- 
Alioth's /usr/local/bin/git-commit-notice on /srv/git.debian.org/git/pkg-javascript/node-iconv-lite.git



More information about the Pkg-javascript-commits mailing list