专栏名称: Sunbelife
三流程序员,一级小白鼠,二级强迫症,没事就爱瞎折腾。新浪微博:@Sunbelife
目录
相关文章推荐
科幻世界SFW  ·  呵护孩子的想象力,从这本杂志开始! ·  4 天前  
科幻世界SFW  ·  2025全球科幻奇幻包年看到爽,就订TA! ·  5 天前  
科幻世界SFW  ·  活动回顾 | AI时代,人类还能做什么? ·  1 周前  
51好读  ›  专栏  ›  Sunbelife

『发个教程』想尝试写本书玩玩?可能没你想的那么复杂

Sunbelife  · 公众号  ·  · 2018-01-14 07:30

正文

前言

你是不是一直想尝试写一本属于自己的书来玩玩?

可能没有你想的那么复杂。

或者你不想写书,但是有看书的习惯,每当看到 Kindle 或者 iBooks 中有许多排版糟糕的电子书,就想亲手把他们的排版整好?

可能也没有你想的那么复杂,你只需要一款叫作:「GitBook」的工具。

GitBook 是一款致力于文档编制、数码写作和出版的新型、简单的工具,你不仅可以使用它轻松实现多人同写一本书,同时还能保证优秀的排版风格。

本文内容包括 GitBook 的安装,使用,集成,书籍发布四个方面。

 安装 GitBook 之前

想安装 GitBook,首先需要安装一个 node.js,直接在 nodejs 官网根据你的系统及位数下载对应版本安装即可:

https://nodejs.org/en/download/

↑ (Win 选 .msi 的下载比较方便)

安装成功就是下面这个样子的,在终端或者 CMD 中输入 npm 会出现一大堆东西:

然后在 CMD 或者终端中输入以下命令,即可安装完成:

npm install gitbook-cli -g

由于网络的原因,安装的时间可能会较长一些,请耐心等待。

安装完成后可以输入以下命令,如果出现版本号说明安装成功啦。

gitbook -V

 使用

基本的用法并不复杂,一般来说需要两步:

1、使用 gitbook init 初始化书籍目录

2、使用 gitbook serve 编译书籍

下面使用一个简单直观的示例来介绍 Gitbook 的基本使用方法。

初始化书籍

想初始化书籍,可以直接输入:

gitbook init

它会自动生成 README.md 和 SUMMARY.md 两个文件,前者保存着对本书的介绍,后者是本书的目录结构。

编译 & 预览

书籍目录结构创建完成以后,就可以使用 gitbook serve 来编译和预览书籍了:

gitbook serve

gitbook serve 命令实际上会首先调用 gitbook build 编译书籍,完成以后会打开一个 web 服务器,监听在本地的 4000 端口。输入完命令之后就可以输入以下网址来查看书籍的效果了:

 http://localhost:4000

现在,gitbook 为我们创建了书籍目录结构,并且我们也学会了如何编译 & 预览,接下来就可以向其中添加真正的内容了,文件的编写使用 markdown 语法,所以你只需要把你的 markdown 文件放在书籍所在的目录,然后参考 SUMMARY.md 内目录的结构把文件添加进去,然后开始写东西就可以了。

当然,如果你开始就有一个大纲,也可以先在 SUMMARY.md 中把目录结构写好,然后输入 gitbook init,它会自动帮你创建相应的 .md 文件。在文件修改过程中,每一次保存文件,GitBook 都会自动重新编译,所以你可以持续通过浏览器来查看最新的书籍效果。

如果你觉得这个有点麻烦,你还可以下载 Gitbook 编辑器(http://www.gitbook.com/editor),实现所见即所得的编辑体验。

 图书输出

目前为止,Gitbook 支持如下输出:

· 静态 HTML,可以看作一个静态网站。(gitbook serve 之后就会自动生成)

· PDF 格式

· eBook 格式(Mobi & ePub)

· 单个 HTML 文件

· JSON 格式

我们这里把输出为 PDF 文件作为例子详细讲解下,eBook 的教程和这个一样。

首先你需要去 Calibre 官网下载并安装这个工具,因为输出 PDF 时需要用到其中的 ebook-convert 插件。

https://calibre-ebook.com/download

↑ 对应你的系统选择下载安装

macOS 或 Linux 用户安装完之后需要在终端中输入:

sudo ln -s /Applications/calibre.app/Contents/MacOS/ebook-convert /usr/local/bin

Windows 用户需要手动配置安装路径的环境变量。

然后在书籍所在的路径输入:

gitbook pdf

跑完一溜东西之后你就会发现,书籍目录中多了一个名为 book.pdf 的文件,导出就搞定啦。

聪明如你,肯定猜得出来 gitbook epub 就是导出 epub 的方法。

以上是 GitBook 工具的简单介绍,你可以按照这个操作快速上手并完成一些简单书籍的编写,实现写书梦,不过如果你还想获得更多关于 GitBook 的信息,也可以点击底部的阅读原文


Enjoy it.