半途记●我是如何使用gitbook发布电子书的

目的:使用gitbook发布一本电子书(把一本实体书转换为电子书),能够在web访问。

门槛:
1.对github以及git工具起码有一知半解
2.能够或者已经在gitbook.com创建自己的organization和space
3.知道如何把第二步的内容和github的repository进行集成
4.你的电脑已经安装nodejs
5.对我的文章内容有是非黑白是不是胡说八道的辨别能力哈哈哈
具备上述条件,就可以继续往下看了。

然鹅我的星途起点是,电脑很久之前装的npm和git,然后直接从gitbook.com注册了账号并且下载了一个windows版本的gitbook编辑器“Gitbook editor”,看起来是这样的:

然后就开始+new book开始加入标题章节开始写书了,写完了save然后publish,然后输入github创建的repository地址就提交成功了,看起来是这样的:

好像还不错。可是怎么没有分享功能呢,于是查了资料,说要搞一个book.json,然后在项目目录添加,可是怎么也不好死,一点也不好死。。。

后来找到了这篇文章:https://zhaoda.net/2015/11/09/gitbook-plugins/
然后一路

1
2
3
npm install gitbook-cli -g
gitbook init
gitbook serve

gitbook serve 若失败的话可能是端口占用,然鹅我直接使用另外的端口启动

1
2
gitbook serve --port 5000
gitbook build

gitbook build出错的话根据错误提示若未安装各种plugins,则先执行gitbook install,同样配置完成book.json之后也要gitbook install一下。

运行完成之后就可以访问http://localhost:5000了