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文件,把以下三行注释掉!!!

Mac-M1驯化gitbook踩坑记录_第1张图片  

[来自大神的答案]

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

你可能感兴趣的:(学习笔记,macos,git,npm,javascript,node.js)