解决hexo-renderer-kramed渲染冲突的部分问题

原文地址:https://corecabin.cn/2021/08/14/solve-some-problems-of-hexo-renderer-kramed-rendering-conflicts/

文章目录

    • 1 hexo-renderer-kramed不能渲染Todo List
    • 2 hexo-renderer-kramed渲染MathJax时与Markdown语法冲突
      • 2.1 行内公式与行内代码冲突
      • 2.2 下划线`_`被转义为斜体而非LaTeX下标
      • 2.3 反斜杠`\\`被转义为`\`而非LaTeX换行
      • 2.4 LaTeX紧贴符`\!`不被转义
      • 2.5 反斜杠加竖线`\|`被转义为`|`而非LaTeX双竖线
    • 3 总结

因hexo-renderer-marked不支持数学公式的渲染,其他渲染器又有一些问题,如hexo-renderer-pandoc过于沉重,hexo-renderer-markdown-it对NexT主题支持不佳,因此选用hexo-renderer-kramed渲染器。本文解决了该渲染器在渲染Markdown及数学公式时遇到的部分问题。

1 hexo-renderer-kramed不能渲染Todo List

原来的渲染器hexo-renderer-marked是支持的,那就翻一下hexo-renderer-marked的GitHub仓库的Pull Request。

发现在这个PR里,hexo-renderer-marked加入了对Todo List的支持,那就拷贝这个PR中lib/renderer.js里新增的代码:

// Support To-Do List
Renderer.prototype.listitem = function(text) {
  if (/^\s*\[[x ]\]\s*/.test(text)) {
    text = text.replace(/^\s*\[ \]\s*/, '<input type="checkbox"></input> ').replace(/^\s*\[x\]\s*/, '<input type="checkbox" checked></input> ');
    return '<li style="list-style: none">' + text + '</li>\n';
  } else {
    return '<li>' + text + '</li>\n';
  }
};

加入到本地的hexo文件夹的/node_modules/hexo-renderer-kramed/lib/renderer.js的第19行中。

保存后重新hexo cleanhexo g,就渲染成功了。

其实这个解决方案不是我翻PR找到的,而是我在GitHub乱搜索时在这里找到的。本来并不指望解决这个问题的,又学到一招。

2 hexo-renderer-kramed渲染MathJax时与Markdown语法冲突

关于如何修改语义冲突,网上的教程讲得很详细了,比如:

  • hexo下LaTeX无法显示的解决方案 - zealscott - 简书
  • 解决hexo-next主题和mathjax下划线冲突问题 | 拾荒志

但网上找到的教程通常只讲述了如何修改_\\的冲突。我将我遇到的所有问题一一整理如下。

下文的问题通常是行内公式的问题,目前看来公式块受到的影响比较小。

2.1 行内公式与行内代码冲突

问题描述:把行内公式作为行内代码输入时(如下),会显示异常,即`` ‘ 被 转 义 成 ‘ `被转义成` `了。

`$ a+b $`

翻一下hexo-renderer-kramed的文档,发现作者写在这里了:

所以要想输入行内代码中的公式,在$前后加上空格就行了:

` $ a+b $ `

2.2 下划线_被转义为斜体而非LaTeX下标

问题描述:当公式中出现多个下划线时,会被kramed渲染为Markdown斜体,导致公式显示异常。

Markdown本身的语法是支持*_都被转义为斜体的,所以我们可以取消掉kramed对_的转义。

打开本地hexo文件夹下的/node_modules/kramed/lib/rules/inline.js,找到第20行如下代码:

em: /^\b_((?:__|[\s\S])+?)_\b|^\*((?:\*\*|[\s\S])+?)\*(?!\*)/,

修改为:

em: /^\*((?:\*\*|[\s\S])+?)\*(?!\*)/,

就取消了对下划线_的转义。

以后使用斜体的话只用*符号就够了。如果LaTeX要使用大量*符号,可用\ast代替。

2.3 反斜杠\\被转义为\而非LaTeX换行

问题描述:当公式中出现\\表示换行时,会被kramed渲染为\,导致公式显示异常。

取消掉对\\的转义就行了。

同上,找到inline.js中第11行如下代码:

escape: /^\\([\\`*\[\]()#$+\-.!_>])/,

修改为:

escape: /^\\([`*\[\]()#$+\-.!_>])/,

就取消了对反斜杠\\的转义。

2.4 LaTeX紧贴符\!不被转义

问题描述:当公式中出现\!表示紧贴符号时,会被kramed渲染为!,导致公式显示异常。

同上,把escape:后的正则表达式中的!去掉即可,取消掉对\!的转义。

2.5 反斜杠加竖线\|被转义为|而非LaTeX双竖线

问题描述:当公式中出现\|表示紧贴符号时,会被kramed渲染为|,导致公式显示异常。

真是个困扰了半天的bug,上面的escape:后面也没有|啊。

找了我n个小时,原来还是inline.js代码的问题。

找到第64行如下代码:

escape: replace(inline.escape)('])', '~|])')(),

修改为:

escape: replace(inline.escape)('])', '~])')(),

就取消了对\|的转义。

执行完以上步骤后,记得hexo cleanhexo g走一波。

总结:哪里被kramed转义就检查escape对应的部分。

3 总结

  • 多上GitHub看看原仓库的文档、issues、PR,会有收获的,实在不行直接搜,比百度好使。
  • 熟悉流程,Hexo的原理是根据渲染器,把Markdown语法转为HTML语法。所以一些显示bug不一定是主题的问题,而很有可能是渲染器的问题。所以看看渲染器的源码总是有收获的。

欢迎来核心舱玩:卡洛的核心舱

热门文章

暂无图片
编程学习 ·

Java输出数组的内容

Java输出数组的内容_一万个小时-CSDN博客_java打印数组内容1. 输出内容最常见的方式// List<String>类型的列表List<String> list new ArrayList<String>();list.add("First");list.add("Second");list.add("Third");list.ad…
暂无图片
编程学习 ·

母螳螂的“魅惑之术”

在它们对大蝗虫发起进攻的时候&#xff0c;我认认真真地观察了一次&#xff0c;因为它们突然像触电一样浑身痉挛起来&#xff0c;警觉地面对限前这个大家伙&#xff0c;然后放下自己优雅的身段和祈祷的双手&#xff0c;摆出了一个可怕的姿势。我被眼前的一幕吓到了&#xff0c;…
暂无图片
编程学习 ·

疯狂填词 mad_libs 第9章9.9.2

#win7 python3.7.0 import os,reos.chdir(d:\documents\program_language) file1open(.\疯狂填词_d9z9d2_r.txt) file2open(.\疯狂填词_d9z9d2_w.txt,w) words[ADJECTIVE,NOUN,VERB,NOUN] str1file1.read()#方法1 for word in words :word_replaceinput(fEnter a {word} :)str1…
暂无图片
编程学习 ·

HBASE 高可用

为了保证HBASE是高可用的,所依赖的HDFS和zookeeper也要是高可用的. 通过参数hbase.rootdir指定了连接到Hadoop的地址,mycluster表示为Hadoop的集群. HBASE本身的高可用很简单,只要在一个健康的集群其他节点通过命令 hbase-daemon.sh start master启动一个Hmaster进程,这个Hmast…
暂无图片
编程学习 ·

js事件操作语法

一、事件的绑定语法 语法形式1 事件监听 标签对象.addEventListener(click,function(){}); 语法形式2 on语法绑定 标签对象.onclick function(){} on语法是通过 等于赋值绑定的事件处理函数 , 等于赋值本质上执行的是覆盖赋值,后赋值的数据会覆盖之前存储的数据,也就是on…
暂无图片
编程学习 ·

Photoshop插件--晕影动态--选区--脚本开发--PS插件

文章目录1.插件界面2.关键代码2.1 选区2.2 动态晕影3.作者寄语PS是一款栅格图像编辑软件&#xff0c;具有许多强大的功能&#xff0c;本文演示如何通过脚本实现晕影动态和选区相关功能&#xff0c;展示从互联网收集而来的一个小插件&#xff0c;供大家学习交流&#xff0c;请勿…
暂无图片
编程学习 ·

vs LNK1104 无法打开文件“xxx.obj”

写在前面&#xff1a; 向大家推荐两本新书&#xff0c;《深度学习计算机视觉实战》和《学习OpenCV4&#xff1a;基于Python的算法实战》。 《深度学习计算机视觉实战》讲了计算机视觉理论基础&#xff0c;讲了案例项目&#xff0c;讲了模型部署&#xff0c;这些项目学会之后可以…
暂无图片
编程学习 ·

工业元宇宙的定义与实施路线图

工业元宇宙的定义与实施路线图 李正海 1 工业元宇宙 给大家做一个关于工业元宇宙的定义。对于工业&#xff0c;从设计的角度来讲&#xff0c;现在的设计人员已经做到了普遍的三维设计&#xff0c;但是进入元宇宙时代&#xff0c;就不仅仅只是三维设计了&#xff0c;我们的目…
暂无图片
编程学习 ·

【leectode 2022.1.15】完成一半题目

有 N 位扣友参加了微软与力扣举办了「以扣会友」线下活动。主办方提供了 2*N 道题目&#xff0c;整型数组 questions 中每个数字对应了每道题目所涉及的知识点类型。 若每位扣友选择不同的一题&#xff0c;请返回被选的 N 道题目至少包含多少种知识点类型。 示例 1&#xff1a…
暂无图片
编程学习 ·

js 面试题总结

一、js原型与原型链 1. prototype 每个函数都有一个prototype属性&#xff0c;被称为显示原型 2._ _proto_ _ 每个实例对象都会有_ _proto_ _属性,其被称为隐式原型 每一个实例对象的隐式原型_ _proto_ _属性指向自身构造函数的显式原型prototype 3. constructor 每个prot…
暂无图片
编程学习 ·

java练习代码

打印自定义行数的空心菱形练习代码如下 import java.util.Scanner; public class daYinLengXing{public static void main(String[] args) {System.out.println("请输入行数");Scanner myScanner new Scanner(System.in);int g myScanner.nextInt();int num g%2;//…
暂无图片
编程学习 ·

RocketMQ-什么是死信队列?怎么解决

目录 什么是死信队列 死信队列的特征 死信消息的处理 什么是死信队列 当一条消息初次消费失败&#xff0c;消息队列会自动进行消费重试&#xff1b;达到最大重试次数后&#xff0c;若消费依然失败&#xff0c;则表明消费者在正常情况下无法正确地消费该消息&#xff0c;此时…
暂无图片
编程学习 ·

项目 cg day04

第4章 lua、Canal实现广告缓存 学习目标 Lua介绍 Lua语法 输出、变量定义、数据类型、流程控制(if..)、循环操作、函数、表(数组)、模块OpenResty介绍(理解配置) 封装了Nginx&#xff0c;并且提供了Lua扩展&#xff0c;大大提升了Nginx对并发处理的能&#xff0c;10K-1000K Lu…
暂无图片
编程学习 ·

输出三角形

#include <stdio.h> int main() { int i,j; for(i0;i<5;i) { for(j0;j<i;j) { printf("*"); } printf("\n"); } }
暂无图片
编程学习 ·

stm32的BOOTLOADER学习1

序言 最近计划学习stm32的BOOTLOADER学习,把学习过程记录下来 因为现在网上STM32C8T6还是比较贵的,根据我的需求flash空间小一些也可以,所以我决定使用stm32c6t6.这个芯片的空间是32kb的。 #熟悉芯片内部的空间地址 1、flash ROM&#xff1a; 大小32KB&#xff0c;范围&#xf…
暂无图片
编程学习 ·

通过awk和shell来限制IP多次访问之学不会你打死我

学不会你打死我 今天我们用shell脚本&#xff0c;awk工具来分析日志来判断是否存在扫描器来进行破解网站密码——限制访问次数过多的IP地址&#xff0c;通过Iptables来进行限制。代码在末尾 首先我们要先查看日志的格式&#xff0c;分析出我们需要筛选的内容&#xff0c;日志…
暂无图片
编程学习 ·

Python - 如何像程序员一样思考

在为计算机编写程序之前&#xff0c;您必须学会如何像程序员一样思考。学习像程序员一样思考对任何学生都很有价值。以下步骤可帮助任何人学习编码并了解计算机科学的价值——即使他们不打算成为计算机科学家。 顾名思义&#xff0c;Python经常被想要学习编程的人用作第一语言…
暂无图片
编程学习 ·

蓝桥杯python-数字三角形

问题描述 虽然我前后用了三种做法&#xff0c;但是我发现只有“优化思路_1”可以通过蓝桥杯官网中的测评&#xff0c;但是如果用c/c的话&#xff0c;每个都通得过&#xff0c;足以可见python的效率之低&#xff08;但耐不住人家好用啊&#xff08;哭笑&#xff09;&#xff09…