android展示latex_在 GitHub Page 中正常展示任意 LaTeX 源码片段

本文已加入专栏文章目录。

精简版GitHub Page 的(一种)输入是 markdown 文件，输出是 HTML/CSS/JS 文件。

如果 markdown 文件包含代码块，且代码块中包含花括号 { 或 }，尤其是包含 {% 或 { { 符号组合时，GitHub Page 会报错。

分别在代码块前后添加 {% raw %} 和 {% endraw %} 即可解决该问题。

参考资料：Jekyll 官方文档 Tags Filters - Code snippet highlighting

展开版Liquid 的标记可分为三类objects，{ { ... }}

tags，{% ... %}

filters，{ ... | ...}

假设一个开启了 GitHub Page 的项目，其README.md 文件包含如下几行

```latex

\newcommand\abc{%

hello, abc.

}

```

这几行，在网站构建时会产生错误。在项目的设置页面，我们能看到类似这样的报错信息

同时，在 GitHub 的账号邮箱里，能收到构建失败的邮件，关键词是

The tag `{%` on line 18 in `README.md` was not properly closed with `%}`.

根据帮助链接的建议，我们在本地构建，能得到更为详细的错误信息。

Liq