gktimesc2gitbook

gktimesc2gitbook 是一个使用 Node.js 写的脚本，用于自动化把极客时间专栏转化为 gitbook 目录结构, 从而方便使用 gitbook-cli 去生成静态站点或制作电子书 pdf, epub 等。

运行环境

• 操作系统: 类 Unix 操作系统, 因为为了偷懒, 脚本中对于文件系统的操作使用 shelljs
• Nodejs: 支持 async/await 的 Node.js, 哈哈, 我喜欢使用最新异步操作方式

安装

$ npm install -g gktimesc2gitbook

参数说明

命令原型: gktimesc2gitbook [json config file] [options]

使用

安装后使用:

$ gktimesc2gitbook ./gitbook.json

可以使用 npx 快速使用:

$ npx gktimesc2gitbook ./gitbook.json
# 或
$ npx github:MwumLi/gktimesc2gitbook ./gitbook.json

查看版本:

$ gktimesc2gitbook -V

启用 debug 模式:

$ gktimesc2gitbook ./gitbook.json --debug

Options

  -V, --version                 output the version number
  --cid <id>                    极客时间专栏 id (default: "")
  -c, --cookie <cookie string>  登录极客时间后浏览器的 cookie, 用于通过购买的专栏认证
  -g, --gitbook <dir>           专栏导出存放目录, 默认当前运行命令的目录下 gitbook/
  -r, --rate <ms>               请求速率控制, 间隔指定 ms 数请求避免服务器认为你正在攻击, 默认 500ms
  -d, --debug                   调试模式
  -h, --help                    output usage information

参数文件格式

可以用一个文件指定所有参数，从而避免在命令输入一大段参数(有的命令行会因为参数太长而阶段)

{
  "cid": 88,
  "cookie": "_ga=GA1.2.1178127592.1541215352; GCID=1d8d20c-ad6568d-b955709-d1640ea; _gid=GA1.2.782933269.1548774656; GCESS=BAkBAQQEgFEBAAYEmVDOeQwBAQIEJm1QXAoEAAAAAAEE2HETAAgBAwUEAAAAAAcEQLd.3AsCBAADBCZtUFw-; _gat=1; Hm_lvt_022f847c4e3acd44d4a2481d9187f1e6=1548774656,1548774699,1548848221,1548848729; Hm_lpvt_022f847c4e3acd44d4a2481d9187f1e6=1548848729; SERVERID=1fa1f330efedec1559b3abbcb6e30f50|1548848729|1548847313"
}

• cid: 可选, 专栏的 id, 浏览器打开专栏, url 上就可以看到
  • 如果不指定, 并且已经配置 cookie, 则显示你购买的所有专栏, 通过选择来下来指定专栏
• cookie: 可选, 用来通过极客时间的用户认证。 如果指定 cookie 或 cookie 失效, 导出的是阉割版的专栏, 因此, 此功能仅为付费用户。
• gitbook: 可选, 指定导出的专栏内容存放目录。默认为运行命令的当前目录下的 ./gitbook/
• rate: 可选, 数字，单位 ms, 默认 500ms, 指定请求速率，避免因为请求太快而被极客时间认为你在攻击它而限制你的请求
• debug: 可选, boolean, 默认 false, 如果你下载有问题，可以打开此模式，来查看详细的错误，截图上报，方便开发者来定位问题