最近在看一些使用 GitBook 制作的在线书,感觉不错,可以用来整理技术笔记,集结成书,还可以导出 PDF,EPUB,HTML 等多种格式。可惜现在gitbook网站无法注册,那自己来安装一个。
先了解一下:GitBook 是一个基于 Node.js 的命令行工具,可通过Node.js命令安装GitBook。使用 Github/Git 和 Markdown 来制作精美的电子书。如果需要本地生成pdf,mobi,epub等格式的书籍需要安装Calibre。目前GitBook 的使用方式分为离线和在线方式:
- 使用命令创建基本GitBook
- 使用网页在线编辑器创建、编辑GitBook。
- 使用GitBookEditor客户端创建、编辑GitBook。
最简单的使用方式是使用GitBook Editor编辑GitBook ,然后使用相关命令编译成功HTML。这次先使用命令创建基本的GitBook。下面记录了windows下gitbook安装过程。
1、下载并安装node
1)下载地址http://nodejs.cn/download/
2)下载后直接点击安装。一直点击下一步就可以了:
3)检查node安装是否成功。
在cmd输入
node
,输入console.log("Hello,World!");
出现如下所示,node安装成功。 也可以输入node -v查看node.js版本,说明安装成功了。
2、用cnpm命令安装gitbook-cli
在系统上使用gitbook命令,需要安装“gitbook CLI”,执行以下命令
//安装命令
npm install -g gitbook-cli
//卸载命令
npm uninstall -g gitbook
但npm的服务器在境外,安装cnpm后安装软件速度会更快,用下述命令可将npm指向国内镜像源:
npm install cnpm -g --registry=https://registry.npm.taobao.org
然后,用cnpm命令安装gitbook-cli,cnpm install -g gitbook-cli
3、创建自己的gitbook目录并初始化
1)创建自己的gitbook目录,mkdir d:\gitbook
2)进入自己的gitbook目录下,初始化gitbook,输入gitbook init
3)初始化后,生成HTML发布,输入gitbook build
4、启动gitbook服务
在cmd中输入gitbook serve
,启动gitbook服务:
在浏览器访问:http://127.0.0.1:4000,就可以看到自己的电子书了!
注:启动服务前可以修改README.md,和SUMMARY.md,增加自己的markdown文件。