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

目录
相关文章
|
Linux 网络安全
CentOS 7 SSH连接超时自动断开解决方案
CentOS 7 SSH连接超时自动断开解决方案
1781 0
CentOS 7 SSH连接超时自动断开解决方案
|
运维 Kubernetes 安全
|
9月前
|
Kubernetes 数据可视化 Perl
【k8s-1.34.2安装部署】八.metric-server-0.8.0安装
本章介绍metrics-server的安装与配置,用于采集K8s集群中节点和Pod的CPU、内存指标,支撑Dashboard及xkub等工具的资源使用可视化。通过修改配置启用 insecure-tls 并替换为阿里云镜像,快速完成部署,安装后可通过`kubectl top`命令验证。
1133 0
|
9月前
|
运维 Kubernetes NoSQL
【k8s-1.34.2安装部署】九.k8s管理平台xkube安装部署
xkube是一款永久免费、无功能限制的云原生Kubernetes多集群管理工具,支持PC端与APP端,提供集群管理、运维监控、CI/CD发布等功能,助力企业实现跨集群统一管理与自动化运维。
842 4
【k8s-1.34.2安装部署】九.k8s管理平台xkube安装部署
|
9月前
|
Kubernetes 负载均衡 网络协议
【k8s-1.34.2安装部署】一.系统初始化及k8s集群规划
k8s1.34.2的安装总体没什么变化,主要在于结合最新版本的containerd、gateway Api、istio、cilium进行安装,新版本的一些软件和旧的存在一些区别。本章节主要是通过搭建最新版的k8s集群,并搭建gateway Api来进行一些[xkube](https://gitee.com/eeenet/xkube)开发环境的调试和部署,现将整个k8s1.34.2的安装过程进行记录。
1653 23
|
9月前
|
Kubernetes 监控 网络协议
【k8s-1.34.2安装部署】六.企业级部署cilium-1.18.4网络插件
本章详解K8s集群中CNI网络插件Cilium 1.18.4的安装配置,涵盖Helm部署、核心参数解析及状态验证。支持eBPF、Hubble可视化、带宽管理等功能,并提供镜像加速地址与常见问题处理方案。
3431 7
|
消息中间件 监控 Shell
RocketMQ-初体验RocketMQ(03)_RocketMQ多机集群部署
RocketMQ-初体验RocketMQ(03)_RocketMQ多机集群部署
507 0
|
应用服务中间件 网络安全 nginx
配置Nginx以支持Websocket连接的方法。
通过上述配置,Nginx将能够理解WebSocket协议的特殊要求,代理Websocket流量到合适的后端服务器。注意,Websocket并不是HTTP,尽管它最初是通过HTTP请求启动的连接升级,因此保证Nginx了解并能够妥善处理这种升级流程是关键。
2550 10
|
缓存 前端开发 JavaScript
终极 Nginx 配置指南(全网最详细)
本文详细介绍了Nginx配置文件`nginx.conf`的基本结构及其优化方法。首先通过删除注释简化了原始配置,使其更易理解。接着,文章将`nginx.conf`分为全局块、events块和http块三部分进行详细解析,帮助读者更好地掌握其功能与配置。此外,还介绍了如何通过简单修改实现网站上线,并提供了Nginx的优化技巧,包括解决前端History模式下的404问题、配置反向代理、开启gzip压缩、设置维护页面、在同一IP上部署多个网站以及实现动静分离等。最后,附上了Nginx的基础命令,如安装、启动、重启和关闭等操作,方便读者实践应用。
7176 85
终极 Nginx 配置指南(全网最详细)
|
SQL 安全 测试技术
Burpsuite Scanner主动扫描生成安全评估报告
Burpsuite Scanner主动扫描生成安全评估报告