在 MoinMoin 中使用 Pygments¶
从 Pygments 0.7 开始,源代码分发版附带一个 Moin 解析器插件,可用于在 Moin wiki 页面中获得 Pygments 高亮显示。
要使用它,请将文件 external/moin-parser.py 从 Pygments 分发版复制到 Moin 实例的 data/plugin/parser 子目录中。编辑文件顶部的选项(当前为 ATTACHMENTS
和 INLINESTYLES
),并将文件名重命名为解析器指令应具有的名称。例如,如果将文件命名为 code.py
,则可以使用以下 Wiki 标记获取突出显示的 Python 代码示例
{{{
#!code python
[...]
}}}
其中 python
是要使用的词法分析器的 Pygments 名称。
此外,如果将 ATTACHMENTS
选项设置为 True,Pygments 也会被调用用于所有附件,这些附件的文件名没有注册其他解析器。
您有责任包含 CSS 规则,这些规则将 Pygments CSS 类映射到颜色。可以使用 pygmentize 输出样式表文件,将其放入 Moin 实例的 htdocs 目录中,然后在 Moin 配置中的 stylesheets 配置选项中包含它,例如
stylesheets = [('screen', '/htdocs/pygments.css')]
如果您不想这样做,并且愿意接受更大的 HTML 输出,则可以将 INLINESTYLES
选项设置为 True。