LaTeX语法

Anzhiyu主题配置数学公式

有两种方法。

方法一，参考为hexo博客更换pandoc渲染，使用mathjax无论是前端渲染还是后端渲染公式块都无法正常换行。

方法二，参考Hexo博客渲染KaTeX数学公式，可以正常渲染。

最终采用了第二种渲染方法。步骤如下所示。

  1. 关闭主题自带的 mathjax 和 katex 。因为方法二采用的是自己启用 katex 。

    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    17
    # Math (数学)
    # --------------------------------------
    # About the per_page
    # if you set it to true, it will load mathjax/katex script in each page (true 表示每一页都加载js)
    # if you set it to false, it will load mathjax/katex script according to your setting (add the 'mathjax: true' in page's front-matter)
    # (false 需要时加载，须在使用的 Markdown Front-matter 加上 mathjax: true)

    # MathJax
    mathjax:
      enable: false
      per_page: false

    # KaTeX
    katex:
      enable: false
      per_page: false
      hide_scrollbar: true

    为什么不用主题自带的 mathjax ，因为无法正确换行。
    为什么不用主题自带的 katex ，因为渲染经常失灵，本地渲染成功后部署到 github 以后才是正常的，不过经常本地都渲染失败，根据我多方查找资料，这跟 pjax 有关，关掉主题中的 pjax 或许有效，但会影响其它功能。至于 pjax 如何使渲染失效，我不清楚，因为路人甲也不清楚，路人乙也不是很清楚。但终归是找到的方法二这样的解决方法。

  2. 卸载hexo自带的渲染渲染器，因为它渲染不了数学公式。

    1
    npm uni hexo-renderer-marked

    安装 hexo-renderer-markdown-it-plus 渲染器。此渲染器默认包含且开启了 @iktakahiro/markdown-it-katex 插件，可渲染 11.1 版本以前的 KaTeXKATEX 公式。但 KaTeXKATEX 自 13.0 开始渲染机制发生了变化，需要更换为 @andatoshiki/markdown-it-katex 插件。

    1
    2
    3
    npm i hexo-renderer-markdown-it-plus
    npm install katex
    npm install @andatoshiki/markdown-it-katex

    在_config.yml中配置 markdown_it_plus 渲染器，即关闭其自带的 @iktakahiro/markdown-it-katex 插件，启用新版插件 @andatoshiki/markdown-it-katex。

    1
    2
    3
    4
    5
    6
    7
    8
    9
    markdown_it_plus:
      # ...
      plugins:
        - plugin:
          name: '@iktakahiro/markdown-it-katex'
          enable: false
        - plugin:
          name: '@andatoshiki/markdown-it-katex'
          enable: true

  3. 在主题配置文件中，引入katex的css文件。

    1
    2
    3
    4
    5
    inject:
      head:
        # 自定义css
        # - <link rel="stylesheet" href="/css/custom.css" media="defer" onload="this.media='all'">
        - <link rel="stylesheet" href="https://lib.baomitu.com/KaTeX/latest/katex.min.css">

  4. hexo cl、hexo g、hexo s，小三连查看效果，确认生效后hexo cl、hexo g -d，部署到云端。

分数

frac ：fraction，分数。

1
\frac{son}{mother}

sonmother\frac{son}{mother}

偏导

partial ：偏爱的。

1
\frac{\partial f}{\partial x}

∂f∂x\frac{\partial f}{\partial x}

向量

vec ：vector，向量。

overrightarrow：上方右箭头。

overleftarrow：上方左箭头。

x⃗x→y←\vec x \quad \overrightarrow x \quad \overleftarrow y

点乘

cdot：circle dot，圆点。

1
\vec x \cdot \vec y

x⃗⋅y⃗\vec x \cdot \vec y