GitBook 制作电子书详细教程(搭建gitbook)

推荐整理分享GitBook 制作电子书详细教程(搭建gitbook)，希望有所帮助，仅作参考，欢迎阅读内容。

文章相关热门搜索词:搭建gitbook,搭建gitbook,gitbook生成html,gitbook生成html,gitbook怎么用,gitbook生成pdf,gitbook怎么用,gitbook 在线编辑,内容如对您有帮助，希望把文章链接给更多的朋友！

gitbook安装：

下载node.js源代码（点击绿色的INSTALL），

解压

成功执行后，npm就被安装好了。

2. gitbook 安装命令

查看gitbook是否安装成功。

ref

===

1. wanqingwong.com/gitbook-zh/index.html

gitbook使用

===========

1. 根据目录生成图书结构

1.1 README.md 与 SUMMARY编写

README.md

这个文件相当于一本Gitbook的简介。

SUMMARY.md

这个文件是一本书的目录结构，使用Markdown语法，

如我们这本书的SUMMARY.md：

输入

* [简介](README.md)* [第一章](chapter1/README.md) - [第一节](chapter1/section1.md) - [第二节](chapter1/section2.md)* [第二章](chapter2/README.md) - [第一节](chapter2/section1.md) - [第二节](chapter2/section2.md)* [结束](end/README.md)

1.2 生成图书结构

当这个目录文件创建好之后，我们可以使用Gitbook

的命令行工具将这个目录结构生成相应的目录及文件：

├── chapter1│ ├── README.md│ ├── section1.md│ └── section2.md├── chapter2│ ├── README.md│ ├── section1.md│ └── section2.md├── end│ └── README.md├── README.md└── SUMMARY.md

我们可以看到，gitbook给我们生成了与SUMMARY.md所对应的目录及文件。

每个目录中，都有一个README.md文件，相当于一章的说明。

2. 生成图书

2.1 输出为静态网站

你有两种方式输出一个静态网站：

2.1.1 本地预览时自动生成

当你在自己的电脑上编辑好图书之后，你可以使用Gitbook的命令行进行本地预览：

然后浏览器中输入：

这样就可以预览生成的以网页形式组织的书籍。

这里你会发现，你在你的图书项目的目录中多了一个名为_book的文件目录，而这个目录中的文件，即是生成的静态网站内容。

使用build参数生成到指定目录

与直接预览生成的静态网站文件不一样的是，使用这个命令，你可以将内容输入到你所想要的目录中去：

2.2 输出PDF

输入为PDF文件，需要先使用NPM安装上gitbook pdf：

我在执行上面这条命令的时候出现了下面的错误：

***************************************************

***************************************************

由错误报告内容的第一行可以知道，发生错误的原因是下载

phantomjs发生了错误，因此我们需要手动下载和安装。

解决方法：[1]

然后，使用下面的命令，要PDF文件，首先安装依赖库：

发生错误：

*****************************************************

*****************************************************

解决方法[2]

ref

===

问题

===

1. 如果输入gitbook init命令，出现Installing version 2.1.0，

需要耐性等待安装。