pagic 0.7.22

xcatliu · xcatliu · commit e8bc8a61a55f · 2020-07-02T22:29:45.000+08:00
diff --git a/.github/workflows/gh-pages.yml b/.github/workflows/gh-pages.yml
@@ -17,7 +17,7 @@ jobs:
           export DENO_INSTALL="/home/runner/.deno"
           export PATH="$DENO_INSTALL/bin:$PATH"
           deno --version
-          deno install --unstable --allow-read --allow-write --allow-net -n pagic https://deno.land/x/pagic@0.7.19/mod.ts
+          deno install --unstable --allow-read --allow-write --allow-net -n pagic https://deno.land/x/pagic@0.7.22/mod.ts
           pagic build
 
       - name: Deploy
diff --git a/README.md b/README.md
@@ -1,3 +1,9 @@
+---
+next:
+  text: 简介
+  link: introduction/index.html
+---
+
 # TypeScript 入门教程
 
 [![Actions Status](https://github.com/xcatliu/typescript-tutorial/workflows/gh-pages/badge.svg)](https://github.com/xcatliu/typescript-tutorial/actions)
@@ -7,10 +13,10 @@
 ## 关于本书
 
 - [在线阅读](https://ts.xcatliu.com/)
-- [在线阅读（GitHub 版）](https://github.com/xcatliu/typescript-tutorial/blob/master/README.md)
 - [GitHub 地址][GitHub]
 - 作者：[xcatliu](https://github.com/xcatliu/)
-- 官方 QQ 群：[加入 QQ 群 767142358](https://jq.qq.com/?_wv=1027&k=5nkkFCl)
+- [加入官方 QQ 群 767142358](https://jq.qq.com/?_wv=1027&k=5nkkFCl)
+- 本网站使用 [Pagic](https://github.com/xcatliu/pagic) 构建
 
 本书是作者在学习 [TypeScript] 后整理的学习笔记。
 
@@ -54,39 +60,6 @@ TypeScript 虽然有[官方手册][Handbook]及其[非官方中文版][中文手
 >
 > —— [阮一峰](https://github.com/ruanyf)
 
-## 目录
-
-- [前言](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)
-- [工程](engineering/README.md)
-  - [代码检查](engineering/lint.md)
-  - [编译选项](engineering/compiler-options.md)
-- [感谢](thanks/README.md)
-
 ## 版权许可
 
 本书采用「保持署名—非商用」创意共享 4.0 许可证。
@@ -101,10 +74,6 @@ TypeScript 虽然有[官方手册][Handbook]及其[非官方中文版][中文手
 - [Handbook]（[中文版][中文手册]）
 - [ECMAScript 6 入门]
 
----
-
-- [下一章：简介](introduction/README.md)
-
 [GitHub]: https://github.com/xcatliu/typescript-tutorial
 [TypeScript]: http://www.typescriptlang.org/
 [Handbook]: http://www.typescriptlang.org/docs/handbook/basic-types.html
diff --git a/advanced/README.md b/advanced/README.md
@@ -11,8 +11,3 @@
 - [泛型](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
@@ -235,8 +235,3 @@ let p2: PointInstanceType;
 ## 参考
 
 - [Interfaces](http://www.typescriptlang.org/docs/handbook/interfaces.html)（[中文版](https://zhongsp.gitbooks.io/typescript-handbook/content/doc/handbook/Interfaces.html)）
-
----
-
-- [上一章：类](class.md)
-- [下一章：泛型](generics.md)
diff --git a/advanced/class.md b/advanced/class.md
@@ -450,8 +450,3 @@ console.log(a.sayHi()); // My name is Jack
 - [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
@@ -95,8 +95,3 @@ interface Alarm {
 ## 参考
 
 - [Declaration Merging](http://www.typescriptlang.org/docs/handbook/declaration-merging.html)（[中文版](https://zhongsp.gitbooks.io/typescript-handbook/content/doc/handbook/Declaration%20Merging.html)）
-
----
-
-- [上一章：泛型](generics.md)
-- [下一章：扩展阅读](further-reading.md)
diff --git a/advanced/enum.md b/advanced/enum.md
@@ -233,8 +233,3 @@ var directions = [0 /* Up */, 1 /* Down */, 2 /* Left */, 3 /* Right */];
 
 [中文手册 - 枚举]: https://zhongsp.gitbooks.io/typescript-handbook/content/doc/handbook/Enums.html
 [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
@@ -20,8 +20,3 @@
 - [Namespaces](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)
 - [Mixins](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)
-- [下一章：工程](../engineering/README.md)
diff --git a/advanced/generics.md b/advanced/generics.md
@@ -220,8 +220,3 @@ function createArray<T = string>(length: number, value: T): Array<T> {
 
 - [Generics](http://www.typescriptlang.org/docs/handbook/generics.html)（[中文版](https://zhongsp.gitbooks.io/typescript-handbook/content/doc/handbook/generics.html)）
 - [Generic parameter defaults](https://www.typescriptlang.org/docs/handbook/release-notes/typescript-2-3.html#generic-parameter-defaults)
-
----
-
-- [上一章：类与接口](class-and-interfaces.md)
-- [下一章：声明合并](declaration-merging.md)
diff --git a/advanced/string-literal-types.md b/advanced/string-literal-types.md
@@ -23,8 +23,3 @@ handleEvent(document.getElementById('world'), 'dblclick'); // 报错，event 不
 ## 参考
 
 - [Advanced Types # Type Aliases](http://www.typescriptlang.org/docs/handbook/advanced-types.html#string-literal-types)（[中文版](https://zhongsp.gitbooks.io/typescript-handbook/content/doc/handbook/Advanced%20Types.html#字符串字面量类型)）
-
----
-
-- [上一章：类型别名](type-aliases.md)
-- [下一章：元组](tuple.md)
diff --git a/advanced/tuple.md b/advanced/tuple.md
@@ -60,8 +60,3 @@ tom.push(true);
 ## 参考
 
 - [Basic Types # Tuple](http://www.typescriptlang.org/docs/handbook/basic-types.html#tuple)（[中文版](https://zhongsp.gitbooks.io/typescript-handbook/content/doc/handbook/Basic%20Types.html#元组-tuple)）
-
----
-
-- [上一章：字符串字面量类型](string-literal-types.md)
-- [下一章：枚举](enum.md)
diff --git a/advanced/type-aliases.md b/advanced/type-aliases.md
@@ -24,8 +24,3 @@ function getName(n: NameOrResolver): Name {
 ## 参考
 
 - [Advanced Types # Type Aliases](http://www.typescriptlang.org/docs/handbook/advanced-types.html#type-aliases)（[中文版](https://zhongsp.gitbooks.io/typescript-handbook/content/doc/handbook/Advanced%20Types.html#类型别名)）
-
----
-
-- [上一章：进阶](../advanced/README.md)
-- [下一章：字符串字面量类型](string-literal-types.md)
diff --git a/basics/README.md b/basics/README.md
@@ -12,8 +12,3 @@
 - [类型断言](type-assertion.md)
 - [声明文件](declaration-files.md)
 - [内置对象](built-in-objects.md)
-
----
-
-- [上一章：Hello TypeScript](../introduction/hello-typescript.md)
-- [下一章：原始数据类型](primitive-data-types.md)
diff --git a/basics/any.md b/basics/any.md
@@ -66,8 +66,3 @@ something.setName('Tom');
 ## 参考
 
 - [Basic Types # Any](http://www.typescriptlang.org/docs/handbook/basic-types.html#any)（[中文版](https://zhongsp.gitbooks.io/typescript-handbook/content/doc/handbook/Basic%20Types.html#任意值)）
-
----
-
-- [上一章：原始数据类型](primitive-data-types.md)
-- [下一章：类型推论](type-inference.md)
diff --git a/basics/built-in-objects.md b/basics/built-in-objects.md
@@ -103,8 +103,3 @@ npm install @types/node --save-dev
 
 [内置对象]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects
 [TypeScript 核心库的定义文件]: https://github.com/Microsoft/TypeScript/tree/master/src/lib
-
----
-
-- [上一章：声明文件](declaration-files.md)
-- [下一章：进阶](../advanced/README.md)
diff --git a/basics/declaration-files.md b/basics/declaration-files.md
@@ -1150,9 +1150,4 @@ pull-request 需要符合它们的规范，并且通过测试，才能被合并
 - [typeRoots or paths](https://github.com/Microsoft/TypeScript/issues/22217#issuecomment-369783776)
 - [DefinitelyTyped][]
 
----
-
-- [上一章：类型断言](type-assertion.md)
-- [下一章：内置对象](built-in-objects.md)
-
 [DefinitelyTyped]: https://github.com/DefinitelyTyped/DefinitelyTyped/
diff --git a/basics/primitive-data-types.md b/basics/primitive-data-types.md
@@ -149,11 +149,6 @@ let num: number = u;
 - [ES6 中的二进制和八进制表示法][]
 - [ES6 中的模板字符串][]
 
----
-
-- [上一章：基础](README.md)
-- [下一章：任意值](any.md)
-
 [Primitive data types]: https://developer.mozilla.org/en-US/docs/Glossary/Primitive
 [ES6 中的新类型 `Symbol`]: http://es6.ruanyifeng.com/#docs/symbol
 [ES6 中的二进制和八进制表示法]: http://es6.ruanyifeng.com/#docs/number#二进制和八进制表示法
diff --git a/basics/type-assertion.md b/basics/type-assertion.md
@@ -597,10 +597,5 @@ tom.run();
 - [Advanced Types # Type Guards and Differentiating 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）)）
 - [TypeScript 的设计理念][]
 
----
-
-- [上一章：函数的类型](type-of-function.md)
-- [下一章：声明文件](declaration-files.md)
-
 [TypeScript 的设计理念]: https://github.com/Microsoft/TypeScript/wiki/TypeScript-Design-Goals
 [泛型]: ../advanced/generics.md
diff --git a/basics/type-inference.md b/basics/type-inference.md
@@ -35,8 +35,3 @@ myFavoriteNumber = 7;
 ## 参考
 
 - [Type Inference](http://www.typescriptlang.org/docs/handbook/type-inference.html)（[中文版](https://zhongsp.gitbooks.io/typescript-handbook/content/doc/handbook/Type%20Inference.html)）
-
----
-
-- [上一章：任意值](any.md)
-- [下一章：联合类型](union-types.md)
diff --git a/basics/type-of-array.md b/basics/type-of-array.md
@@ -114,8 +114,3 @@ let list: any[] = ['xcatliu', 25, { website: 'http://xcatliu.com' }];
 
 - [Basic Types # Array](http://www.typescriptlang.org/docs/handbook/basic-types.html#array)（[中文版](https://zhongsp.gitbooks.io/typescript-handbook/content/doc/handbook/Basic%20Types.html#数组)）
 - [Interfaces # Indexable Types](http://www.typescriptlang.org/docs/handbook/interfaces.html#indexable-types)（[中文版](https://zhongsp.gitbooks.io/typescript-handbook/content/doc/handbook/Interfaces.html#数组类型)）
-
----
-
-- [上一章：对象的类型——接口](type-of-object-interfaces.md)
-- [下一章：函数的类型](type-of-function.md)
diff --git a/basics/type-of-function.md b/basics/type-of-function.md
@@ -225,8 +225,3 @@ function reverse(x: number | string): number | string {
 [ES6 中的箭头函数]: http://es6.ruanyifeng.com/#docs/function#箭头函数
 [ES6 中函数参数的默认值]: http://es6.ruanyifeng.com/#docs/function#函数参数的默认值
 [ES6 中的 rest 参数]: http://es6.ruanyifeng.com/#docs/function#rest参数
-
----
-
-- [上一章：数组的类型](type-of-array.md)
-- [下一章：类型断言](type-assertion.md)
diff --git a/basics/type-of-object-interfaces.md b/basics/type-of-object-interfaces.md
@@ -223,8 +223,3 @@ tom.id = 89757;
 ## 参考 
 
 - [Interfaces](http://www.typescriptlang.org/docs/handbook/interfaces.html)（[中文版](https://zhongsp.gitbooks.io/typescript-handbook/content/doc/handbook/Interfaces.html)）
-
----
-
-- [上一章：联合类型](union-types.md)
-- [下一章：数组的类型](type-of-array.md)
diff --git a/basics/union-types.md b/basics/union-types.md
@@ -64,8 +64,3 @@ console.log(myFavoriteNumber.length); // 编译时报错
 ## 参考
 
 - [Advanced Types # Union Types](http://www.typescriptlang.org/docs/handbook/advanced-types.html#union-types)（[中文版](https://zhongsp.gitbooks.io/typescript-handbook/content/doc/handbook/Advanced%20Types.html#联合类型)）
-
----
-
-- [上一章：类型推论](type-inference.md)
-- [下一章：对象的类型——接口](type-of-object-interfaces.md)
diff --git a/engineering/README.md b/engineering/README.md
@@ -8,8 +8,3 @@
 
 - [代码检查](lint.md)
 - [编译选项](compiler-options.md)
-
----
-
-- [上一章：扩展阅读](../advanced/further-reading.md)
-- [下一章：代码检查](lint.md)
diff --git a/engineering/compiler-options.md b/engineering/compiler-options.md
@@ -74,8 +74,3 @@ import React from 'react';
 ```
 
 解决办法就是将 `allowSyntheticDefaultImports` 设置为 `true`。
-
----
-
-- [上一章：代码检查](./lint.md)
-- [下一章：感谢](../thanks/README.md)
diff --git a/engineering/lint.md b/engineering/lint.md
@@ -443,8 +443,3 @@ npm install --save-dev eslint-plugin-react
 
 [ESLint]: https://eslint.org/
 [typescript-eslint]: https://github.com/typescript-eslint/typescript-eslint
-
----
-
-- [上一章：工程](README.md)
-- [下一章：编译选项](./compiler-options.md)
diff --git a/introduction/README.md b/introduction/README.md
@@ -1,12 +1,13 @@
+---
+previous:
+  text: TypeScript 入门教程
+  link: index.html
+---
+
 # 简介
 
 本部分介绍了在学习 TypeScript 之前需要了解的知识，具体内容包括：
 
 - [什么是 TypeScript](what-is-typescript.md)
 - [安装 TypeScript](get-typescript.md)
 - [Hello TypeScript](hello-typescript.md)
-
----
-
-- [上一章：前言](../README.md)
-- [下一章：什么是 TypeScript](what-is-typescript.md)
diff --git a/introduction/get-typescript.md b/introduction/get-typescript.md
@@ -38,8 +38,3 @@ TypeScript 最大的优势便是增强了编辑器和 IDE 的功能，包括代
 - [Eclipse](https://github.com/palantir/eclipse-typescript)
 - [Visual Studio 2015](https://www.microsoft.com/en-us/download/details.aspx?id=48593)
 - [Visual Studio 2013](https://www.microsoft.com/en-us/download/details.aspx?id=48739)
-
----
-
-- [上一章：什么是 TypeScript](what-is-typescript.md)
-- [下一章：Hello TypeScript](hello-typescript.md)
diff --git a/introduction/hello-typescript.md b/introduction/hello-typescript.md
@@ -67,8 +67,3 @@ console.log(sayHello(user));
 **TypeScript 编译的时候即使报错了，还是会生成编译结果**，我们仍然可以使用这个编译之后的文件。
 
 如果要在报错的时候终止 js 文件的生成，可以在 `tsconfig.json` 中配置 `noEmitOnError` 即可。关于 `tsconfig.json`，请参阅[官方手册](http://www.typescriptlang.org/docs/handbook/tsconfig-json.html)（[中文版](https://zhongsp.gitbooks.io/typescript-handbook/content/doc/handbook/tsconfig.json.html)）。
-
----
-
-- [上一章：安装 TypeScript](get-typescript.md)
-- [下一章：基础](../basics/README.md)
diff --git a/introduction/what-is-typescript.md b/introduction/what-is-typescript.md
@@ -48,8 +48,3 @@
 大家可以根据自己团队和项目的情况判断是否需要使用 TypeScript。
 
 [TypeScript]: http://www.typescriptlang.org/
-
----
-
-- [上一章：简介](README.md)
-- [下一章：安装 TypeScript](get-typescript.md)
diff --git a/pagic.config.tsx b/pagic.config.tsx
@@ -7,6 +7,8 @@ export default {
   theme: 'docs',
   plugins: ['sidebar', 'script', 'gitalk', 'ga'],
   title: 'TypeScript 入门教程',
+  description: '从 JavaScript 程序员的角度总结思考，循序渐进的理解 TypeScript。',
+  github: 'https://github.com/xcatliu/typescript-tutorial',
   head: <link rel="icon" type="image/png" href="/favicon.png" />,
   nav: [
     {
@@ -19,12 +21,6 @@ export default {
           <img src="/assets/alipay.jpg" width="256" style={{ verticalAlign: 'top' }} />
         </>
       )
-    },
-    {
-      text: 'GitHub',
-      link: 'https://github.com/xcatliu/typescript-tutorial',
-      target: '_blank',
-      align: 'right'
     }
   ],
   sidebar: [
diff --git a/thanks/README.md b/thanks/README.md
@@ -12,8 +12,3 @@
 - 阅读[官方手册](http://www.typescriptlang.org/docs/handbook/basic-types.html)（[中文版](https://zhongsp.gitbooks.io/typescript-handbook/content/)）巩固知识
 - 阅读 [Project Configuration](http://www.typescriptlang.org/docs/handbook/tsconfig-json.html)（[中文版](https://zhongsp.gitbooks.io/typescript-handbook/content/doc/handbook/tsconfig.json.html)） 学习如何配置 TypeScript 工程
 - 查看[官方示例](http://www.typescriptlang.org/samples/index.html)，学习真实项目
-
-
----
-
-- [上一章：代码检查](../engineering/lint.md)
