Windows上使用gitbook制作电子书

• 0. 前言

 

第一次在windows上使用gitbook制作电子书，在网上搜了好多资料，自己亲手试了下并整理如下。

 

• 1. 准备工具

 

Step1: 下载nodejs(nodejs中文官方): http://nodejs.cn/download/， 点击图片位置：

 

 

 

 

 

• 2. 安装工具

 

Step1: 安装nodejs，默认也把npm勾选安装了，选择安装路径，例如：D:\Program Files\nodejs\。

Step2: 安装完成后，查看环境变量path，应该已经自动添加了D:\Program Files\nodejs\

 

Step3: 执行npm -version可以查看版本，如下图：

 

Step4: 下载gitbook工具：输入命令:   npm install gitbook-cli -g , 全局安装gitbook。

 

由于安装过程默认使用国外镜像，可以考虑切换国内镜像。

打开D:\Program Files\nodejs\node_modules\npm\npmrc文件，增加配置：

registry=http://registry.npm.taobao.org

 

 

Step5: 查看gitbook工具是否已经安装成功，可以查看版本：gitbook -V

如果在版本下面出现Installing GitBook xxx，说明此时gitbook还未安装成功，会自动安装gitbook

 

 

• 3. 制作电子书(静态网页)

 

Step1: 请先建立一个文件夹，例如E:\xx\gitbook\mybook_test

Step2: 将README.md和SUMMARY.md放到mybook_test下，注意要用md工具编辑，否则可能后面生产的book存在中文乱码。

Step3: 初始化。在mybook_test目录执行：gitbook init。目录下会自动生成一些目录和文件夹。

Step4: 启动浏览器查看。在E:\xx\gitbook目录执行：gitbook serve ./mybook_test，如下：

Step5: 现在可以再浏览器查看了：http://localhost:4000/

 

 

• 4. 制作PDF

 

Step1: 下载gitbook pdf。在E:\Program Files\Node目录执行：npm install gitbook -g

Step2: 上面一步会出错，貌似因为被墙了，下载不到phantomjs相关文件。可以直接到这个网页下载：http://phantomjs.org/download.html

 

Step3: 讲压缩包解压到某个目录，如：E:\Program Files\phantomjs，并将此目录添加到系统变量path中。

Step4: 下载ebook-convert，直接到http://www.calibre-ebook.com/download_windows下载：

Step5: 直接安装软件，并在将安装目录添加到系统path中，默认安装在：C:\Program Files (x86)\Calibre2

Step6: 生成PDF文件，在电子书存档目录，如：E:\xx\gitbook\mybook_test执行 gitbook pdf .或者上一级目录执行gitbook pdf ./mybook_test

Step7: book.pdf生成在mybook_test目录里面。

 

 

• 5. 遗留问题

 

将电子书publish到Git上