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

Question

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

我想要什么；

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

我有什么;

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

缺少什么？

Answer 1

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

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

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

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

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

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

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