希望可以配置排除页面

[Erzbir]

存在的问题

目前插件会将代码注入到所有页面中, 但 / 以及 /links 这样的页面大概率不会需要代码高亮, 希望可以通过配置排除

期望的实现

如果直接在现有的代码上修改可以:

• 添加一个配置项, 配置需要排除的页面
• 插件过滤掉排除的页面, 不在其中插入代码

目前已经 fork 仓库, 并添加了这个功能:

但测试发现 $formkit: select 无法正常显示已保存的配置项

[ruibaby]

将 js 放置在所有页面的 head 标签的主要原因就是兼容部分主题的 pjax 功能。据我所知，如果不放在所有页面的 head 标签中，那么通过 pjax 导航到需要 Shiki 的页面的时候，将不会更新 head 标签的内容，即便更新了可能也不会执行 js，最终导致无法渲染代码高亮。

如果一定要添加设置，我的建议是添加一个 Pjax 兼容 的选项，只有开启之后才在所有页面添加 js 标签，否则只在文章、页面、和 额外渲染规则 里的页面上添加。

[Erzbir]

如果一定要添加设置，我的建议是添加一个 Pjax 兼容 的选项，只有开启之后才在所有页面添加 js 标签，否则只在文章、页面、和 额外渲染规则 里的页面上添加。

我的理解是, 主题如果要用 PJAX, 那主题侧就应该做好兼容. 如果主题不处理新插入的脚本, 大概率就会出现出问题

总的来说就是插件可以不必专门针对 PJAX 兼容, 插件插入 JS 有可预期的行为以及透明的调用方式, 兼容交给主题就好. 因为这不是一个技术标准, 也不是唯一的局部刷新实现

在此插件中, 我有注意到一些代码存在对 PJAX 的兼容:

plugin-shiki/src/main/java/run/halo/shiki/ShikiHeadProcessor.java

Line 98 in 930b400

<script type="module" class="pjax" data-pjax>

这段代码添加了 data-pjax 这样的属性和 class="pjax"

问题在于 PJAX 只是其中一个局部刷新的实现, 比如还有 swup 等, 并且也没有技术标准, 像 data-pjax 这样的属性是主题开发者人为控制的, 意图可能是做某些标记, 开发者可以有无数种标记方式, 并不是 PJAX 指定的 data-pjax.

plugin-shiki/src/main/java/run/halo/shiki/ShikiHeadProcessor.java

Line 108 in 930b400

window.addEventListener('pjax:complete', () => {

这段代码似乎不应该专门处理 pjax:complete

也是同样的问题, 除了 PJAX 之外还有其他的实现, 无 DOMContentLoaded 事件的问题或许也应该交给主题开发者来处理

[ruibaby]

有道理，但我这样做的目的是为了让绝大多数用户遇不到由 pjax 不兼容带来的困惑，并且已经测试过应用市场大部分支持 pjax 的主题。如果你有更好的解决方式，欢迎 PR。

我实在不想处理任何关于 pjax 的问题，这是一个糟透的库。