feat: paths mapping relative to baseUrl. PR541

zhongsp · zhongsp · commit ff21cd7e207d · 2017-04-15T09:15:24.000+08:00
diff --git a/doc/handbook/Module Resolution.md b/doc/handbook/Module Resolution.md
@@ -215,12 +215,16 @@ TypeScript编译器通过使用`tsconfig.json`文件里的`"paths"`来支持这
   "compilerOptions": {
     "baseUrl": ".", // This must be specified if "paths" is.
     "paths": {
-      "jquery": ["node_modules/jquery/dist/jquery"]
+      "jquery": ["node_modules/jquery/dist/jquery"] // 此处映射是相对于"baseUrl"
     }
   }
 }
 ```
 
+请注意`"paths"`是相对于`"baseUrl"`进行解析。
+如果`"baseUrl"`被设置成了除`"."`外的其它值，比如`tsconfig.json`所在的目录，那么映射必须要做相应的改变。
+如果你在上例中设置了`"baseUrl": "./src"`，那么jquery应该映射到`"../node_modules/jquery/dist/jquery"`。
+
 通过`"paths"`我们还可以指定复杂的映射，包括指定多个回退位置。
 假设在一个工程配置里，有一些模块位于一处，而其它的则在另个的位置。
 构建过程会将它们集中至一处。

Original file line number	Diff line number	Diff line change
@@ -215,12 +215,16 @@ TypeScript编译器通过使用`tsconfig.json`文件里的`"paths"`来支持这
`215`	`215`	`"compilerOptions": {`
`216`	`216`	`"baseUrl": ".", // This must be specified if "paths" is.`
`217`	`217`	`"paths": {`
`218`		`- "jquery": ["node_modules/jquery/dist/jquery"]`
	`218`	`+ "jquery": ["node_modules/jquery/dist/jquery"] // 此处映射是相对于"baseUrl"`
`219`	`219`	`}`
`220`	`220`	`}`
`221`	`221`	`}`
`222`	`222`	```
`223`	`223`
	`224`	+请注意`"paths"`是相对于`"baseUrl"`进行解析。
	`225`	+如果`"baseUrl"`被设置成了除`"."`外的其它值，比如`tsconfig.json`所在的目录，那么映射必须要做相应的改变。
	`226`	+如果你在上例中设置了`"baseUrl": "./src"`，那么jquery应该映射到`"../node_modules/jquery/dist/jquery"`。
	`227`	`+`
`224`	`228`	通过`"paths"`我们还可以指定复杂的映射，包括指定多个回退位置。
`225`	`229`	`假设在一个工程配置里，有一些模块位于一处，而其它的则在另个的位置。`
`226`	`230`	`构建过程会将它们集中至一处。`