hexo 进阶设置指南(持续更新)

2020-08-31 14:58:11 浏览数 (1)

让hexo渲染MathJax复杂公式(默认的渲染引擎复杂公式会报错)

Problem

对复杂公式的支持不够好,简单公式可以显示,复杂编译错误,验证表明,问题不是mathjax.js导致,是默认hexo引擎编译导致html文本转义错误。

Reason

Hexo默认使用"hexo-renderer-marked"引擎渲染网页,该引擎会把一些特殊的markdown符号转换为相应的html标签,比如在markdown语法中,下划线'_'代表斜体,会被渲染引擎处理为<em>标签

因为类Latex格式书写的数学公式下划线 '_' 表示下标,有特殊的含义,如果被强制转换为<em>标签,那么MathJax引擎在渲染数学公式的时候就会出错。例如,x_i在开始被渲染的时候,处理为x<em>i</em>,这样MathJax引擎就认为该公式有语法错误,因为不会渲染。

类似的语义冲突的符号还包括'*', '{', '}', ''等。

Solution

  • 更换默认的Hexo下 Markdown渲染引擎 marked -> kramed
代码语言:javascript复制
npm uninstall hexo-renderer-marked --save
npm install hexo-renderer-kramed --save
  • 更改hexo转义冲突 找到根目录node_moduleskramedlibrulesinline.js
    • 修改11行,取消对,{,}的转义escape // escape: /^\([\`*{}[]()#$ -.!_>])/, escape: /^\([`*[]()#$ -.!_>])/,
    • 修改20行em // em: /^b_((?:__|[sS]) ?)_b|^*((?:**|[sS]) ?)*(?!*)/, em: /^*((?:**|[sS]) ?)*(?!*)/,
  • 三连 hexo cl && hexo g && hexo s查看效果 Debug
  • 如果出问题,在主题_config.yml下设置mathjaxtrue
  • 文章也要开启mathjax
代码语言:javascript复制
---
title: 我是标题
date: 2020-08-15 23:18:50
tags:
mathjax: true
--

其他解决办法

  • 服务器端的渲染
    • math.now.sh
    • markdown-it-latex2img

SEO 搜索引擎优化

Google search console 大全

0 人点赞