GitBook安装试用

想找个可以通过Git来管理的文档工具，发现GitBook或许是个不错的选择，决定试用一下。

1. 安装Nodejs

http://nodejs.cn/download/

我下载的是Windows 64位zip包，下载解压后设置环境变量。

setx path "C:\swdtool\node-v8.11.1-win-x64;"

新开一个cmd输入npm，提示帮助文档，说明设置没问题。

2. 安装Gitbook

npm install gitbook-cli -g

查看版本

gitbook -V

自动就Installing了，还以为要npm install gitbook -g。

再次查看版本gitbook -V，反应正常了。

3. 安装GitBook Editor

我是这里下载的。

http://mac.softpedia.com/get/Word-Processing/GitBook-Editor.shtml

4. GitBook Editor New Book

 

打开GitBook Editor，想在Local玩玩，所以先不注册，选Logon later，进入主界面，可以看到New Book按钮，默认路径在

    <user>\GitBook\Library\Import

默认路径可以修改，但有个小问题（version: 7.0.8），如当选d:/feng/， New Book test，最终test文件夹却在d:/feng/Import/test

 

修改SUMMARY.md的内容如下：

#
Summary

* [前言](README.md)
* [第一章 微服务](ch1/ch1.md)

命令行cd到test

gitbook serve

访问http://localhost:4000/，则可看到编辑目录后的效果。

 

4. 从命令行新建

也可从命令行创建新书。

gitbook init

生成如下两个文件：README.md，SUMMARY.md

gitbook serve

浏览效果。

但要导入GitBook Editor，还要转成Git repository， 而且把Library Path改成工程的父目录，即d:/feng

git init

git add -A

git commit -m "init project"