gitbook install convert pdf and build

Reference:http://blog.csdn.net/q312998164/article/details/43278177

gitboo build by node.js support ruby,python..

Mac下GitBook制作电子书

1、安装npm（Node Package Manager）。从node.js的官网上下载安装程序，即可完成Node.js和npm的安装。

2、通过npm安装Gitbook。

[plain] view plain copy 在CODE上查看代码片派生到我的代码片

$ npm install gitbook -g

3、https://github.com/GitbookIO/editor/releases 下载gitbook-mac.dmg也就是gitbook editor。

4、创建一个 Simple Book(或者其他的也可以），必须放在空文件夹中。

5、文件夹下就会出现Gitbook需要2个基本文件：README.md和SUMMARY.md，还有个_book文件夹（稍后介绍），README.md是关于你的书的介绍，而SUMMARY.md中则包含了书目，即章节结构。

6、在浏览器中查看：

[plain] view plain copy 在CODE上查看代码片派生到我的代码片

$ gitbook serve -p 8080

Gitbook首先把你的Markdown文件编译为HTML文件，并根据SUMMARY.md生成书的目录。所有生存的文件都保存在当前目录下的一个名为_book的子目录中。完成这些工作后，Gitbook会作为一个HTTP Server运行，并在8080端口监听HTTP请求。运行以上命令后，打开浏览器，在地址栏输入：http://localhost:8080即可看到你的书页了。其中位于左侧书目顶部的Introduction一节就编译自README.md，而书目本身自编译自SUMMARY.md。你要在自己的网站上发布新书，只需把_book目录复制到服务器相应目录即可。

7、Options for commands build and serve are（可选的编译或部署命令，这个是针对命令行下）:

[plain] view plain copy 在CODE上查看代码片派生到我的代码片

-o, –output Path to output directory, defaults to ./_book

-f, –format Change generation format, defaults to site, availables are: site, page, ebook, json

–config Configuration file to use, defaults to book.js or book.json

8、GitBook loads the default configuration from a book.json file in the repository if it exists.官网上描述的，这不用翻译了吧 = =，如果用GitBook Editor，则可以在菜单栏Book->Edit Configuration，编辑完后文件夹中就出现了book.json文件。

Here are the options that can be stored in this file:

{

// Folders to use for output

// Caution: it overrides the value from the command line

// It’s not advised this option in the book.json

“output”: null,

// Generator to use for building
// Caution: it overrides the value from the command line
// It's not advised this option in the book.json
"generator": "site",

// Book metadats (somes are extracted from the README by default)
"title": null,
"description": null,
"isbn": null,

// For ebook format, the extension to use for generation (default is detected from output extension)
// "epub", "pdf", "mobi"
// Caution: it overrides the value from the command line
// It's not advised this option in the book.json
"extension": null,

// Plugins list, can contain "-name" for removing default plugins
"plugins": [],

// Global configuration for plugins
"pluginsConfig": {
"fontSettings": {
"theme": "sepia", "night" or "white",
"family": "serif" or "sans",
"size": 1 to 4
}
},

// Variables for templating
"variables": {},

// Links in template (null: default, false: remove, string: new value)
"links": {
// Custom links at top of sidebar
"sidebar": {
"Custom link name": "https://customlink.com"
},

// Sharing links
"sharing": {
"google": null,
"facebook": null,
"twitter": null,
"weibo": null,
"all": null
}
},

// Options for PDF generation
"pdf": {
// Add page numbers to the bottom of every page
"pageNumbers": false,

// Font size for the fiel content
"fontSize": 12,

// Paper size for the pdf
// Choices are [u’a0’, u’a1’, u’a2’, u’a3’, u’a4’, u’a5’, u’a6’, u’b0’, u’b1’, u’b2’, u’b3’, u’b4’, u’b5’, u’b6’, u’legal’, u’letter’]
"paperSize": "a4",

// Margin (in pts)
// Note: 72 pts equals 1 inch
"margin": {
"right": 62,
"left": 62,
"top": 36,
"bottom": 36
},

//Header HTML template. Available variables: _PAGENUM_, _TITLE_, _AUTHOR_ and _SECTION_.
"headerTemplate": null,

//Footer HTML template. Available variables: _PAGENUM_, _TITLE_, _AUTHOR_ and _SECTION_.
"footerTemplate": null
}

}

9、出现下面的提示，不一定出现这个提示再去安装Calibre，所以这步就是安装Calibre（啰嗦了）：

Need to install ebook-convert from Calibre

This error happens because GitBook can’t resolve a plugin (or the plugin is invalid). External plugins need to be installed using gitbook install.

解决方法：

To get around the error while trying to build your project as a PDF, ePub or mobi ebook, you must have the Calibre eBook reader/manager installed AND the command-line tools installed.

To install the Calibre command-line tools from the Mac version, from the menu select: calibre - Preferences - Miscellaneous - Install command line tools

翻译：Calibre 上下载calibre-2.17.0.dmg,之后安装，选择英文版（方便找到calibre - Preferences - Miscellaneous - Install command line tools），找不到Install command line tools则可以终端执行 ：

[plain] view plain copy 在CODE上查看代码片派生到我的代码片

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

10、把GitBook Editor跟自己的账号关联起来，然后菜单栏中Book->Publish as..就可以发布到网站中了（这样其他读者可以浏览器中阅读或者下载生成自己需要的文件格式）。

11、终端编译，选择你要生成的一种格式即可，没安装Calibre会提示Need to install ebook-convert from Calibre

[plain] view plain copy 在CODE上查看代码片派生到我的代码片

gitbookpdf gitbook mobi

$ gitbook epub

最后文件夹中就会生成相对应的文件。

12、https://github.com/GitbookIO/gitbook 这个是官方的github地址

最后的最后，1、2、3、4、9、10、11 按照这个步骤就可以成功制作自己的电子书了 = =，有些细节的地方没说完整，笔者认为读者都能自己摸索出来。







gitbook editor use:http://blog.csdn.net/bao_libra/article/details/51364699