Next主题踩坑优化

对于Typora上编辑的markdown文档, 直接使用Next主题会有导致一些问题:

  • Latex公式不能够正常显示
  • mermaid绘制的图形不能够正常显示
  • 高亮效果不能够正常显示

术语

  • 站点配置文件config.yml
  • 主题配置文件themes/next/config.yml

Latex公式显示异常

  1. 更换hexo默认的markdown渲染引擎

    npm uninstall hexo-renderer-marked --save
    npm install hexo-renderer-kramed --save

    hexo-renderer-kramed引擎解决了一些问题, 但是并没有完全解决

  2. 取消一些转义
    对文件node_modules\kramed\lib\rules\inline.js进行修改

    //escape: /^\\([\\`*{}\[\]()#$+\-.!_>])/,
    escape: /^\\([`*\[\]()#$+\-.!_>])/,  //取消了对\,{,}的转义
    
    //em: /^\b_((?:__|[\s\S])+?)_\b|^\*((?:\*\*|[\s\S])+?)\*(?!\*)/,
    em: /^\*((?:\*\*|[\s\S])+?)\*(?!\*)/,    
  3. 在 Next 主题中开启 MathJax 开关
    对主题配置文件themes/next/config.yml进行修改

    # Math Equations Render Support
    math:
      enable: true #由false改为true
      per_page: true
  4. 在文章的Front-matter里打开mathjax开关
    使用hexo new命令生成的markdown文件的开头部分

    ---
    title: index.html
    date: 2018-07-05 12:01:30
    tags:
    mathjax: true
    --

mermaid图形显示异常

  1. 添加对于mermaid的支持

    npm install --save hexo-filter-mermaid-diagrams
  2. 在主题配置文件/themes/next/_config.yml中启用mermaid模块

     #Mermaid tag
    mermaid:
      enable: true
      # Available themes: default | dark | forest | neutral
      theme: forest

高亮效果显示异常


   转载规则


《》 熊水斌 采用 知识共享署名 4.0 国际许可协议 进行许可。
 上一篇
Maven简介maven是什么Maven本质是一个项目管理工具, 将项目开发和管理过程抽象成一个项目对象模型(Project Object Model, 即POM). Maven工具本身的概念并不包括pom.xml和maven仓库. mav
2022-11-11
下一篇 
默认约定在/opt目录下创建文件夹module.software文件夹 software文件夹用来存放所有的jar包 module文件夹用来存放解压后的文件 设置Python的阿里云镜像Windows windows系统在C:\Users\
2022-11-11
  目录