在鹈鹕文章中轻松显示Flickr图像。
pelican-flickrtag的Python项目详细描述
鹈鹕flickr标签是一个库,可以方便地在您的Pelican博客中显示flickr图像。
安装
要安装插件,只需:
$ pip install pelican-flickrtag
然后在您的博客配置中添加一些代码:
PLUGINS=[# ...'pelican_flickrtag',# ...]
用法
在您的文章中,只需在您的文章中添加如下行:
[flickr:id=5128831453]
这将告诉插件将id为8152886277的图像插入到您的文章中。默认情况下,生成的HTML将如下所示:
<pclass="caption-container"><aclass="caption"href="http://www.flickr.com/photos/chrisstreeter/5128831453/"target="_blank"><imgsrc="http://farm5.static.flickr.com/4037/5128831453_792359af82_z.jpg"alt="Sand Dunes"title="Sand Dunes"class="img-polaroid"/></a><spanclass="caption-text muted">Sand Dunes</span></p>
如果需要自定义标题,可以使用:
[flickr:id=5128831453,title=Sand dunes at Inyo, California]
如果要更改输出的外观,可以创建自己的jinja模板并将其粘贴到主题目录中。然后重写FLICKR_TAG_TEMPLATE_NAME设置以指向模板。更多信息见下文。
设置
FLICKR_TAG_TEMPLATE_NAME-指定用于呈现每个替换标记的模板的名称。这使用鹈鹕的模板查找来查找模板的名称。如果模板名为flickrtag.html,则此设置应设置为flickrtag。(可选)默认模板如下:
<pclass="caption-container"><aclass="caption"href="{{url}}"target="_blank"><imgsrc="{{raw_url}}"alt="{{title}}"title="{{title}}"class="img-polaroid"{%ifFLICKR_TAG_INCLUDE_DIMENSIONS%}width="{{width}}"height="{{height}}"{%endif%}/></a><spanclass="caption-text muted">{{title}}</span></p>
FLICKR_TAG_CACHE_LOCATION-存储查找到的照片信息的缓存位置。这大大加快了网站的建设速度,并允许您离线进行。默认为/tmp/com.chrisstreeter.flickrtag images.cache(可选)
FLICKR_TAG_INCLUDE_DIMENSIONS-是否在模板生成的图像标记上包含维度。默认值是False。(可选)
FLICKR_TAG_IMAGE_SIZE-如果FLICKR_TAG_INCLUDE_DIMENSIONS设置为True,则使用的大小别名。默认值为“中640”。有关有效值,请参见Flickr getSizes documentation。(可选)
Flickr设置
需要以下两个设置。为了设置它们,您需要设置flickr api密钥。你可以通过creating an app on Flickr来完成。如果博客是个人博客,请申请非商业密钥。一旦你得到了你的密钥和秘密,就把它们添加到你的Pelican configuration。
FLICKR_API_KEY-应用程序访问Flickr API的API密钥。(必需)
FLICKR_API_SECRET-应用程序访问Flickr API的API机密。(必需)
Flickr代币
仅当您要访问帐户专用的照片,并且无法通过公共API获取这些照片时,才需要Flickr API令牌。我假设您知道自己在做什么,以及如何获取此设置的flickr api令牌。
FLICKR_API_TOKEN-访问flickr api的api令牌。(可选)
注释
使用来自flickrpy的部分代码。
许可证
使用MIT许可证。