相关文章推荐
没人理的爆米花  ·  阿姐鼓顶级发烧唱片限量编号_何训田·  3 月前    · 
善良的莴苣  ·  我想和你唱第一季(湖南卫视互动音乐节目第一季 ...·  1 年前    · 
飞奔的莲藕  ·  民法典“唤醒”家务补偿制度,数额是如何认定的 ...·  1 年前    · 
乖乖的钱包  ·  前说!_百度百科·  2 年前    · 
风流的书签  ·  宋制长干寺褙子尺寸_头条·  2 年前    · 
小百科  ›  博客的公式渲染问题开发者社区
云计算 hexo mathjax markdown
闷骚的山羊
2 年前
作者头像
爱编程的小明
0 篇文章

博客的公式渲染问题

前往专栏
腾讯云
开发者社区
文档 意见反馈 控制台
首页
学习
活动
专区
工具
TVP
文章/答案/技术大牛
发布
首页
学习
活动
专区
工具
TVP
返回腾讯云官网
社区首页 > 专栏 > 小明的博客 > 博客的公式渲染问题

博客的公式渲染问题

作者头像
爱编程的小明
发布 于 2022-09-06 14:41:54
615 0
发布 于 2022-09-06 14:41:54
举报

Hexo生成的初始博客是支持标签外挂和插入图片的,但是原生的markdown渲染器 hexo-renderer-markdowed 对于复杂的公式支持并不友好,因此不得不卸载掉原生的markdown渲染方法,本着优化公式显示的原则进行新的渲染的寻找,最终找到的几种解决方案有:

  • hexo-renderer-kramed ,支持mathjax,轻量,对hexo的标签外挂也能正常处理,近乎最优解,但是原生的渲染行内公式会有各种奇怪的问题,需要修改源代码中的行内公式匹配规则,csdn上主流的公式渲染问题的解决办法,但是因为我的博客是用githubpages自动生成,因此在安装源包的时候生成网页的行内公式渲染问题无法得到解决。
  • hexo-renderer-markdown-it ,据说支持mathjax,但就我安装的体验来看貌似并不支持,另外已经不维护,因此不作为主流备选项。
  • hexo-filter-mathjax 一个专门的mathjax渲染,需要再需要渲染的页面添加 mathjax:true ,渲染效果不错,但是因为本身并不能作为markdown渲染器使用,可以作为一种备选方案。

几经周折已经打消了使用支持mathjax引擎的希望,转入katex,第一个看到的插件就是 markdown-it-katex ,不得不说速度是真的快,但是对于一些环境例如equation,align等均不支持,考虑到自己博客大量涉及这些环境,因此也并非一种很好的选择。 看到katex的局限之后,其实已经隐约希望有一种能够同时支持mathjax和katex的插件,这个时候第一时间想到的是 hexo-filter-mathjax + hexo-renderer-kramed ,但是这个存在的问题是katex渲染引擎无论如何不会关闭,换言之开启mathjax引擎后会出现两个公式的渲染结果,这个致命问题不敢继续使用。

想着mathjax和katex兼得的幻想,下一个可选项是 hexo-math ,这个插件是大部分会推荐的一个插件,同时支持mathjax和katex进行渲染,但是一个问题是公式书写时必须写成标签外挂的形式,因此只作为了一个备选项,并没有投入使用。

想来这些时日hexo博客部署遇到的很多问题都是由于hexo对于markdown的兼容性不是那么好所致,之前有过使用jkelly的体验,很容易就能发现jkelly是相对来说更围绕markdown的语法拓展展开的,hexo的插件做的相对来说有一些些差,最后为了页面的加载速度,我决定使用katex进行加载,幸亏有butterfly主题的加持,一些katex渲染不出来的特殊环境也成功显示(主题配置中 mathjax:true ),总的来说呈现一种比较理想的加载方式, 但是katex的公式渲染始终不是长久之计,可能还存在诸多问题。目前博客得配置中安装的markdown渲染依赖是 hexo-renderer-markdown-it-plus ,这是一个相对理想的markdown渲染方式,其他的渲染器好像会和butterfly的标签外挂存在冲突?借助 markdown-it-katex 目前博客可以正常解析,逻辑大概是katex解析优先,mathjax为辅的感觉。下一步公式的渲染策略是使用mathjax进行渲染, hexo-filter-mathjax 是一个很不错的选择,至于二者兼得的方式仍有待进一步探索,实在是懒得整了 。

还有就是图片显示的问题最后也没能很好的解决,之前一直使用的 npm install https://github.com/7ym0n/hexo-asset-image —save 也是有一些奇怪的问题,最后逼不得已决定直接在source文件夹中创建一个图片的存储路径 md_imgs ,这个问题的解决以后再议,目前已经解决了大部分问题 。

本文参与 腾讯云自媒体分享计划 ,分享自作者个人站点/博客。
原始发表:2022-08-30, 如有侵权请联系 cloudcommunity@tencent.com 删除
hexo
markdown
渲染
github
git

本文分享自 作者个人站点/博客 前往查看

如有侵权,请联系 cloudcommunity@tencent.com 删除。

本文参与 腾讯云自媒体分享计划 ,欢迎热爱写作的你一起参与!

hexo
markdown
渲染
github
git
评论
登录 后参与评论
0 条评论
热度
最新
登录 后参与评论
关于作者
爱编程的小明
0
文章
0
累计阅读量
0
获赞
前往专栏
领券
  • 社区

    • 专栏文章
    • 阅读清单
    • 互动问答
    • 技术沙龙
    • 技术视频
    • 团队主页
    • 腾讯云TI平台
  • 活动

    • 自媒体分享计划
    • 邀请作者入驻
    • 自荐上首页
    • 技术竞赛
  • 资源

    • 技术周刊
    • 社区标签
    • 开发者手册
    • 开发者实验室
  • 关于

    • 社区规范
    • 免责声明
    • 联系我们
    • 友情链接

腾讯云开发者

扫码关注腾讯云开发者

扫码关注腾讯云开发者

领取腾讯云代金券

热门产品

  • 域名注册
  • 云服务器
  • 区块链服务
  • 消息队列
  • 网络加速
  • 云数据库
  • 域名解析
  • 云存储
  • 视频直播

热门推荐

  • 人脸识别
  • 腾讯会议
  • 企业云
  • CDN加速
  • 视频通话
  • 图像分析
  • MySQL 数据库
  • SSL 证书
  • 语音识别

更多推荐

  • 数据安全
  • 负载均衡
  • 短信
  • 文字识别
  • 云点播
  • 商标注册
  • 小程序开发
  • 网站监控
  • 数据迁移

Copyright © 2013 - 2023 Tencent Cloud. All Rights Reserved. 腾讯云 版权所有

深圳市腾讯计算机系统有限公司 ICP备案/许可证号: 粤B2-20090059 深公网安备号 44030502008569

腾讯云计算(北京)有限责任公司 京ICP证150476号 | 京ICP备11018762号 | 京公网安备号11010802020287

问题归档 专栏文章 快讯文章归档 关键词归档 开发者手册归档 开发者手册 Section 归档

Copyright © 2013 - 2023 Tencent Cloud.

All Rights Reserved. 腾讯云 版权所有

登录 后参与评论
 
推荐文章
没人理的爆米花  ·  阿姐鼓顶级发烧唱片限量编号_何训田
3 月前
善良的莴苣  ·  我想和你唱第一季(湖南卫视互动音乐节目第一季)_搜狗百科
1 年前
飞奔的莲藕  ·  民法典“唤醒”家务补偿制度,数额是如何认定的?_鹤山市人民政府 ...
1 年前
乖乖的钱包  ·  前说!_百度百科
2 年前
风流的书签  ·  宋制长干寺褙子尺寸_头条
2 年前
今天看啥   ·   Py中国   ·   codingpro   ·   小百科   ·   link之家   ·   卧龙AI搜索
删除内容请联系邮箱 2879853325@qq.com
小百科 - 百科知识指南
© 2024 ~ 沪ICP备11025650号