在 Pelican 中安装第三方 Markdown 扩展

Question

我将 Pelican 用于静态博客，并尝试安装 figure-ref extension. Since I'm using Markdown, the plugin relies on the figureAltCaption 第三方 Markdown 扩展。 但是我不知道如何安装它。

Pelican 有一个 MD_EXTENSIONS configuration option，但我尝试了几个明显的选项但没有成功。这似乎是一个非常简单的 gimme，但尚不清楚如何进行。希望得到一些建议。

Answer 1

不幸的是，figureAltCaption 的作者似乎没有提供安装脚本。我的建议是创建一个并将其作为拉取请求贡献。 tutorial 关于为 Python-Markdown 创建扩展的内容还包括创建安装脚本。

但是，作为快捷方式，您应该能够将 figureAltCaption.py 文件复制到适当的目录。通常您需要 site-packages 目录。如 this answer 所示，只需从 Python 执行以下操作：

>>> import site; site.getsitepackages()

然后将figureAltCaption.py文件复制到返回的第一个目录。

既然扩展已经在您的 PYTHONPATH 中，它应该是可以导入的。在 Python 提示符下，尝试：

import figureAltCaption

如果您没有收到任何错误，那么它就成功了，您只需要告诉 Pelican。

MD_EXTENSIONS = ['figureAltCaption']

Install third-party Markdown extension in Pelican