如何在 Pelican 中激活 Pygments？

Question

我必须做什么才能使它像官方文档中的示例一样简单？

:::python
print("The triple-colon syntax will *not* show line numbers.")

#!python
print("The path-less shebang syntax *will* show line numbers.")

我应该在 pelicanconf.py 中添加什么？ 这是我的要求.txt:

blinker==1.4
colorama==0.4.4
commonmark==0.9.1
docutils==0.18
feedgenerator==2.0.0
Jinja2==3.0.2
Markdown==3.3.4
MarkupSafe==2.0.1
pelican==4.7.1
pelican-related-posts==1.0.0
pelican-series==2.1.0
Pygments==2.10.0
python-dateutil==2.8.2
pytz==2021.3
rich==10.12.0
six==1.16.0
Unidecode==1.3.2

我正在使用虚拟环境，也许这有帮助。

Answer 1

实际上没有什么可以“激活”的，因为一切都“开箱即用”。我只是对 codehilite 文档感到困惑，因为它指出您需要以某种方式“在 PYTHONPATH 上下载并安装 Pygments 包”。通过下载部分，一切都清楚了，因为 Pygments 是与 Pelican 一起安装的，但由于我不了解 PIP 在虚拟环境中如何工作，所以我在“在 PYTHONPATH 上安装 Pygments 包”时遇到了麻烦。 如果您觉得这个问题没用，请投票删除。

Answer 2

您不需要激活 Pygments。这篇博文提供了一些有关 Pygments 和 CodeHilite 及其工作原理的信息。

https://georgexyz.com/code-highlight-in-pelican.html

Answer 3

要在 Pelican 中激活语法突出显示，需要一些非常简单的步骤。 文档并没有多大帮助，而且似乎很多人都感到困惑。

首先，在markdown中激活

codehilite

扩展

pelicanconf.py
MARKDOWN = {
    'extension_configs': {
        'markdown.extensions.codehilite': {
            'css_class': 'codehilite',
        },
}

确保

pygmentize

命令可用。否则通过 pip 安装

pygmentize

。在大多数情况下，它作为 Pelican 的依赖项安装。

列出所有可用的突出显示样式

pygmentize -L style

然后生成具有您选择的样式的样式表。下面的示例使用

zenburn

样式。

pygmentize -S zenburn -f html -a .codehilite > themes/simple/static/css/styles.css

然后将生成的样式表链接到您的

base.html

中。

<link rel="stylesheet" href="{{ SITEURL }}/{{ THEME_STATIC_DIR }}/css/styles.css" />