PDF

新版的gitbook,官方已经不支持导出pdf等电子书格式,官方的解读如下:

PDF and other ebook formats exports ? The new version of GitBook no longer supports exporting to PDF and other ebooks format. A lot of rich-content does not translate well from the Web to PDF. GitBook will expose a developer API for people to consume and extend their content. It is not excluded that someone build a PDF export tool using the API, but it will not be officially supported. See the section about offline access if this is the part you cared about.

安装ebook-convert

生成电子书 (epub, mobi, pdf) 时需要ebook-convert。 比较常用的 convert 有 calibre。

安装calibre

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

下载地址:http://calibre-ebook.com/download

calibre

Linux

sudo apt install calibre

Mac

下载 Calibre.app。移动 calibre.app 到你的应用程序文件夹中后,给 ebook-convert 工具创建一个符号链接。

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

你可以把 /usr/bin 替换为 $PATH 中的任何的文件夹。

Windows

安装 calibre-4.5.0.msi 到本机环境,如果选择了默认配置,不需要配置环境变量。

ebook-convert –version
D:\gitbook>ebook-convert --version
ebook-convert.exe (calibre 4.5.0)
Created by: Kovid Goyal <kovid@kovidgoyal.net>

有输出版本证明安装成功。

配置 pdf

可以使用 book.json 中的一组选项来定制PDF输出:

参数名 描述
pdf.pageNumbers 将页码添加到每个页面的底部(默认为 true)
pdf.fontSize 基本字体大小(默认是 12)
pdf.fontFamily 基本字体样式(默认是 Arial)
pdf.paperSize 页面尺寸,选项有: 'a0', 'a1', 'a2', 'a3', 'a4', 'a5', 'a6', 'b0', 'b1', 'b2', 'b3', 'b4', 'b5', 'b6', 'legal', 'letter' (默认值是 a4)
pdf.margin.top 上边界(默认值是 56)
pdf.margin.bottom 下边界(默认值是 56)
pdf.margin.right 右边界(默认值是 62)
pdf.margin.left 左边界(默认值是 62)

生成电子书

gitbook pdf <gitbook-folder-location> <pdf-location>.pdf

你当前看的文档是利用 GitBook 解析的基于 Markdown 文件的 html版本,"下载pdf"按钮提供的 pdf 也是由 GitBook 生成的。

电子书https://docs.poppy-project.org/en/# 左上角有一个下面 pdf 的标志。

D:\gitbook>gitbook pdf
info: 24 plugins are installed
info: 7 explicitly listed
info: loading plugin "splitter"... OK
info: loading plugin "highlight"... OK
info: loading plugin "search"... OK
info: loading plugin "lunr"... OK
info: loading plugin "sharing"... OK
info: loading plugin "fontsettings"... OK
info: loading plugin "theme-default"... OK
info: found 80 pages
info: found 89 asset files
warn: "this.generator" property is deprecated, use "this.output.name" instead
warn: "navigation" property is deprecated
warn: "book" property is deprecated, use "this" directly instead
warn: "options" property is deprecated, use config.get(key) instead
info: >> generation finished with success in 50.6s !
info: >> 1 file(s) generated

然后在当前文件下,就会发现新的文件生成:

book.pdf

当前版本内容更新不及时,完整版请切换至 Gitbook 教程

results matching ""

    No results matching ""