GitBook tutorial

运行

gitbook --port 4001 --lrport 35730 serve

再访问

http://127.0.0.1:4001/

教程 http://www.chengweiyang.cn/gitbook/basic-usage/README.html

安装

macos:

brew update

brew install node

npm install gitbook-cli -g

使用

1. gitbook init 生成文件

README.md
SUMMARY.md

2. 修改summary用来定义目录

* [Introduction](README.md)
* [gitbook](gitbook tutorial.md)
* [Chapter1](chapter1/README.md)
    * [Section1.1](chapter1/section1.1.md)
        * [Section1.1.1](chapter1/section1.1/section1.1.1.md)
    * [Section1.2](chapter1/section1.2.md)
* [Chapter2](chapter2/README.md)

修改完summary之后

gitbook init

会重新生成目录树，和对应的md文件

3. 运行服务器

gitbook serve

4. 多端口

https://huataihuang.gitbooks.io/cloud-atlas/develop/doc/gitbook/run_multi_gitbook_in_one_host.html

PS G:\GitHub Repositories\gitbooknotes>  gitbook serve                                                                  
... Uhoh. Got error listen EADDRINUSE: address already in use :::35729 ...
Error: listen EADDRINUSE: address already in use :::35729
    at Server.setupListenHandle [as _listen2] (net.js:1313:16)
    at listenInCluster (net.js:1361:12)
    at Server.listen (net.js:1447:7)
    at Server.listen (C:\Users\baica\.gitbook\versions\3.2.3\node_modules\tiny-lr\lib\server.js:164:15)
    at Promise.apply (C:\Users\baica\.gitbook\versions\3.2.3\node_modules\q\q.js:1165:26)
    at Promise.promise.promiseDispatch (C:\Users\baica\.gitbook\versions\3.2.3\node_modules\q\q.js:788:41)
    at C:\Users\baica\.gitbook\versions\3.2.3\node_modules\q\q.js:1391:14
    at runSingle (C:\Users\baica\.gitbook\versions\3.2.3\node_modules\q\q.js:137:13)
    at flush (C:\Users\baica\.gitbook\versions\3.2.3\node_modules\q\q.js:125:13)
    at processTicksAndRejections (internal/process/task_queues.js:79:11)

You already have a server listening on 35729
You should stop it and try again.

运行

gitbook --port 4001 --lrport 35730 serve

再访问

http://127.0.0.1:4001/

5. win10不能热加载

https://www.jianshu.com/p/7b107dfb7522 拖到最后

即启动服务后立即删除 _book 目录