embedly_cards 0.2.0

嵌入卡片

Embedly-cards 是一个Pelican插件，提供 restructuredText 指令，允许使用Embed.ly Cards轻松嵌入外部内容。

还可以从 Pelican 构建的网站查看ReST和 markdown实时示例。

特征

只需指定目标页面的 URL，即可轻松地将内容嵌入页面或博客文章中。内容被自动识别、提取和格式化为“卡片”；这可能包含简短的文章预览、嵌入的视频、图片等。

要预览卡片，可以使用Embed.ly在线生成它们。几乎所有网站都兼容，包括 YouTube、Flickr、Google+、地图、Wordpress 等。

安装

嵌入卡可以使用pip安装

$ pip install embedly-cards

或从源代码手动

$ python setup.py install

安装后，只需将其添加到您的pelicanconf.py配置文件中：

PLUGINS = [
    # ...
    'embedly_cards'
]

如果您计划在 markdown .md文件中嵌入内容，则还必须将其添加到MD_EXTENSIONS选项中，如下所示：

from embedly_cards import EmbedlyCardExtension
MD_EXTENSIONS = ['codehilite(css_class=highlight)',
                 'extra',
                 # ...
                 EmbedlyCardExtension()]

用法

例如，要在 ReStructuredText 中嵌入 YouTube 视频：

.. embedly-card:: https://www.youtube.com/watch?v=ZlfIVEy_YOA

或降价：

[!embedlycard](https://www.youtube.com/watch?v=ZlfIVEy_YOA)

或者在 ReStructuredText 中嵌入文章/网页：

.. embedly-card:: http://physics.stackexchange.com/questions/5265/cooling-a-cup-of-coffee-with-help-of-a-spoon

或降价：

[!embedlycard](http://physics.stackexchange.com/questions/5265/cooling-a-cup-of-coffee-with-help-of-a-spoon)

选项

card-chrome ( ReST ) 或chrome (markdown) 选项（如果提供）指定是否保留卡片周围的边框。默认情况下，如果 Embed.ly 支持，边框会自动移除；但是要强制保留边界，您可以通过:card-chrome: 1 (ReST),

.. embedly-card:: https://www.youtube.com/watch?v=ZlfIVEy_YOA
    :card-chrome: 1

或chrome=1（降价）：

[!embedlycard?chrome=1](https://www.youtube.com/watch?v=ZlfIVEy_YOA)