Question

TLDR：我正在尝试在鹈鹕中进行CSS行编号，同时写下markdown。 Pygsments是间接使用的，你不能将选项传递给它，所以我不能将这些行分开，并且没有CSS选择器用于＆＃34; new line＆＃34;。

在Pelican中使用Markdown，我可以使用CodeHilite扩展生成代码块。如果您使用Markdown ...仅使用RST（并且......将所有内容转换为RST），Pelican不支持直接使用pygments。

所以，我尝试过：

MD_EXTENSIONS = [
'codehilite(css_class=highlight,linenums=False,guess_lang=True,use_pygments=True)',
'extra']

和

:::python
<div class="line">import __main__ as main</div>

和

PYGMENTS_RST_OPTIONS = {'classprefix': 'pgcss', 'linenos': 'table'}

我可以显示行号吗？是。我能让他们继续下一个代码块吗？没有。这就是为什么我想使用CSS行编号......当编号开始和停止时，它更容易控制。

任何帮助都会非常感激，我已经搞乱了几个小时。

Answer 1

我唯一知道的是分叉CodeHilite扩展（我和开发人员）。首先，您需要复制现有扩展（此file），更改实现所需结果所需的代码，并将文件保存到PYTHONPATH（可能在＆＃34; sitepackages＆＃中34;目录，其确切位置取决于您所在的系统以及Python的安装方式。请注意，您需要为文件创建唯一的名称，以免与任何其他Python包冲突。

完成后，您需要告诉Pelican。由于Pelican的配置文件只是Python，请导入新的扩展程序（使用不带文件扩展名的文件名称：yourmodule.py =＆gt; yourmodule）并将其包含在扩展程序列表中

from yourmodule import CodeHiliteExtension
MD_EXTENSIONS = [
CodeHiliteExtension(css_class='highlight', linenums=False),
'extra']

请注意，对CodeHiliteExtension的调用不是字符串，而是实际调用类并传入适当的参数，您可以根据需要进行调整。

那应该是它。如果您想设置一种更简单的方式来部署扩展（或将其分发给其他人使用），您可能需要考虑创建一个setup.py文件，这超出了本问题的范围。有关Markdown扩展程序的详细信息，请参阅此tutorial。

如果您希望对扩展中的代码所做的更改提供特定帮助，那么这取决于您要完成的任务。首先，参数将传递给第117行的Pygments。最简单的方法是在那里硬编码你想要的选项。

如果你试图复制reStructuredText中的行为，那么你可能会感到失望。 Docutils用自己的一些处理包装了Pygments。实际上，一些选项永远不会传递给Pygments，而是由reStructeredText解析器本身处理。如果我没记错的话，CSS行编号就是这样一个特征。事实上，Pygments不提供这种选择。

在这种情况下，您需要通过让Pygments返回非编号代码来修改CodeHilite扩展的fork，然后在扩展返回突出显示的代码块之前自己应用必要的钩子。为此，您可能需要在换行符上拆分，然后循环遍历包含每一行的行。最后，加入新包装的行并返回。

我怀疑以下（未经测试的）更改会让您入门：

diff --git a/markdown/extensions/codehilite.py b/markdown/extensions/codehilite.py
index 0657c37..fbd127d 100644
--- a/markdown/extensions/codehilite.py
+++ b/markdown/extensions/codehilite.py
@@ -115,12 +115,18 @@ class CodeHilite(object):
                 except ValueError:
                     lexer = get_lexer_by_name('text')
             formatter = get_formatter_by_name('html',
-                                              linenos=self.linenums,
+                                              linenos=self.linenums if self.linenumes != 'css' else False,
                                               cssclass=self.css_class,
                                               style=self.style,
                                               noclasses=self.noclasses,
                                               hl_lines=self.hl_lines)
-            return highlight(self.src, lexer, formatter)
+            result = highlight(self.src, lexer, formatter)
+            if self.linenums == 'css':
+                lines = result.split('\n')
+                for i, line in enumerate(lines):
+                    lines[i] = '<div class="line">%s</div>' % line
+                result = '\n'.join(lines)
+            return result
         else:
             # just escape and build markup usable by JS highlighting libs
             txt = self.src.replace('&', '&amp;')

通过禁用Pygments并使用JavaScript库进行突出显示，您可以更好地获得所需内容。这取决于您选择的JavaScript库以及它具有的功能。

Answer 2

TL; DR

<{1>}中的

，添加：

pelicanconf.py

显然，您需要正确安装这些

# for highlighting code-segments
# PYGMENTS_RST_OPTIONS = {'cssclass': 'codehilite', 'linenos': 'table'}   # disable RST options
MD_EXTENSIONS = ['codehilite(noclasses=True, pygments_style=native)', 'extra']  # enable MD options

如何使用Markdown在Pelican中使用Pygments？

2 个答案: