怎样使用GitBook.IO在线撰写书籍

2014年9月2日 | 分类: 【技术】

当Word格式的书稿沉睡在电脑中,而在线的博客或者Wiki却不忘更新。这就涉及到写作载体对写作进度,甚至产出的影响。

GitBook是一个命令行工具(Node.js库),我们可以借用该工具使用Github/Git和Markdown来制作精美的图书。

GitBook 支持使用多种语言构建书籍。

GitBook支持输出多种文档格式,如:

  • 静态站点:GitBook默认输出该种格式,生成的静态站点可直接托管搭载 Github Pages 服务上;
  • PDF:需要安装 gitbook-pdf 依赖;
  • eBook:需要安装 ebook-convert ;
  • 单HTML网页:支持将内容输出为单页的HTML,不过一般用在将电子书格式转换为PDF或eBook的中间过程;
  • JSON:一般用于电子书的调试或元数据提取。

使用GitBook制作电子书,必备两个文件:

  • README.md:为电子书的简介内容
  • SUMMARY.md:用来定义电子书章节结构

GitBook还支持嵌入JavaScript的交互式内容,未来版本会支持Python、Ruby等语言。

样例:

GitBook项目官网:

GitBook Github地址:

安装步骤:

1、Node.js安装:

Node.js 是一个基于Chrome JavaScript 运行时建立的一个平台, 用来方便地搭建快速的, 易于扩展的网络应用。Node.js 借助事件驱动, 非阻塞 I/O 模型变得轻量和高效, 非常适合 run across distributed devices 的 data-intensive的实时应用。

在Node.js官网(http://www.nodejs.org/)下载安装包并安装。

安装完成这后,你可以在终端模式下检验一下:

$ node -v
v0.10.29

看到这个提示,表示已成功安装上了Node.js。

2、Gitbook安装:

Gitbook是从NMP安装的,命令行:

$ npm install gitbook -g

安装完之后,你可以检验下是否安装成功:

$ gitbook -V
0.4.2

看到了与版本信息,表示已成功完装上了Gitbook。

3、calibre安装:

Calibre是一个开源的“一站式”的电子书解决方案,它可以全面满足你的电子书需求。Calibre是免费的,源代码开放,拥有跨平台的设计。Gitbook会使用其中的ebook-convert功能组件来完成书籍格式的转换。

在calibre官网(http://www.calibre-ebook.com/)下载安装包并安装。

这样,书籍制作工具GitBook安装完毕。