修改node/npm

Author: ruanyf

grammar/function.md

@@ -266,6 +266,27 @@ f3.name // 'myName'
 
 上面代码中，函数的name属性总是返回紧跟在function关键字之后的那个函数名。对于f2来说，返回空字符串，对于f3来说，返回函数表达式的名字（真正的函数名还是f3，myName这个名字只在函数体内部可用）。 
 
+## toString方法
+
+函数的toString方法返回函数的源码。
+
+```javascript
+
+function f() { 
+  a(); 
+  b(); 
+  c(); 
+}
+
+f.toString()
+// function f() { 
+//  a(); 
+//  b(); 
+//  c(); 
+// }
+
+```
+
 ## 函数作用域
 
 ### 定义

nodejs/npm.md

@@ -381,54 +381,100 @@ browserify browser/main.js | uglifyjs -mc > static/bundle.js
 
 一般来说，每个项目都会在项目目录内，安装所需的模块文件。也就是说，各个模块是局部安装。但是有时候，我们希望模块是一个符号链接，连到外部文件，这时候就需要用到npm link命令。
 
-现在模块A（moduleA）的安装目录下运行npm link命令。
+为了理解npm link，请设想这样一个场景。你开发了一个模块myModule，目录为src/myModule，你自己的项目myProject要用到这个模块，项目目录为src/myProject。每一次，你更新myModule，就要用`npm publish`命令发布，然后切换到项目目录，使用`npm update`更新模块。这样显然很不方便，如果我们可以从项目目录建立一个符号链接，直接连到模块目录，就省去了中间步骤，项目可以直接使用最新版的模块。
+
+先在模块目录（src/myModule）下运行npm link命令。
 
 {% highlight bash %}
 
-/path/to/moduleA $ npm link
+src/myModule$ npm link
 
 {% endhighlight %}
 
-上面的命令会在npm的安装目录内，生成一个符号链接文件。
+上面的命令会在npm的全局模块目录内（比如/usr/local/lib/node_modules/），生成一个符号链接文件，该文件的名字就是package.json文件中指定的文件名。
 
 {% highlight bash %}
 
-/usr/local/share/npm/lib/node_modules/moduleA -> /path/to/moduleA
+/usr/local/lib/node_modules/myModule -> src/myModule
 
 {% endhighlight %}
 
-然后，转到你需要放置该模块的项目目录，再次运行npm link命令，并指定模块名。
+然后，切换到你需要放置该模块的项目目录，再次运行npm link命令，并指定模块名。
 
 {% highlight bash %}
 
-/path/to/my-project  $ npm link moduleA
+src/myProject$ npm link myModule
 
 {% endhighlight %}
 
 上面命令等同于生成了本地模块的符号链接。
 
 {% highlight bash %}
 
-/path/to/my-project/node_modules/moduleA -> /usr/local/share/npm/lib/node_modules/moduleA
+src/myProject/node_modules/myModule -> /usr/local/lib/node_modules/myModule
 
 {% endhighlight %}
 
 然后，就可以在你的项目中，加载该模块了。
 
 {% highlight javascript %}
 
-require('moduleA')
+var myModule = require('myModule');
 
 {% endhighlight %}
 
+这样一来，myModule的任何变化，都可以直接在myProject中调用。但是，同时也出现了风险，任何在myProject目录中对myModule，都会反映到模块的源码中。
+
+npm link命令有一个简写形式，显示连接模块的本地目录。
+
+```javascript
+
+src/myProject$ npm link ../myModule
+
+```
+
+上面的命令等同于下面几条命令。
+
+```javascript
+
+src/myProject$ cd ../myModule
+src/myModule$ npm link
+src/myModule$ cd ../myProject
+src/myProject$ npm link myModule
+
+```
+
 如果你的项目不再需要该模块，可以在项目目录内使用npm unlink命令，删除符号链接。
 
 {% highlight bash %}
 
-/path/to/my-project  $ npm unlink moduleA
+src/myProject$ npm unlink myModule
 
 {% endhighlight %}
 
+一般来说，npm公共模块都安装在系统目录（比如/usr/local/lib/），普通用户没有写入权限，需要用到sudo命令。这不是很方便，我们可以在没有root的情况下，用好npm。
+
+首先在主目录下新建配置文件.npmrc，然后在该文件中将prefix变量定义到主目录下面。
+
+```bash
+prefix = /home/yourUsername/npm
+```
+
+然后在主目录下新建npm子目录。
+
+```bash
+$ mkdir ~/npm
+```
+
+此后，全局安装的模块都会安装在这个子目录中，npm也会到`~/npm/bin`目录去寻找命令。因此，`npm link`就不再需要
+root权限了。
+
+最后，将这个路径在.bash_profile文件（或.bashrc文件）中加入PATH变量。
+
+```bash
+export PATH=~/npm/bin:$PATH
+```
+
 ## npm publish
 
 在发布你的模块之前，需要先设定个人信息。
@@ -523,3 +569,4 @@ npm publish
 
 - James Halliday, [task automation with npm run](http://substack.net/task_automation_with_npm_run): npm run命令（package.json文件的script属性）的用法
 - Keith Cirkel, [How to Use npm as a Build Tool](http://blog.keithcirkel.co.uk/how-to-use-npm-as-a-build-tool/)
+- justjs, [npm link: developing your own npm modules without tears](http://justjs.com/posts/npm-link-developing-your-own-npm-modules-without-tears)

nodejs/packagejson.md

@@ -161,3 +161,7 @@ scripts: {
 ### engines
 
 engines指明了该项目所需要的node.js版本。
+
+### preferGlobal
+
+preferGlobal的值是布尔值，表示当用户不将该模块安装为全局模块时（即不用--global参数），要不要显示警告，表示该模块的本意就是安装为全局模块。

nodejs/process.md

@@ -26,7 +26,7 @@ process对象提供一系列属性，用于返回系统信息。
 
 下面是主要属性的介绍。
 
-**（1）process.stdout**
+**（1）process.stdout，process.stdin**
 
 process.stdout用来控制标准输出，也就是在命令行窗口向用户显示内容。它的write方法等同于console.log。
 
@@ -38,6 +38,39 @@ exports.log = function() {
 
 {% endhighlight %}
 
+
+下面代码表示将一个文件导向标准输出。
+
+```javascript
+var fs = require('fs');
+
+fs.createReadStream('wow.txt')
+    .pipe(process.stdout)
+    ;
+```
+
+由于process.stdout和process.stdin与其他进程的通信，都是流（stream）形式，所以必须通过pipe管道命令中介。
+
+```javascript
+var fs = require('fs');
+var zlib = require('zlib');
+
+fs.createReadStream('wow.txt')
+    .pipe(zlib.createGzip())
+    .pipe(process.stdout)
+;
+```
+
+上面代码通过pipe方法，先将文件数据压缩，然后再导向标准输出。
+
+process.stdin代表标准输入。
+
+```javascript
+process.stdin.pipe(process.stdout)
+```
+
+上面代码表示将标准输入导向标准输出。
+
 **（2）process.argv**
 
 process.argv返回命令行脚本的各个参数组成的数组。第一个成员是node可执行文件，第二个成员是脚本文件名，其余成员是脚本文件的参数。

nodejs/stream.md

@@ -16,6 +16,29 @@ Stream方法在Node中被定义成了一个抽象接口，具有readable、writa
 
 Node内部的很多IO处理都部署了Stream接口，比如HTTP连接、文件读写、标准输入输出等。
 
+数据流通过pipe方法，可以方便地导向其他具有Stream接口的对象。
+
+```javascript
+var fs = require('fs');
+var zlib = require('zlib');
+
+fs.createReadStream('wow.txt')
+    .pipe(zlib.createGzip())
+    .pipe(process.stdout)
+;
+```
+
+上面代码先打开文本文件wow.txt，然后压缩，再导向标准输出。
+
+```javascript
+fs.createReadStream('wow.txt')
+    .pipe(zlib.createGzip())
+    .pipe(fs.createWriteStream('wow.gz'))
+;
+```
+
+上面代码压缩文件wow.txt以后，又将其写回压缩文件。
+
 ## HTTP请求
 
 data事件表示读取或写入了一块数据。
@@ -133,3 +156,6 @@ readStream.on('end', function () {
 
 {% endhighlight %}
 
+## 参考链接
+
+- James Halliday, [cs294-101-streams-lecture](https://github.com/substack/cs294-101-streams-lecture)