HPCesia/hexo-highlighter-shiki
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

update README

Browse Source
This commit is contained in:
HPCesia 2024-10-20 21:06:38 +08:00
parent ebd0a3a449
commit 6e56de5e56
2 changed files with 4 additions and 2 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

3
README.md
View File

@ -36,6 +36,7 @@ shiki:
line_number: false line_number: false
strip_indent: true strip_indent: true
tab_replace: " " tab_replace: " "
pre_style: true # Preserve the style of the <pre> tag, i.e., the theme's `background-color`.
additional: additional:
langs: # List of the TextMate grammar json of languages to be added. langs: # List of the TextMate grammar json of languages to be added.
- path/to/lang_grammar.json - path/to/lang_grammar.json
@ -56,7 +57,7 @@ See [Dual Themes](https://shiki.style/guide/dual-themes) for how to switch betwe
## Bugs ## Bugs
### mathjax ### mathjax
If you are using [hexo-filter-mathjax](https://github.com/next-theme/hexo-filter-mathjax) or any other plugin that uses mathjax to render mathematical formulas locally, you may encounter an `Error: Can't find handler for document` when rendering articles that include code blocks and have mathjax rendering enabled. This is a problem with mathjax, as its LiteDOM cannot parse complex HTML fragments. If you are using [hexo-filter-mathjax](https://github.com/next-theme/hexo-filter-mathjax) or any other plugin that uses mathjax to render mathematical formulas locally, you may encounter an `Error: Can't find handler for document` when rendering articles that include code blocks and have mathjax rendering enabled. This is a problem with mathjax, as its LiteDOM adaptor cannot parse complex HTML fragments.
#### Solution #### Solution

3
README_zh-CN.md
View File

@ -35,6 +35,7 @@ shiki:
line_number: false line_number: false
strip_indent: true strip_indent: true
tab_replace: " " tab_replace: " "
pre_style: true # Preserve the style of the <pre> tag, i.e., the theme's `background-color`.
additional: additional:
langs: # List of the TextMate grammar json of languages to be added. langs: # List of the TextMate grammar json of languages to be added.
- path/to/lang_grammar.json - path/to/lang_grammar.json
@ -55,7 +56,7 @@ shiki:
## Bugs ## Bugs
### mathjax ### mathjax
如果你正在使用 [hexo-filter-mathjax](https://github.com/next-theme/hexo-filter-mathjax) 或其他任意在本地使用 mathjax 渲染数学公式的插件，在渲染包含代码块且开启 mathjax 渲染的文章时可能会出现 `Error: Can't find handler for document`。这是 mathjax 的问题，mathjax 的 LiteDOM 无法解析复杂的 HTML 片段。 如果你正在使用 [hexo-filter-mathjax](https://github.com/next-theme/hexo-filter-mathjax) 或其他任意在本地使用 mathjax 渲染数学公式的插件，在渲染包含代码块且开启 mathjax 渲染的文章时可能会出现 `Error: Can't find handler for document`。这是 mathjax 的问题，mathjax 的 LiteDOM adaptor 无法解析复杂的 HTML 片段。
#### 解决方法 #### 解决方法