Complete structure

xcatliu · xcatliu · commit 866f80f402e8 · 2017-01-16T17:04:05.000+08:00
diff --git a/README.md b/README.md
@@ -47,6 +47,40 @@ TypeScript 虽然有[官方手册][Handbook]及其[非官方中文版][中文手
 - 没有系统学习过 JavaScript
 - 已经能够很熟练的运用 TypeScript
 
+## 目录
+
+- [前言](README.md)
+- [简介](introduction/README.md)
+  - [什么是 TypeScript](introduction/what-is-typescript.md)
+  - [安装 TypeScript](introduction/get-typescript.md)
+  - [Hello TypeScript](introduction/hello-typescript.md)
+- [基础](basics/README.md)
+  - [原始数据类型](basics/primitive-data-types.md)
+  - [任意值](basics/any.md)
+  - [类型推论](basics/type-inference.md)
+  - [联合类型](basics/union-types.md)
+  - [对象的类型——接口](basics/type-of-object-interfaces.md)
+  - [数组的类型](basics/type-of-array.md)
+  - [函数的类型](basics/type-of-function.md)
+  - [类型断言](basics/type-assertion.md)
+  - [声明文件](basics/declaration-files.md)
+  - [内置对象](basics/built-in-objects.md)
+- [进阶](advanced/README.md)
+  - [类型别名](advanced/type-aliases.md)
+  - [字符串字面量类型](advanced/string-literal-types.md)
+  - [元组](advanced/tuple.md)
+  - [枚举](advanced/enum.md)
+  - [类](advanced/class.md)
+  - [类与接口](advanced/class-and-interfaces.md)
+  - [泛型](advanced/generics.md)
+  - [声明合并](advanced/declaration-merging.md)
+  - [扩展阅读](advanced/further-reading.md)
+- [实践](practice/README.md)
+  - [编译选项](practice/tsconfig.md)
+  - [代码检查](practice/tslint.md)
+  - [构建工具](practice/build.md)
+- [感谢](thanks/README.md)
+
 ## 版权许可
 
 本书采用「保持署名—非商用」创意共享 4.0 许可证。
diff --git a/SUMMARY.md b/SUMMARY.md
@@ -13,12 +13,21 @@
   - [对象的类型——接口](basics/type-of-object-interfaces.md)
   - [数组的类型](basics/type-of-array.md)
   - [函数的类型](basics/type-of-function.md)
+  - [类型断言](basics/type-assertion.md)
   - [声明文件](basics/declaration-files.md)
   - [内置对象](basics/built-in-objects.md)
-- 进阶（未完成）
-  - [类的用法](advanced/use-of-class.md)
-  - [类的类型](advanced/type-of-class.md)
+- [进阶](advanced/README.md)
+  - [类型别名](advanced/type-aliases.md)
+  - [字符串字面量类型](advanced/string-literal-types.md)
   - [元组](advanced/tuple.md)
   - [枚举](advanced/enum.md)
-- 实践（未完成）
-- 学习资料（未完成）
+  - [类](advanced/class.md)
+  - [类与接口](advanced/class-and-interfaces.md)
+  - [泛型](advanced/generics.md)
+  - [声明合并](advanced/declaration-merging.md)
+  - [扩展阅读](advanced/further-reading.md)
+- [实践](practice/README.md)
+  - [编译选项](practice/tsconfig.md)
+  - [代码检查](practice/tslint.md)
+  - [构建工具](practice/build.md)
+- [感谢](thanks/README.md)
diff --git a/advanced/README.md b/advanced/README.md
@@ -1,3 +1,18 @@
 ## 进阶
 
+TBD
+
+- [类型别名](type-aliases.md)
+- [字符串字面量类型](string-literal-types.md)
+- [元组](tuple.md)
+- [枚举](enum.md)
+- [类](class.md)
+- [类与接口](class-and-interfaces.md)
+- [泛型](generics.md)
+- [声明合并](declaration-merging.md)
+- [扩展阅读](further-reading.md)
+
 ---
+
+- [上一章：内置对象](built-in-objects.md)
+- [下一章：类型别名](type-aliases.md)
diff --git a/advanced/class-and-interfaces.md b/advanced/class-and-interfaces.md
@@ -0,0 +1,47 @@
+# 类与接口
+
+TBD
+
+## 类实现接口
+
+实现（implements）是面向对象中的一个重要概念。一般来讲，一个类只能继承自另一个类，有时候不同类之间可以有一些共有的特性，这时候就可以把特性提取成接口（interfaces），用 `implements` 关键字来实现。这个特性大大提高了面向对象的灵活性。
+
+举例来说，门是一个类，防盗门是门的子类。如果防盗门有一个报警器的功能，我们可以简单的给防盗门添加一个报警方法。这时候如果有另一个类，车，也有报警器的功能，就可以考虑把报警器提取出来，作为一个接口，防盗门和车都去实现它：
+
+```ts
+interface Alarm {
+  alert()
+}
+
+class Door {
+}
+
+class SecurityDoor extends Door implements Alarm {
+  alert() {
+    console.log('SecurityDoor alert');
+  }
+}
+
+class Car implements Alarm {
+  alert() {
+    console.log('Car alert');
+  }
+}
+```
+
+## 接口继承接口
+
+TBD
+
+## 接口继承类
+
+TBD
+
+## 混合类型
+
+TBD
+
+---
+
+- [上一章：类](class.md)
+- [下一章：泛型](generics.md)
diff --git a/advanced/class.md b/advanced/class.md
@@ -1,4 +1,4 @@
-# 类的用法
+# 类
 
 传统方法中，JavaScript 通过构造函数实现类的概念，通过原型链实现继承。而在 ES6 中，我们终于迎来了 `class`。
 
@@ -336,38 +336,14 @@ var Cat = (function (_super) {
 var cat = new Cat('Tom');
 ```
 
-### 类实现接口
-
-接口在 TypeScript 中是一个非常灵活的概念，实际上，我们在[对象的类型——接口](../basics/type-of-object-interfaces.html)一章中，已经接触了接口的一种用法了。这里是接口的第二种用法。想了解接口的所有用法，可以参考？？？。
-
-实现（implements）是面向对象中的一个重要概念。一般来讲，一个类只能继承自另一个类，有时候不同类之间可以有一些共有的特性，这时候就可以把特性提取成接口（interfaces），用 `implements` 关键字来实现。这个特性大大提高了面向对象的灵活性。
-
-举例来说，门是一个类，防盗门是门的子类。如果防盗门有一个报警器的功能，我们可以简单的给防盗门添加一个报警方法。这时候如果有另一个类，车，也有报警器的功能，就可以考虑把报警器提取出来，作为一个接口，防盗门和车都去实现它：
-
-```ts
-interface Alarm {
-  alert()
-}
-
-class Door {
-}
-
-class SecurityDoor extends Door implements Alarm {
-  alert() {
-    console.log('SecurityDoor alert');
-  }
-}
-
-class Car implements Alarm {
-  alert() {
-    console.log('Car alert');
-  }
-}
-```
-
 ## 参考
 
 - [Handbook - Classes](http://www.typescriptlang.org/docs/handbook/classes.html) | [中文版](https://zhongsp.gitbooks.io/typescript-handbook/content/doc/handbook/Classes.html)
 - [ECMAScript 6 入门 - Class]
 
 [ECMAScript 6 入门 - Class]: http://es6.ruanyifeng.com/#docs/class
+
+---
+
+- [上一章：枚举](enum.md)
+- [下一章：类与接口](class-and-interfaces.md)
diff --git a/advanced/declaration-merging.md b/advanced/declaration-merging.md
@@ -0,0 +1,8 @@
+# 声明合并
+
+TBD
+
+---
+
+- [上一章：泛型](generics.md)
+- [下一章：扩展阅读](further-reading.md)
diff --git a/advanced/enum.md b/advanced/enum.md
@@ -224,3 +224,6 @@ var directions = [0 /* Up */, 1 /* Down */, 2 /* Left */, 3 /* Right */];
 [C# Enum]: https://msdn.microsoft.com/zh-cn/library/sbbt4032.aspx
 
 ---
+
+- [上一章：元组](tuple.md)
+- [下一章：类](class.md)
diff --git a/advanced/further-reading.md b/advanced/further-reading.md
@@ -0,0 +1,27 @@
+# 扩展阅读
+
+此处记录了[官方手册](http://www.typescriptlang.org/docs/handbook/basic-types.html)（[中文版](https://zhongsp.gitbooks.io/typescript-handbook/content/)）中包含，但是本书未涉及的概念。
+
+我认为它们是一些不重要或者不属于 TypeScript 的概念，所以这里只给出一个简单的释义，详细内容可以点击链接深入理解。
+
+- [Never](http://www.typescriptlang.org/docs/handbook/basic-types.html#never)（[中文版](https://zhongsp.gitbooks.io/typescript-handbook/content/doc/handbook/Basic%20Types.html#never)）：永远不存在值的类型，一般用于错误处理函数
+- [变量声明](http://www.typescriptlang.org/docs/handbook/variable-declarations.html)（[中文版](https://zhongsp.gitbooks.io/typescript-handbook/content/doc/handbook/Variable%20Declarations.html)）：使用 `let` 和 `const` 替代 `var`，这是 [ES6 的知识](http://es6.ruanyifeng.com/#docs/let)
+- [泛型#在泛型约束中使用类型参数](http://www.typescriptlang.org/docs/handbook/generics.html#using-type-parameters-in-generic-constraints)（[中文版](https://zhongsp.gitbooks.io/typescript-handbook/content/doc/handbook/Generics.html#在泛型约束中使用类型参数)）：多个类型参数间可以互相约束
+- [泛型#在泛型里使用类类型](http://www.typescriptlang.org/docs/handbook/generics.html#using-class-types-in-generics)（[中文版](https://zhongsp.gitbooks.io/typescript-handbook/content/doc/handbook/Generics.html#在泛型里使用类类型)）：创建工厂函数时，需要引用构造函数的类类型
+- [类型推论#最佳通用类型](http://www.typescriptlang.org/docs/handbook/type-inference.html#best-common-type)（[中文版](https://zhongsp.gitbooks.io/typescript-handbook/content/doc/handbook/Type%20Inference.html#最佳通用类型)）：数组的类型推论
+- [类型推论#上下文类型](http://www.typescriptlang.org/docs/handbook/type-inference.html#contextual-type)（[中文版](https://zhongsp.gitbooks.io/typescript-handbook/content/doc/handbook/Type%20Inference.html#上下文类型)）：函数输入的类型推论
+- [类型兼容性](http://www.typescriptlang.org/docs/handbook/type-compatibility.html)（[中文版](https://zhongsp.gitbooks.io/typescript-handbook/content/doc/handbook/Type%20Compatibility.html)）：允许不严格符合类型，只需要在一定规则下兼容即可
+- [高级类型#交叉类型](http://www.typescriptlang.org/docs/handbook/advanced-types.html#intersection-types)（[中文版](https://zhongsp.gitbooks.io/typescript-handbook/content/doc/handbook/Advanced%20Types.html#交叉类型（intersection-types）)）：使用 `&` 将多种类型的共有部分叠加成一种类型
+- [高级类型#类型保护与区分类型](http://www.typescriptlang.org/docs/handbook/advanced-types.html#type-guards-and-differentiating-types)（[中文版](https://zhongsp.gitbooks.io/typescript-handbook/content/doc/handbook/Advanced%20Types.html#类型保护与区分类型（type-guards-and-differentiating-types）)）：联合类型在一些情况下被识别为特定的类型
+- [高级类型#可辨识联合](http://www.typescriptlang.org/docs/handbook/advanced-types.html#discriminated-unions)（[中文版](https://zhongsp.gitbooks.io/typescript-handbook/content/doc/handbook/Advanced%20Types.html#可辨识联合（discriminated-unions）)）：使用 `|` 联合多个接口的时候，通过一个共有的属性形成可辨识联合
+- [高级类型#多态的 `this` 类型](http://www.typescriptlang.org/docs/handbook/advanced-types.html#polymorphic-this-types)（[中文版](https://zhongsp.gitbooks.io/typescript-handbook/content/doc/handbook/Advanced%20Types.html#多态的this类型)）：父类的某个方法返回 `this`，当子类继承父类后，子类的实例调用此方法，返回的 `this` 能够被 TypeScript 正确的识别为子类的实例。
+- [Symbols](http://www.typescriptlang.org/docs/handbook/symbols.html)（[中文版](https://zhongsp.gitbooks.io/typescript-handbook/content/doc/handbook/Symbols.html)）：新原生类型，这是 [ES6 的知识](http://es6.ruanyifeng.com/#docs/symbol)
+- [Iterators 和 Generators](http://www.typescriptlang.org/docs/handbook/iterators-and-generators.html)（[中文版](https://zhongsp.gitbooks.io/typescript-handbook/content/doc/handbook/Iterators%20and%20Generators.html)）：迭代器，这是 [ES6 的知识](http://es6.ruanyifeng.com/#docs/iterator)
+- [命名空间](http://www.typescriptlang.org/docs/handbook/namespaces.html)（[中文版](https://zhongsp.gitbooks.io/typescript-handbook/content/doc/handbook/Namespaces.html)）：避免全局污染，现在已被 [ES6 Module](http://es6.ruanyifeng.com/#docs/module) 替代
+- [Decorators](http://www.typescriptlang.org/docs/handbook/decorators.html)（[中文版](https://zhongsp.gitbooks.io/typescript-handbook/content/doc/handbook/Decorators.html)）：修饰器，这是 [ES7 的一个提案](http://es6.ruanyifeng.com/#docs/decorator)
+- [混入](http://www.typescriptlang.org/docs/handbook/mixins.html)（[中文版](https://zhongsp.gitbooks.io/typescript-handbook/content/doc/handbook/Mixins.html)）：一种编程模式，与 TypeScript 没有直接关系，可以参考 [ES6 中 Mixin 模式的实现](http://es6.ruanyifeng.com/#docs/class#Mixin模式的实现)
+
+---
+
+- [上一章：声明合并](declaration-merging.md)
+- [下一章：实践](../practice/README.md)
diff --git a/advanced/generics.md b/advanced/generics.md
@@ -134,3 +134,6 @@ TBD
 - [Handbook - Generics](http://www.typescriptlang.org/docs/handbook/generics.html) | [中文版](https://zhongsp.gitbooks.io/typescript-handbook/content/doc/handbook/generics.html)
 
 ---
+
+- [上一章：类与接口](class-and-interfaces.md)
+- [下一章：声明合并](declaration-merging.md)
diff --git a/advanced/never.md b/advanced/never.md
diff --git a/advanced/string-literal-types.md b/advanced/string-literal-types.md
@@ -0,0 +1,8 @@
+# 字符串字面量类型
+
+TBD
+
+---
+
+- [上一章：类型别名](type-aliases.md)
+- [下一章：元组](tuple.md)
diff --git a/advanced/tuple.md b/advanced/tuple.md
@@ -94,4 +94,7 @@ console.log(xcatliu[2].slice(1));
 
 ---
 
+- [上一章：字符串字面量类型](string-literal-types.md)
+- [下一章：枚举](enum.md)
+
 [C# Tuple]: https://msdn.microsoft.com/en-us/library/system.tuple(v=vs.110).aspx
diff --git a/advanced/type-aliases.md b/advanced/type-aliases.md
@@ -0,0 +1,8 @@
+# 类型别名
+
+TBD
+
+---
+
+- [上一章：进阶](../advanced/README.md)
+- [下一章：字符串字面量类型](string-literal-types.md)
diff --git a/advanced/type-of-class.md b/advanced/type-of-class.md
diff --git a/basics/README.md b/basics/README.md
@@ -9,6 +9,7 @@
 - [对象的类型——接口](type-of-object-interfaces.md)
 - [数组的类型](type-of-array.md)
 - [函数的类型](type-of-function.md)
+- [类型断言](type-assertion.md)
 - [声明文件](declaration-files.md)
 - [内置对象](built-in-objects.md)
 
diff --git a/basics/declaration-files.md b/basics/declaration-files.md
@@ -81,5 +81,5 @@ npm install @types/jquery --save-dev
 
 ---
 
-- [上一章：函数的类型](type-of-function.md)
+- [上一章：类型断言](type-assertion.md)
 - [下一章：内置对象](built-in-objects.md)
diff --git a/basics/type-assertion.md b/basics/type-assertion.md
@@ -0,0 +1,8 @@
+# 类型断言
+
+TBD
+
+---
+
+- [上一章：函数的类型](type-of-function.md)
+- [下一章：声明文件](declaration-files.md)
diff --git a/basics/type-of-function.md b/basics/type-of-function.md
@@ -171,6 +171,10 @@ push(a, 1, 2, 3);
 
 注意，rest 参数只能是最后一个参数，关于 rest 参数，可以参考 [ES6 中的 rest 参数]。
 
+## 重载
+
+TBD
+
 ## 参考
 
 - [Handbook - Functions](http://www.typescriptlang.org/docs/handbook/functions.html) | [中文版](https://zhongsp.gitbooks.io/typescript-handbook/content/doc/handbook/Functions.html)
@@ -187,4 +191,4 @@ push(a, 1, 2, 3);
 ---
 
 - [上一章：数组的类型](type-of-array.md)
-- [下一章：声明文件](declaration-files.md)
+- [下一章：类型断言](type-assertion.md)
diff --git a/basics/type-of-object-interfaces.md b/basics/type-of-object-interfaces.md
@@ -2,11 +2,11 @@
 
 在 TypeScript 中，我们使用接口（Interfaces）来定义对象的类型。
 
-## 什么是接口（Interfaces）
+## 什么是接口
 
 在面向对象语言中，接口（Interfaces）是一个很重要的概念，它是对行为的抽象，而具体如何行动需要由类（classes）去实现（implements）。
 
-TypeScript 中的接口是一个非常灵活的概念，除了可用于[对类的一部分行为进行抽象](../advanced/use-of-class.md#实现接口)以外，也常用于对「对象的形状（Shape）」进行描述。
+TypeScript 中的接口是一个非常灵活的概念，除了可用于[对类的一部分行为进行抽象](../advanced/use-of-class.md#类实现接口)以外，也常用于对「对象的形状（Shape）」进行描述。
 
 ## 简单的例子
 
@@ -156,6 +156,10 @@ let xcatliu: Person = {
 
 另外，在报错信息中可以看出，此时 `{ name: 'Xcat Liu', age: 25, website: 'http://xcatliu.com' }` 的类型被推断成了 `{ [x: string]: string | number; name: string; age: number; github: string; }`，这是联合类型和接口的结合。
 
+## 只读属性
+
+TBD
+
 ## 参考 
 
 - [Handbook - Interfaces](http://www.typescriptlang.org/docs/handbook/interfaces.html) | [中文版](https://zhongsp.gitbooks.io/typescript-handbook/content/doc/handbook/Interfaces.html)
diff --git a/practice/README.md b/practice/README.md
@@ -0,0 +1,12 @@
+# 实践
+
+TBD
+
+- [编译选项](tsconfig.md)
+- [代码检查](tslint.md)
+- [构建工具](build.md)
+
+---
+
+- [上一章：扩展阅读](../advanced/further-reading.md)
+- [下一章：编译选项](tsconfig.md)
diff --git a/practice/build.md b/practice/build.md
@@ -0,0 +1,8 @@
+# 构建
+
+TBD
+
+---
+
+- [上一章：代码检查](tslint.md)
+- [下一章：感谢](../thanks/README.md)
diff --git a/practice/tsconfig.md b/practice/tsconfig.md
@@ -0,0 +1,8 @@
+# 编译选项
+
+TBD
+
+---
+
+- [上一章：实践](README.md)
+- [下一章：代码检查](tslint.md)
diff --git a/practice/tslint.md b/practice/tslint.md
@@ -0,0 +1,8 @@
+# 代码检查
+
+TBD
+
+---
+
+- [上一章：编译选项](tsconfig.md)
+- [下一章：构建工具](build.md)
diff --git a/thanks/README.md b/thanks/README.md
