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

时间:2022-07-24
本文章向大家介绍hexo 进阶设置指南(持续更新),主要内容包括其使用实例、应用技巧、基本知识点总结和需要注意事项,具有一定的参考价值,需要的朋友可以参考一下。

让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
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
---
title: 我是标题
date: 2020-08-15 23:18:50
tags:
mathjax: true
--

其他解决办法

SEO 搜索引擎优化

Google search console 大全