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
nodejs读书笔记
nodejs读书笔记
|
JavaScript 开发工具 git
GitBook新手入门
GitBook是使用Git管理书籍项目,使用Markdown撰写书籍,并使用GitHub和GitBook网站进行托管的一个实用工具。下面简单说一下新手如何使用该强大的工具。
149 0
|
4月前
|
Ubuntu 编译器 C语言
Ubuntu 源码编译指定版本 make:神秘代码背后的激情冒险,等你来战!
【9月更文挑战第8天】在Ubuntu中,编译指定版本的源码`make`是一项挑战但也极具价值的任务。它允许我们根据特定需求定制软件,提升性能与功能适配。首先需安装必要工具包如GCC等;接着下载所需源码并阅读相关文档以了解编译要求。通过运行`./configure`、`make`及`sudo make install`命令完成编译安装流程。过程中可能遇到依赖项缺失或编译选项设置不当等问题,需根据错误提示逐一解决。对于大型项目,可利用多核编译加快速度。掌握这一技能有助于更好地探索开源世界。
63 3
|
8月前
|
缓存 JavaScript 前端开发
【热门话题】深入浅出:npm常用命令详解与实践
**npm命令详解:**了解基本概念和安装后,通过`npm init`生成`package.json`。安装包用`install [package]`,加`--save`或`--save-dev`管理依赖。移除包用`uninstall`,更新用`update`,全局安装加`-g`。搜索包用`search`,查看依赖用`list`,检查过时包用`outdated`,审计安全用`audit`。版本控制用`version`,发布包用`publish`。掌握这些命令能提升开发效率。探索更多npm特性,加强项目管理和协作。
82 6
|
Web App开发 JavaScript 前端开发
VueCLi的安装步骤(第四课)
VueCLi的安装步骤(第四课)
263 0
|
算法 数据挖掘 测试技术
上海交大软件学院课件 NPM、PYPI、DockerHub 备份
上海交大软件学院课件 NPM、PYPI、DockerHub 备份
155 0
|
JavaScript 前端开发 开发工具
开源必备,手把手教你做自己的开源项目--如何把代码放到npm上让别人下载
开源必备,手把手教你做自己的开源项目--如何把代码放到npm上让别人下载
开源必备,手把手教你做自己的开源项目--如何把代码放到npm上让别人下载
|
开发工具 git
gitbook docs 序言
gitbook docs 序言
|
JSON JavaScript 数据格式
Gitbook 使用笔记
Gitbook 使用笔记
288 0
Gitbook 使用笔记

热门文章

最新文章