工作以来一直有些博客的习惯,除了在各大站长写博客外,还可以使用 gitbook 将博客整理成电子书出版,如果受到好评还可以将图书弄成电子版出版。
经过近半年的整理,我的新书《React Native移动开发实战》就要发售了,提前打个广告,书名和封面样式还在确认中,也欢迎大家给出好的点子。
今天要给大家说的是如何利用GitBook编写一本属于自己的点子书。
1,GitBook Editor
首先到官网下载GitBook Editor,目前支持Mac、Linux、Windows主流平台。
安装完成之后,使用github账号直接登录(GitBook提供了四种方式登录,这里直接使用gitHub登录,后面会用到)。登录后,可以直接在gitbook上创建书籍,建议在gitbook网站上创建书籍,然后通过GitBook Editor clone 下来;
创建完成时候,就可以写书了,不过建议先clone到本地后在写,主要是有时候网络等问题造成不必要的损失。
注意:此时的GitBook的book页面默认没有download按钮的,需要做如下的设置。点击Settting设置打开E-Books选项
2,同步GitHub
如果没有github账号,先注册,之后绑定github账号。然后依次点击Setting->github,进行相关的设置即可。
安装完成之后,就可以关联github了,先在github上创建一个项目,然后再关联,第一次关联可能会有如下的错误:
点击GitBook或者GitHub下面的链接按钮即可关联上了。
然后我们添加一篇文章,在gitBook上点击Updates按钮。
注意:如果碰到,更新失败,无法转换成pdf/mobi/epub格式。
PS:如果涉及到多人协作还可能会涉及其他问题,这里不多介绍。
3,安装Node环境
首先我们需要安装的是Nodejs,关于Node 环境的搭建这里不再详述,做过前端开发的通信应该不糊陌生。node安装完成之后,就可以现在GitBook全局环境了。
4,全局安装 gitbook
现在我们可以开始安装全局的 gitbook 了。执行 命令,进行安装。
安装完成之后,可以使用命令来查看是否安装成功。
关于GitBook相关的教程,读者可以参考:GitBook教程
PS:gitbook 常用的命令如下:
5,GitBook使用
此部分没有试验,来自网络:
gitbook serve
gitbook ls
gitbook ls-remote
gitbook -V
新建一个GitBook项目后,系统会默认新建几个文件:README.md、SUMMARY.md和chapter1.md。README.md相当于简介,SUMMARY.md:相当于这本书的目录,
6,calibre
首先到calibre官网下载对应的版本并安装,打开后界面如下:
gitbook-convert
把docx、xml、html、odt文档转成GitBook,首先需要安装gitbook-convert插件。
如果需要转换,可以使用下面的命令:
7,常用插件
Gitbook 插件 里已经有100多个插件,可以在 book.json 文件的 plugins 和 pluginsConfig 字段添加插件及相关配置,添加后别忘了进行安装。例如:
然后使用gitbook install安装插件。
更多插件的使用请参考:GitBook使用教程