前言


為了整理數學公式和推導的美觀性,在之前的文章中引入了LaTeX的語法。在編輯器上顯示正常,但當hexo g後生成的網頁中LaTeX語法沒有得到正確渲染。以下將為Hexo添加支持LaTex語法。 注意:有些hexo主題本身就支持LaTeX渲染,根據readme打開即可

歷程


筆者在網路上看了多種的方案,共性有以下: 1. mathjax + hexo-renderer-kramed 2. mathjax + pandoc

對於<1>:安裝mathjax有人用hexo-math,有人手動添加,有人用hexo-renderer-mathjax,但這些只要搭配kramed都需要手動修改轉義規則,麻煩一些。

對於<2>: pandoc原生對LaTeX良好支持,不用修改轉義規則,所以本人本文採用pandoc + mathjax的方式完成對LaTeX的渲染。

注意:pandoc相對於hexo原生的marked渲染器,其對語法更加敏感,如二級標題下的分割線與二級標題中間一定要一個空行,否則無法正確渲染

步驟


  1. 安裝pandoc

前往:https://pandoc.org/installing.html ,針對不同的OS有不同的安裝方式,Win下簡單的下載執行檔即可。

接著安裝hexo的pandoc渲染器(注意要完成上部pandoc的安裝):

1
npm install hexo-renderer-pandoc --save
  1. 安裝mathjax

此處筆者有幸找到了別人開發好的插件,非常方便,此處鳴謝。具體的安裝配置方式在下地址README中均有詳述:https://github.com/next-theme/hexo-filter-mathjax

  1. 三連即可
1
2
3
hexo clean
hexo g
hexo s

測試