做网站推广需要多少钱,高端网站建设步骤,找回老网站,网上有做衣服的网站背景 《Google工程实践文档》相对原文Google’s Engineering Practices documentation #xff0c;部分内容过时了。需要更新中文版#xff0c;并使用Gitbook把Markdown文件转换成对应的PDF电子书。 上一次生成PDF电子书是5年前#xff0c;当时生成电子书的环境早已不在…背景 《Google工程实践文档》相对原文Google’s Engineering Practices documentation 部分内容过时了。需要更新中文版并使用Gitbook把Markdown文件转换成对应的PDF电子书。 上一次生成PDF电子书是5年前当时生成电子书的环境早已不在。此次重新搭建环境以备忘。
工具 需要安装3个工具Calibre、nvm 和nodejs。
Calibre 使用Gitbook生成PDF文件时底层会调用Calibre生成PDF文件。nvm 用于管理nodejs版本。 本机已经是最新版本的nodejs版本号20.11.0。由于gitbook官方长期未更新与最新版本的nodejs不兼容。为了让其正常运行本机只能安装较老版本10.22.0的nodejs。 安装nvm的目的是为了随时能在不同的nodejs版本间切换。当需要使用gitbook时使用10.22.0否则其他场合使用最新版本。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电子书
下载电子书到本地。进入电子书目录运行 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 ……
参考资料
用Gitbook制作电子书
