From c9d7f767bcc7c04fb8e8b8495a026dc16dedf8d5 Mon Sep 17 00:00:00 2001 From: zhongsp Date: Sat, 5 Dec 2015 20:04:21 +0800 Subject: [PATCH] Update Gitbook readme content --- preface.md | 80 ++++++++++++++++++++++++++++++++++-------------------- 1 file changed, 51 insertions(+), 29 deletions(-) diff --git a/preface.md b/preface.md index 010ca6e..bf57886 100644 --- a/preface.md +++ b/preface.md @@ -1,44 +1,66 @@ # TypeScript Handbook（中文版） -TypeScript让你以你想要的方式写JavaScript。 -TypeScript是具有类型的JavaScript的超集并可以编译成普通的JavaScript代码。 -支持任意浏览器，任意环境，任意系统并且开源。 +> 从前打心眼儿里讨厌编译成JavaScript的这类语言，像Coffee，Dart等。 +> 但是在15年春节前后却爱上了TypeScript。 +> 同时非常喜欢的框架Dojo，Angularjs也宣布使用TypeScript做新版本的开发。 +> 那么TypeScript究竟为何物？又有什么魅力呢？ TypeScript是Microsoft公司注册商标。 -## TypeScript语言规范 +TypeScript具有类型系统，且是JavaScript的超集。 +它可以编译成普通的JavaScript代码。 +TypeScript支持任意浏览器，任意环境，任意系统并且是开源的。 -Read [TypeScript Language Specification](https://github.com/Microsoft/TypeScript/blob/master/doc/spec.md) +TypeScript目前还在积极的开发完善之中，不断地会有新的特性加入进来。 +因此本手册也会紧随官方的每个commit，不断地更新新的章节以及修改措词不妥之处。 -## 使用Gulp和TypeScript +如果你对TypeScript一见钟情，可以订阅~~and star~~本手册，及时了解ECMAScript 2015以及2016里新的原生特性，并借助TypeScript提前掌握使用它们的方式！ +如果你对TypeScript的爱愈发浓烈，可以与楼主一起边翻译边学习，*[PRs Welcome!!!](https://github.com/zhongsp/TypeScript/pulls)* +在[相关链接](#相关链接)的末尾可以找到本手册的[Github地址](https://github.com/zhongsp/TypeScript)。 -安装 `gulp` 和 `gulp-typescript`. 查看 [package.json](./package.json). -```sh -$ npm install --global gulp -$ npm install --save-dev gulp gulp-typescript -``` +## 目录 -配置 gulp. 查看 [gulpfile.js](./gulpfile.js). +* [基础类型](./doc/handbook/Basic Types.md) +* [枚举](./doc/handbook/Enums.md) +* [变量声明](./doc/handbook/Variable Declarations.md) +* [接口](./doc/handbook/Interfaces.md) +* [类](./doc/handbook/Classes.md) +* [命名空间和模块](./doc/handbook/Namespaces and Modules.md) +* [命名空间](./doc/handbook/Namespaces.md) +* [模块](./doc/handbook/Modules.md) +* [函数](./doc/handbook/Functions.md) +* [泛型](./doc/handbook/Generics.md) +* [混入](./doc/handbook/Mixins.md) +* [声明合并](./doc/handbook/Declaration Merging.md) +* [类型推论](./doc/handbook/Type Inference.md) +* [类型兼容性](./doc/handbook/Type Compatibility.md) +* [书写.d.ts文件](./doc/handbook/Writing Definition Files.md) +* [Iterators 和 Generators](./doc/handbook/Iterators and Generators.md) +* [Symbols](./doc/handbook/Symbols.md) +* [Decorators](./doc/handbook/Decorators.md) -```js -gulp.task('typescript', function() { - var tsResult = gulp.src('ts/*.ts') - .pipe(ts({ - target: 'ES5', - declarationFiles: false, - noExternalResolve: true - })); - tsResult.dts.pipe(gulp.dest('dist/tsdefinitions')); +## 主要修改 - return tsResult.js.pipe(gulp.dest('dist/typescript')); -}); -``` +* 2015-12-05 新增章节：[变量声明：let和const](./doc/handbook/Variable Declarations.md) +* 2015-11-30 新增章节：[枚举](./doc/handbook/Enums.md) +* 2015-11-28 新增章节：[Decorators](./doc/handbook/Decorators.md) +* 2015-11-18 新增章节：[抽象类](./doc/handbook/Classes.md#抽象类) +* 2015-11-15 新增章节：[模块](./doc/handbook/Modules.md) -## 手册之外的主题 -* [tsconfig.json](https://github.com/zhongsp/TypeScript/tree/master/doc/doc/tsconfig.json.md) (TypeScript 1.5) -* [let和const](https://github.com/zhongsp/TypeScript/tree/master/doc/doc/let_and_const.md) (TypeScript 1.4) -* [元组类型 - Tuple Types](https://github.com/zhongsp/TypeScript/tree/master/doc/doc/tuple_types.md) (TypeScript 1.3) -* [受保护的成员 - Protected members](https://github.com/zhongsp/TypeScript/tree/master/doc/doc/protected.md) (TypeScript 1.3) +## 相关链接 + +* [TypeScript官网](http://typescriptlang.org) +* [TypeScript on Github](https://github.com/Microsoft/TypeScript) +* [TypeScript语言规范](https://github.com/Microsoft/TypeScript/blob/master/doc/spec.md) +* [本手册中文版Github地址](https://github.com/zhongsp/TypeScript) + + +## Miscellaneous + +* [tsconfig.json](https://github.com/zhongsp/TypeScript/tree/master/doc/tsconfig.json.md) (TypeScript 1.5) +* [let和const](https://github.com/zhongsp/TypeScript/tree/master/doc/let_and_const.md) (TypeScript 1.4) +* [元组类型 - Tuple Types](https://github.com/zhongsp/TypeScript/tree/master/doc/tuple_types.md) (TypeScript 1.3) +* [受保护的成员 - Protected members](https://github.com/zhongsp/TypeScript/tree/master/doc/protected.md) (TypeScript 1.3)