使用embed.ly卡嵌入外部内容的鹈鹕插件
embedly_cards的Python项目详细描述
嵌入式卡
嵌入式卡是一个Pelican插件,它提供restructuredtext指令来允许 使用Embed.ly Cards轻松嵌入外部内容。
功能
只需指定 目标页。内容自动识别、提取和格式化为 一张“卡片”;这可能包含一篇短文预览、嵌入式视频、图片等。
要预览卡片,可以使用Embed.ly在线生成。 几乎所有网站都兼容,包括YouTube、Flickr、Google+、Maps、WordPress等。
安装
可使用pip
安装嵌入式卡$ pip install embedly-cards
或者从源代码中手动执行
$ python setup.py install
安装后,只需将其添加到pelicanconf.py配置文件:
PLUGINS=[# ...'embedly_cards']
如果您计划在标记.md文件中嵌入内容, 您还必须将其添加到MD_EXTENSIONS选项中,例如:
fromembedly_cardsimportEmbedlyCardExtensionMD_EXTENSIONS=['codehilite(css_class=highlight)','extra',# ...EmbedlyCardExtension()]
重要
如果是第一次创建MD_EXTENSIONS变量, 确保鹈鹕'codehilite(css_class=highlight)' 列表中包括'extra'降价扩展。
用法
例如,将youtube视频嵌入structuredtext:
..embedly-card:: https://www.youtube.com/watch?v=ZlfIVEy_YOA
或降价:
[!embedlycard](https://www.youtube.com/watch?v=ZlfIVEy_YOA)
或者在structuredtext中嵌入文章/网页:
..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)