使用Gitbook生成电子书

背景

  《Google工程实践文档》相对原文Google's Engineering Practices documentation ,部分内容过时了。需要更新中文版,并使用Gitbook把Markdown文件转换成对应的PDF电子书。

  上一次生成PDF电子书是5年前,当时生成电子书的环境早已不在。此次重新搭建环境,以备忘。

工具

  需要安装3个工具:Calibre、nvm 和nodejs。

  1. Calibre
    使用Gitbook生成PDF文件时,底层会调用Calibre生成PDF文件。
  2. nvm
    用于管理nodejs版本。
    本机已经是最新版本的nodejs(版本号20.11.0)。由于gitbook官方长期未更新,与最新版本的nodejs不兼容。为了让其正常运行,本机只能安装较老版本(10.22.0)的nodejs。
    安装nvm的目的是为了随时能在不同的nodejs版本间切换。当需要使用gitbook时,使用10.22.0,否则,其他场合使用最新版本。
  3. Nodejs和gitbook
    Gitbook命令基于nodejs(版本号10.22.0)运行。

安装步骤

1. 安装Calibre

  Calibre 必须使用3.48版本。

  最新版本的Calibre虽然也能生成PDF文件,但兼容性不好,生成的PDF文件比较大,而且会内嵌很多字体。除此之外,在生成的PDF文件中,电子目录(左边的书签)无法正确定位到文档中正确的位置。

  在官网:Previous calibre releases 可以找到 3.48 版本。

  下载后,双击安装。

2. 安装nvm

 1) 从Github上下载windows版安装文件 nvm-setup.exe 。

  下载链接:https://github.com/coreybutler/nvm-windows/release 。

  安装过程中,会提示找到已安装的版本,是否要纳入版本管理,点击"是"。

 2) 安装nvm之后,到命令行中执行  

  $ nvm npm_mirror https://registry.npmmirror.com

 3) 安装 10.22.0 版本的nodejs,运行

  $ nvm install 10.22.0

 4) 切换到版本 10.22.0,运行

  $ nvm use 10.22.0

 5) 运行 node -v,运行结果显示

  $ node --v
  v10.22.0

3. 安装gitbook并验证版本为3.2.3
  $ npm install gitbook-cli --g
  $ gitbook --v
  CLI version: 2.3.2
  GitBook version: 3.2.3

运行流程

  Gitbook生成电子书的流程如下图所示:

生成PDF电子书

  1. 下载电子书到本地。
  2. 进入电子书目录,运行 gitbook pdf ./ ./Google工程实践文档.pdf。

  运行help命令可以查询gitbook的用法。

$ gitbook help

build book output build a book

--log Minimum log level to display (Default is info; Values are debug, info, warn, error, disabled)

--format Format to build to (Default is website; Values are

......

参考资料

相关推荐
开开心心就好12 小时前
显示器关不掉怎么办,用小工具一键息屏
算法·智能手机·pdf·计算机外设·ocr·lua·1024程序员节
weixin_5372170612 小时前
2027年袁东申论万能素材(PDF)
经验分享·pdf
开开心心就好2 天前
PDF水印怎么去掉?勾选对象再点匹配
java·前端·mysql·支持向量机·pdf·音视频·模拟退火算法
开开心心就好3 天前
两张表格数据对比工具,不用写函数也能查
算法·spring·智能手机·pdf·电脑·intellij-idea·音视频
AI导出鸭PC端3 天前
用 AI 导出鸭高效处理:豆包导 pdf 怎么压缩但清晰
android·人工智能·pdf·豆包·ai导出鸭
w3296362716 天前
飞书接单到月度结算:我用一个 DSH 插件跑通鞋类采购 WMS,附 22 项验收
pdf·node.js·飞书·后端开发·ai agent
小熊熊知识库8 天前
双层PDF转换软件
pdf·双层pdf转换
AI导出鸭PC端12 天前
Perplexity批量导出没有PDF模式?AI导出鸭插件补上最后一块拼图
人工智能·pdf·c#·ai导出鸭
Ravenq~13 天前
无头转换:把 .docx 变成 PDF,不打开编辑器
pdf·编辑器
联犀13 天前
纯 Go 的 CAD 开源库 go-cad:直接解析 DWG/DXF,现在也能导出 PDF
开发语言·golang·pdf