gitbook install convert pdf and build

Reference:http://blog.youkuaiyun.com/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.youkuaiyun.com/bao_libra/article/details/51364699

评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值