☰

使用 Python 安装 Markdown 扩展

tag-icon • tag-icon python markdown
使用 Python 安装 Markdown 扩展

这安装说明（git://gitorious.org/python-markdown/mainline.git）在文件中说using_as_module.txt

您可以传递的参数之一是扩展列表。扩展必须作为 Python 模块提供，无论是在包内 markdown.extensions 还是在您的 PYTHONPATH 上，其名称以 开头mdx_，后跟扩展的名称。因此，extensions=['footnotes']将首先查找模块markdown.extensions.footnotes，然后查找名为 的模块 mdx_footnotes。请参阅特定于您正在使用的扩展的文档，以获取有关为该扩展指定配置设置的帮助。

我将文件夹“extensions”放到 ~/bin/python/ 中，这样我的 PYTHONPATH 如下

export PYTHONPATH=/Users/masi/bin/python/:/opt/local/Library/Frameworks/Python.framework/Versions/2.6/

说明书上说我需要导入插件，这样

import markdown
import <module-name>

但是，我在我的 Python 中看不到任何模块。这表明扩展不能作为“[我的] PYTHONPATH 上的 python 模块 - - 以 mdx_ - - 开头”使用。

如何让 Markdown 的扩展发挥作用？

第二次尝试

我在 ~/bin/markdown 运行

git clone git://gitorious.org/python-markdown/mainline.git python-markdown
cd python-markdown
python setup.py install

我将该文件夹放入/Users/masi/bin/markdown/python-markdown/build我的 PATH 中，因为安装消息提示我这是扩展的新位置。

我在测试 markdown 文档中有以下内容

[TOC]
-- headings here with # -format ---

但是，我没有得到目录。这表明我们需要在通过 markdown.py 脚本进行编译时以某种方式激活扩展。**问题回到了我第一次引用的文本，这让我感到很困惑。

答案1

virtualenv当我使用 Python 进行任何类型的项目时，我喜欢设置。因此，在基于 Debian 的系统上，我安装pip并virtualenv

sudo aptitude install python-pip python-virtualenv

然后如果使用 python markdown，我将创建我的虚拟环境并使用它pip安装python-markdown和ElementTree

virtualenv mynewbook
pip -E mynewbook install -U Markdown ElementTree

为了方便起见，我通常在切换到新项目目录后将环境设置为本地虚拟环境

cd mynewbook
source bin/activate

然后将我的书放在文件 mybook.markdown 中，格式为

[TOC]

Heading-a
==========

---text---

Heading-b
------------

我必须得跑

markdown mybook.markdown -f mybook.html -x toc

完成虚拟环境设置后，只需输入

deactivate

相关内容