為什麼你們就是不能加個空格呢？

如果你跟我一樣，每次看到網頁上的中文字和英文、數字、符號擠在一塊，就會坐立難安，忍不住想在它們之間加個空格。這個外掛（支援 Chrome 和 Firefox）正是你在網路世界走跳所需要的東西，它會自動替你在網頁中所有的中文字和半形的英文、數字、符號之間插入空白。

漢學家稱這個空白字元為「盤古之白」，因為它劈開了全形字和半形字之間的混沌。另有研究顯示，打字的時候不喜歡在中文和英文之間加空格的人，感情路都走得很辛苦，有七成的比例會在 34 歲的時候跟自己不愛的人結婚，而其餘三成的人最後只能把遺產留給自己的貓。畢竟愛情跟書寫都需要適時地留白。

與大家共勉之。

Installation

for Users

Google Chrome (2016-12-28 updated)
Mozilla Firefox (2015-05-13 updated)

for Developers

pangu.go (Go)
pangu.java (Java)
pangu.js (JavaScript)
pangu.py (Python)
pangu.space (Web API)
pangu.clj (Clojure)
pangu.ex (Elixir)
pangu.objective-c (Objective-C)
pangu.php (PHP)
pangu.rb (Ruby)
pangu.rs (Rust)
pangu.swift (Swift)

Usage

$ npm install pangu --save

Browser

<head>
  // Files are located on /node_modules/pangu/dist/browser/
  <script src="pangu.min.js"></script>
</head>
<script>
  var newText = pangu.spacing("當你凝視著bug，bug也凝視著你");
  // output: 當你凝視著 bug，bug 也凝視著你

  pangu.spacingPage();
  pangu.spacingElementById('main');
  pangu.spacingElementByClassName('comment');
  pangu.spacingElementByTagName('p');
</script>

pangu.js is also available on cdnjs:

<script src="https://cdnjs.cloudflare.com/ajax/libs/pangu/3.3.0/pangu.js"></script>
<script src="https://cdnjs.cloudflare.com/ajax/libs/pangu/3.3.0/pangu.min.js"></script>

Node.js

Learn more on npm.

var pangu = require('pangu'); // ES5
import pangu from 'pangu'; // ES6

pangu.spacing('與PM戰鬥的人，應當小心自己不要成為PM');
// output: 與 PM 戰鬥的人，應當小心自己不要成為 PM

pangu.spacingFile('/path/to/text.txt', function(err, data) {
  // callback
  console.log(data);
});

pangu.spacingFile('/path/to/text.txt').then(function(data) {
  // promise
  console.log(data);
});

const data = pangu.spacingFileSync('/path/to/text.txt');

Testing

You need to install Node.js.

$ git clone git@github.com:vinta/pangu.js.git && cd pangu.js
$ npm install
$ npm run test

License

Released under the MIT License.

Author

GitHub: @vinta
Twitter: @vinta
Website: vinta.ws

Related Projects

Atom: atom-pangu
Command-line interface: pangu-cli
Emacs: pangu-spacing
Gulp: gulp-pangu
JavaScript: 为什么我就是能这样娴熟地加上空格呢？
Node.js: pangu.node
Ruby: auto-correct
Vim: pangu.vim
VS Code: vscode-pangu
WordPress: Space Lover

ReedSun / pangu.js