gitbook的入坑之路(二)

简介: 安装过程

2. 问题:使用 gitbook 编译后公式显示为源码


解决办法:安装 mathjax 插件

关于 mathjax 突然不能用了

warning: 对于这个问题我并没有弄清楚原理,稀里糊涂就解决了,大家谨慎观看


刚一开始我想在 gitbook 中使用 mathjax 写数学公式,但是按照网上的步骤


首先要有 node.js 环境


根目录创建 book.json 文件


内容为 {plugins: [“mathjax”];}


然后根目录执行 gitbook install./


那么我出现的问题是下载不下来,也许是真的需要多等一会,但是我是个急性子,直接 Google,发现一篇文章:https://www.aiyc.top/1979.html


gitbook 官方已不再维护插件,mathjax 由于关闭了 cdn 而导致 gitbook 的 mathjax 的官方镜像出问题了。

因此在这里写了一个插件 gitbook-plugin-mathjax-pro


npm install mathjax@2.7.7

接着在 book.json 中引入:

10.png

最后安装:gitbook install ./

虽然这次成功了,但是当我对第二个 book 使用同样的方式时,下载成功了,但是生成 book 的时候却报错了:


Error with plugin “mathjax-pro”: Cannot find module 'mathjax/unpacked/MathJax


继续查,这次上百度,找到了这篇文章:https://zhuanlan.zhihu.com/p/125577482


在生成 pdf 或者生成网页时,mathjax 会报错,一般出现在新安装 mathjax 或者更新 mathjax 后,解决办法为,为 mathjax 降级,安装 2.7.6版本

npm install mathjax@2.7.6


然后我就稀里糊涂地直接在根目录下执行 npm install mathjax@2.7.6


然后继续 gitbook serve


markdown 里的内容是这样的:11.png

结果很完美:

12.png

3. 问题:安装 mathjax 失败

13.png


解决办法:先安装mathjax@2.7.6

同上!


4. 问题:安装报错

14.png

解决办法:先执行命名 npm init

npm WARN saveError ENOENT: no such file or directory 解决

安装完成 node.js 后使用 npm 安装 vue 报错如下:

15.png

根据错误提示,是系统没有 ‘package.json’ 这个文件导致。这个文件的作用就是管理你本地安装的 npm 包,一个 package.json 文件可以做如下事情:


展示项目所依赖的 npm 包


允许你指定一个包的版本[范围]


让你建立起稳定,意味着你可以更好的与其他开发者共享


此刻我们需要执行命令:


16.png

创建 package.json 文件,系统会提示相关配置,也可以使用命令:

17.png

直接创建 package.json 文件,这样创建好处是必填项已经帮你填好,执行完命令后可以看到用户路径下多了一个 package.json 文件。


关于 gitbook 我更多文章:


1.http://www.chengweiyang.cn/gitbook/index.html

2.http://note.heifahaizei.com/book/

3.https://juejin.cn/post/6931225754264928269

4.https://chrisniael.gitbooks.io/gitbook-documentation/content/

5.https://yangjh.oschina.io/gitbook/faq/Plugins.html 有测验功能教程

6.https://learn-gitbook.gitbook.io/gitbook/

7.https://allen5183.gitbooks.io/gitbook/content/plugins/quizzes/introduce.html 搭配 5




11.png11.png


10.png

目录
相关文章
|
8天前
|
JavaScript API iOS开发
DeepSeek Harness下载、安装、配置一篇搞定(2026整理,送常用插件)
DeepSeek Harness(DSH)是DeepSeek于2026年开源的MIT协议AI Agent框架,支持插件化组装模型、工具、沙箱与UI,兼容主流大模型。本文提供免Node.js的桌面端安装包(Win/macOS),含详细图文教程及热门插件推荐。
3603 34
|
7天前
|
Linux 开发工具 iOS开发
Codex保姆级教程(下载+安装+登录+使用,含所有版本,2026最新)
Codex是OpenAI推出的开源AI编程智能体,本地运行,可理解整个代码库,支持自然语言指令改代码、执行命令、跑测试、修Bug,兼容Win/macOS/Linux。(239字)
3078 10
|
3天前
|
云安全 人工智能 安全
|
8天前
|
iOS开发 Docker MacOS
【2026实测】Docker Desktop下载、安装、汉化、配置教程(附官网安装包)
Docker Desktop 是 Docker 官方推出的桌面容器管理工具,集成引擎、CLI、图形界面与 Kubernetes,支持 Win/macOS/Linux。2026 最新版 4.88.1 强化 ARM 原生运行、镜像加速及资源可视化,附中文汉化与国内镜像配置指南。
1648 6
|
9天前
|
安全 算法 定位技术
《高性价比人生指南》完整原版:普通人用最少的资源,过好这一生的底层逻辑~How To Live Better
📖《高性价比人生指南》是一份基于实证、拒绝焦虑的生存手册,倡导以“人生时薪”为视角,重新计算时间、金钱与精力的成本与收益。它不承诺逆袭,只教人算清账:省下的钱若耗掉时间便亏;买体验比买物品更值;睡眠是最高杠杆的健康投资;关系贵在情绪价值而非表面热络;学习重在改变行为而非自我安慰。核心理念:用低成本、高回报的微小行动,换取长期的选择权——不是成为谁,而是掌控自己人生的主动权。
2008 4
|
云安全 安全 网络安全
|
21天前
|
人工智能 API 开发工具
DeepSeek Harness 神插件:白嫖 13 家大厂模型
`dsh-our-free-model` 是 DeepSeek Harness 神级插件:零配置、零API Key、零账号,聚合13家大厂免费模型(含DeepSeek V4.1 Flash、Kimi K3等),支持本地网关、用量看板与自动降级,真正实现“白嫖即用”。
3813 55
|
13天前
|
人工智能 JSON Linux
【保姆级】ComfyUI部署教程(下载+安装+配置+工作流,2026最新)
ComfyUI 是一款开源节点式AI生成工具,支持图像、视频、音频及3D内容创作。通过拖拽连线组合模型加载、提示词、采样等节点,构建可复用、易修改的工作流,兼容SD1.5、SDXL、Flux、Qwen Image等主流模型。