在 Pelican 中安装第三方 Markdown 扩展答案

【问题标题】：Install third-party Markdown extension in Pelican在 Pelican 中安装第三方 Markdown 扩展
【发布时间】：2016-01-01 19:38:17
【问题描述】：

我将 Pelican 用于静态博客，并尝试安装 figure-ref 扩展。由于我使用的是 Markdown，因此该插件依赖于 figureAltCaption 第三方 Markdown 扩展。 但是我不知道如何安装它。

Pelican 有一个 MD_EXTENSIONS configuration option，但我尝试了一些明显的选择，但都没有运气。这似乎是一个非常简单的给我，但目前尚不清楚如何进行。希望有一些建议。

【问题讨论】：

【解决方案1】：

很遗憾，figureAltCaption 的作者似乎没有提供安装脚本。我的建议是创建一个并将其作为拉取请求提供。这篇关于为 Python-Markdown 创建扩展的tutorial 也涵盖了创建安装脚本。

但是，作为一种快捷方式，您应该能够将figureAltCaption.py 文件复制到相应的目录。通常您需要站点包目录。正如this answer 所示，只需从 Python 执行以下操作：

>>> import site; site.getsitepackages()

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

现在扩展程序在您的 PYTHONPATH 上，它应该是可导入的。在 Python 提示符下，尝试：

import figureAltCaption

如果您没有收到任何错误，则说明它有效，您只需告诉 Pelican。

MD_EXTENSIONS = ['figureAltCaption']

【讨论】：

工作就像一个魅力，非常感谢。我认为这很简单。我尝试按照 Python-Markdown 扩展教程中的说明进行操作，但一直遇到与我必须在 setup.py. 中定义的各个字段相关的奇怪错误，谢谢！
此解决方案也适用于 MKDocs。非常感谢您的贡献。
以3.7.0 Pelican 版本开头，我们需要使用MARKDOWN setting 而不是MD_EXTENSIONS。谢谢。
嘿@СашаЧерных，你能在 pelican 3.7 及更高版本（我使用的是 v4）上完成这项工作吗？我无法让它工作......
@haki，这在 Pelican 4.0.1 中对我有用。也许pelicanconf.py of my project 会帮助你。谢谢。