文档章节

gitbook 入门教程之导出电子书

o
 osc_gu9d45li
发布于 2019/04/07 22:56
字数 778
阅读 3
收藏 0

精选30+云产品,助力企业轻松上云!>>>

gitbook 既可以将源码文件单独输出,也可以仅输出单个文件,常见的导出电子书格式主要有三种(ePub, Mobi, PDF),而这三种格式都依赖于系统本身提供的 ebook-convert 工具.

gitbook-export-pdf-preview.gif

安装依赖

如果直接运行 gitbook pdf 相关命令,可能会报错,提示需要安装 ebook-convert 插件,根据提示本地需要安装 calibre 软件,这样 gitbook 才能正常导出电子书.

calibre 官网: https://calibre-ebook.com/

gitbook-export-calibre-preview.png

linux 系统

下载地址: https://calibre-ebook.com/download_linux

  • 下载应用
$ sudo -v && wget -nv -O- https://download.calibre-ebook.com/linux-installer.sh | sudo sh /dev/stdin
  • 配置软链接
$ sudo ln -s /usr/bin/nodejs /usr/bin/node

mac 系统

下载地址: https://calibre-ebook.com/download_osx

  • 下载应用

calibre.app 移动到应用程序文件,然后尝试是否能正常打开应用.

  • 配置软链接
$ sudo ln -s ~/Applications/calibre.app/Contents/MacOS/ebook-convert /usr/bin
  • 测试命令
$ ebook-convert --version

如果没有输出 ebook-convert 版本信息,可能需要配置环境变量.

配置封面

所有格式的电子书都可以配置自定义封面,在项目的根目录下提供 cover.jpgcover_small.jpg 两种封面图片时,生成电子书会自动增加封面页.

当然你也可以使用 autocover 插件 自动生成封面,不过本人才疏学浅,几经尝试始终没有成功,如果有人成功了记得给我留言下哈!

封面的基本要求:

  • cover.jpg 尺寸大小: 1800X2360 px,cover_small.jpg 尺寸大小: 200x262 px;
  • 无边界
  • 清晰可见的书名
  • 任何重要的文字在小版本封面图片中也要清晰可见

更多封面相关规范请参考 https://toolchain.gitbook.com/ebook.html

基本命令

语法格式: gitbook pdf 或 gitbook epub 或 gitbook mobi

示例:

# 生成 `pdf` 文件并输出 `debug` 级别日志
$ gitbook pdf ./ ./myBook.pdf --log=debug

# 生成 `epub` 文件并输出 `debug` 级别日志
$ gitbook epub ./ ./myBook.epub --log=debug

# 生成 `mobi` 文件并输出 `debug` 级别日志
$ gitbook mobi ./ ./myBook.mobi --log=debug

相信大家对 PDF 格式比较熟悉,其余两种格式只是不同电子书格式,因而需要相应软件支持.

生成 PDF 文件

示例:

$ gitbook pdf

默认在当前项目的根目录下生成 book.pdf 文件名,如果配有封面,则首页显示封面,否则无封面.

gitbook-export-pdf-preview.png

生成 ePub 文件

示例:

$ gitbook epub

默认在当前项目的根目录下生成 book.epub 文件名,如果配有封面,则首页显示封面,否则无封面.

gitbook-export-epub-preview.png

生成 mobi 文件

示例:

$ gitbook mobi

默认在当前项目的根目录下生成 book.mobi 文件名,如果配有封面,则首页显示封面,否则无封面.

gitbook-export-mobi-preview.png

小结

本节主要介绍了如何导出电子书,概括来说,首先系统需要安装 ebook-convert 工具,然后配置电子书封面,最后直接导出为目标格式(ePub, Mobi, PDF)进行输出.

随着电子书内容越来越多,生成电子书所花费的时间也越来越久,实属正常,耐心等待即可.

输出 PDF 文件并输出 debug 日志: gitbook pdf --log=debug

o
粉丝 0
博文 500
码字总数 0
作品 0
私信 提问
加载中
请先登录后再评论。
gitbook 入门教程之 gitbook 简介

是一个基于的命令行工具,使用 和 构建精美的电子书. 支持输出静态网页和电子书等多种格式,其中默认输出静态网页格式. 不仅支持本地构建电子书,而且可以托管在 官网上,并享受在线发布和托管图...

雪之梦技术驿站
2019/03/30
20
0
gitbook

安装Node 安装 Node.js(下载地址:https://nodejs.org/en/download/) 安装gitbook Typora 工具 typora 下载地址:https://typora.io/ 使用 初始化电子书 编辑SUMMARY.md文件 更新电子书 再...

浮云晓生
2019/02/13
14
0
gitbook 入门教程之导出电子书

既可以将源码文件单独输出,也可以仅输出单个文件,常见的导出电子书格式主要有三种(, , ),而这三种格式都依赖于系统本身提供的 工具. 安装依赖 如果直接运行 相关命令,可能会报错,提示需要安装...

雪之梦技术驿站
2019/04/07
42
0
gitbook 入门教程之 gitbook 简介

是一个基于的命令行工具,使用 和 构建精美的电子书. 支持输出静态网页和电子书等多种格式,其中默认输出静态网页格式. 不仅支持本地构建电子书,而且可以托管在 官网上,并享受在线发布和托管图...

osc_arhijur3
2019/03/30
2
0
推荐写作平台gitbook——让我们换一种形式写作

https://www.gitbook.com/ 我一直用这个平台进行写作。目前有两本电子书可以供大家阅读,分别如下 Office 365 开发入门指南 https://www.gitbook.com/book/chenxizhang/office365devguide 优...

osc_k0ot8pgk
2018/02/20
8
0

没有更多内容

加载失败,请刷新页面

加载更多

如何在控制器中使用过滤器? - How to use a filter in a controller?

问题: I have written a filter function which will return data based on the argument you are passing. 我编写了一个过滤函数,它将根据您传递的参数返回数据。 I want the same functi......

富含淀粉
今天
26
0
android:layout_weight是什么意思? - What does android:layout_weight mean?

问题: I don't understand how to use this attribute. 我不明白如何使用这个属性。 Can anyone tell me more about it? 谁能告诉我更多关于它的事情? 解决方案: 参考一: https://stacko...

javail
今天
17
0
CSS背景不透明度[重复] - CSS Background Opacity [duplicate]

问题: This question already has an answer here: 这个问题已经在这里有了答案: How do I give text or an image a transparent background using CSS? 如何使用CSS为文本或图像提供透明背...

fyin1314
今天
31
0
node http 获取gb2312网页如何转为utf8

最初,我想当然认为是下述做法,但被证明是错误的 const http = require('http'), iconv = require('iconv-lite');const url = 'http://xxx';http.get(url, function(res) { var bo......

高延
今天
24
0
动态规划:LC198.打家劫舍

题目描述: 你是一个专业的小偷,计划偷窃沿街的房屋。每间房内都藏有一定的现金,影响你偷窃的唯一制约因素就是相邻的房屋装有相互连通的防盗系统,如果两间相邻的房屋在同一晚上被小偷闯入...

曦鱼violet
今天
30
0

没有更多内容

加载失败,请刷新页面

加载更多

返回顶部
顶部