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

目录
相关文章
|
缓存 JavaScript 前端开发
hexo 命令速查小册
hexo 命令速查小册
|
JavaScript 开发工具 git
GitBook新手入门
GitBook是使用Git管理书籍项目,使用Markdown撰写书籍,并使用GitHub和GitBook网站进行托管的一个实用工具。下面简单说一下新手如何使用该强大的工具。
156 0
|
25天前
|
开发工具 git 开发者
菜鸟之路day01一一学学Git
《菜鸟之路day01——学学Git》由blue编写,发布于2025年1月13日。本文简要介绍了Git这款分布式版本控制工具的基础操作,包括设置用户签名、初始化本地库、提交文件、查看历史版本、分支管理及冲突解决等。通过学习这些命令,读者可以掌握如何在本地进行版本控制和团队协作的基本技能。文章还涉及了远程仓库的操作,如推送、拉取和克隆等,帮助开发者更好地理解和使用Git。
29 6
|
9月前
|
缓存 JavaScript 前端开发
【热门话题】深入浅出:npm常用命令详解与实践
**npm命令详解:**了解基本概念和安装后,通过`npm init`生成`package.json`。安装包用`install [package]`,加`--save`或`--save-dev`管理依赖。移除包用`uninstall`,更新用`update`,全局安装加`-g`。搜索包用`search`,查看依赖用`list`,检查过时包用`outdated`,审计安全用`audit`。版本控制用`version`,发布包用`publish`。掌握这些命令能提升开发效率。探索更多npm特性,加强项目管理和协作。
89 6
|
自然语言处理 JavaScript 前端开发
使用GitBook写文档并生成电子书(静态网页)
使用GitBook写文档并生成电子书(静态网页)
457 0
|
JavaScript 前端开发 开发工具
开源必备,手把手教你做自己的开源项目--如何把代码放到npm上让别人下载
开源必备,手把手教你做自己的开源项目--如何把代码放到npm上让别人下载
开源必备,手把手教你做自己的开源项目--如何把代码放到npm上让别人下载
|
存储 JavaScript 前端开发
grunt入门笔记
grunt在前端工具中算是很有用的一个工具。 想一想如果没有这个工具,我们需要手动新建一个压缩代码后的文件夹,每次修改原始文件,都要手动压缩一下,再保存到压缩后的文件夹,想想都要疯掉。所以,grunt前端必不可少。
133 0
grunt入门笔记
|
JSON JavaScript 数据格式
Gitbook 使用笔记
Gitbook 使用笔记
294 0
Gitbook 使用笔记
|
JavaScript 编译器 Linux
手把手教你GitBook使用(一)
详细的记录了一步步搭建自己的电子文档笔记
366 0
手把手教你GitBook使用(一)
手把手教你GitBook使用(二)
详细的记录了一步步搭建自己的电子文档笔记
173 0
手把手教你GitBook使用(二)