win10使用gitbook

win10使用gitbook

1. 新建一个目录如：d:\mybook
   在该目录下，执行 gitbook init 命令初始化

C:\Windows\system32>cd /d d:\mybook
d:\mybook>gitbook init

然后在该目录多出两个文件
README.md —— 书籍的介绍写在这个文件里
SUMMARY.md —— 书籍的目录结构在这里配置

2. 使用Typora来编辑 SUMMARY.md ，内容如下

# 目录

* [前言](README.md)
* [第一章 我是第一章的标题](Chapter1/第一章我是第一章的标题.md)
  * [第1节：我是第1节的标题](Chapter1/我是第1节的标题.md)
  * [第2节：我是第2节的标题](Chapter1/我是第2节的标题.md)
  * [第3节：我是第3节的标题](Chapter1/我是第3节的标题.md)
  * [第4节：我是第4节的标题](Chapter1/我是第4节的标题.md)
* [第二章 我是第二章的标题](Chapter2/第二章我是第二章的标题.md)
* [第三章 我是第三章的标题](Chapter3/第三章我是第三章的标题.md)
* [第四章 我是第四章的标题](Chapter4/第三章我是第三章的标题.md)

3. 再次执行gitbook init 命令初始化篇章，根据SUMMARY.md描述的目录和md文件，自动创建目录及对应md文件
   d:\mybook>gitbook init

4. 使用Typora来编辑对应目录的md文件 ，也就是根据我们设计的章节目录，来编写内容

5. 在mybook目录下执行gitbook build命令构建书籍，默认将生成的静态网站输出到_book目录
   d:\mybook>gitbook build

6. 此时生成的静态网站是无法在章节间点击跳转的 ，需要编辑D:\mybook\_book\gitbook\theme.js
   将if(m)改为if(false)
   此时章节间点击跳转OK了

7. 在mybook目录下执行gitbook serve ，在本地临时搭建网站查看
   d:\mybook>gitbook serve
   使用浏览器打开http://localhost:4000/即可查看网站内容
   当然也可以指定端口 gitbook serve --port 8080
   d:\mybook>gitbook serve --port 8080