想找个可以通过Git来管理的文档工具,发现GitBook或许是个不错的选择,决定试用一下。
1. 安装Nodejs
我下载的是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"