如何在 Hugo/Pygments 中使用“long”类名

Posted 2023-03-30

【中文标题】如何在 Hugo/Pygments 中使用“long”类名

【英文标题】：How to use `long` class names in Hugo/Pygments

【发布时间】：2019-09-11 14:53:31

【问题描述】：

我在 Hugo 服务器上使用 pygmentsUseClasses=true 设置，但我收到的短类名称如 k 用于 keyword。

我想要什么；

<span class="token keyword">const</span>

我有什么;

<span class="k">const</span>

缺少什么？

【参考方案1】：

我只是在一个不相关的搜索中徘徊，但如果其他人有这个问题（截至 2020-01-19 确认，但雨果是一个移动的目标）：

k 是类名。 如果没有启用类，您将在 html 输出中获得内联样式。 例如：<span style="color:#66d9ef">const</span>

Hugo 现在使用Chroma 而不是Pygments 来代替syntax highlighting，这肯定意味着最终pygmentsUseClasses 将无法识别。 current documented configuration 是markup.highlight.noClasses：

[markup.highlight]
noClasses = false # instead of pygmentsUseClasses = true

（实际问题的实际答案）我没有看到 Hugo 配置在 HTML 输出中生成长类名。

一些external helpers 使用他们自己的荧光笔。这些可能会产生长文件名，尽管它因助手而异。例如，我的 RST 内容会产生长类名，但我的 AsciiDoc 内容不会。如果您绝对必须有长类名，请尝试使用外部助手。

警告：外部助手会影响构建时间。与所有非核心行为一样，在未来的 Hugo 版本中存在被弃用的风险。