Mac-M1驯化gitbook踩坑记录

这两天帮老师将项目的md文件整理成gitbook，以下是本人亲身经历的一些坑，希望能对需要的朋友有所帮助～～～

1 安装mathjax插件时各种报错，be like:"PluginError: Error with plugin "mathjax-pro": Invalid or unexpected token ""Error: Missing required argument #1"

因为实验文档里有很多数学公式，gitbook对latex公式渲染的两种主要插件是mathjax和katex。

katex坑比较少，直接在book.json里面添加对应的"plugins": ["katex"] 即可，但是我感觉katex对单美元符号对比较敏感，双美元对不适配，且会使得公式不居中，所以就选择了任重道远的mathjax。

mathjax，听姐一句劝，在安装mathjax插件出现any报错，请选择卸载重装npm并安装mathjax-pro！

    第一步，卸载重装npm

        卸载命令如下：

node -v

        sudo npm uninstall npm -g

        sudo rm -rf /usr/local/lib/node /usr/local/lib/node_modules /var/db/receipts/org.nodejs.*

        sudo rm -rf /usr/local/include/node /Users/$USER/.npm

        sudo rm /usr/local/bin/node

        sudo rm /usr/local/share/man/man1/node.1

        sudo rm /usr/local/lib/dtrace/node.d

        附加上node网址，可以根据自己需要选择版本node.js版本网址

        记得安装gitbook哟！

  sudo npm install gitbook-cli -g

 第二步，安装mathjax-pro

          具体步骤请移步[官方库]，重装之后一路通畅～～

2执行“gitbook pdf”出现speech.processExpression is not a function 

在生成pdf时，会出现这种错误，这时候在 node_modules/mathjax-node/lib/mj-single.js中第540行，将 "processExpression" 改为"toSpeech"可破。

[ 来自大神的答案 ]

3执行“gitbook pdf”出现 svg 图片转化的问题时，belike"Error: Error convertin .svg into .png" 

一般是 svgexport 的问题，可以试下安装低版本试下，其依赖的 puppeteer 高版本有问题。

npm i --unsafe-perm -g [email protected]

[官方库]

4if (cb) cb.apply(this, arguments)，cb.apply is not a function

去polyfills.js文件，把以下三行注释掉！！！

  

[来自大神的答案]

5在使用npm过程中经常会遇到无法下载包、下载慢等问题 

在使用npm过程中经常会遇到无法下载包的问题，这里整理了几个npm使用国内镜像加速的方法：

修改成腾讯云镜像源/修改成华为云镜像源

npm config set registry http://mirrors.cloud.tencent.com/npm/

npm config set registry https://mirrors.huaweicloud.com/repository/npm/

验证命令

npm config get registry