数学排版

💡 原文英文,约200词,阅读约需1分钟。
📝

内容提要

本文介绍了如何在Hugo项目中设置KaTeX进行数学排版。首先,在/layouts/partials/目录下创建math.html部分,引用Auto-render扩展或本地脚本。通过将项目配置中的math参数设置为true,可以全局启用KaTeX,也可以在内容文件中单独为每页启用。文中还提供了支持的TeX函数的在线参考及示例。

🔎

延伸解读

启用方式:全局与单页

文章指出,KaTeX 的启用有两种途径:在项目配置中将 math 参数设为 true 可全局启用;在单个内容文件的 front matter 中添加 math: true 则仅对该页面生效。这种设计让作者能灵活控制,避免在不需数学排版的页面加载额外脚本,从而优化性能。

模板集成与条件加载

集成时需在 /layouts/partials/ 下创建 math.html,并在其中引用 KaTeX 的 Auto-render 扩展或本地脚本。随后在模板中通过条件判断包含该 partial,例如 {{ if or .Params.math .Site.Params.math }}。这样只有当全局或页面参数启用时才会加载,避免资源浪费。

语法示例与参考

文章提供了行内与块级数学的示例:行内如 $\varphi = \dfrac{1+\sqrt5}{2}= 1.6180339887…$,块级如 $$ \varphi = 1+\frac{1} {1+\frac{1} {1+\frac{1} {1+\cdots} } } $$。同时提醒读者参考支持的 TeX 函数在线列表,以确保使用的命令能被 KaTeX 正确渲染。

❓

Q&A

如何在Hugo项目中设置KaTeX进行数学排版?

在Hugo项目中,需要在/layouts/partials/目录下创建一个math.html部分,并引用Auto-render扩展或本地脚本。

如何全局启用KaTeX?

通过在项目配置中将math参数设置为true,可以全局启用KaTeX。

如何在特定页面启用KaTeX?

在内容文件中添加参数math: true,可以在特定页面启用KaTeX。

math.html文件中需要包含哪些内容?

math.html文件中需要引用Auto-render扩展或本地脚本,并在模板中包含该部分。

KaTeX支持哪些TeX函数?

文中提供了支持的TeX函数的在线参考,包括行内数学和块级数学的示例。

可以给出行内数学和块级数学的示例吗?

行内数学示例:$\varphi = \dfrac{1+\sqrt5}{2}= 1.6180339887…$,块级数学示例:$$ \varphi = 1+\frac{1} {1+\frac{1} {1+\frac{1} {1+\cdots} } } $$。

🏷️

标签

➡️

继续阅读