轻松在您的Pelican文章中显示Flickr图片。
项目描述
Pelican Flickr Tag是一个库,可以轻松地在您的Pelican博客中显示Flickr图片。
安装
要安装插件,只需
$ pip install pelican-flickrtag
然后在您的博客配置中添加一些代码
PLUGINS = [
# ...
'pelican_flickrtag',
# ...
]
用法
在您的文章中,只需添加类似以下行到您的帖子中
[flickr:id=5128831453]
这将告诉插件将ID为8152886277的图片插入到您的帖子中。默认情况下,生成的HTML将类似于
<p class="caption-container">
<a class="caption" href="http://www.flickr.com/photos/chrisstreeter/5128831453/" target="_blank">
<img src="http://farm5.static.flickr.com/4037/5128831453_792359af82_z.jpg" alt="Sand Dunes" title="Sand Dunes" class="img-polaroid" />
</a>
<span class="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 - 指定用于渲染每个替换标签的模板名称。此设置使用Pelican的模板查找来查找模板名称。如果模板名为flickrtag.html,则此设置应设置为flickrtag。(可选)默认模板如下
<p class="caption-container">
<a class="caption" href="{{url}}" target="_blank">
<img src="{{raw_url}}"
alt="{{title}}"
title="{{title}}"
class="img-polaroid"
{% if FLICKR_TAG_INCLUDE_DIMENSIONS %}
width="{{width}}"
height="{{height}}"
{% endif %} />
</a>
<span class="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,则使用的尺寸别名。默认为‘Medium 640’。请参考Flickr getSizes 文档获取有效值。(可选)
Flickr 设置
以下两个设置是必需的。要设置它们,您需要设置一个Flickr API密钥。您可以通过在Flickr上创建应用程序来做到这一点。如果博客是个人博客,则申请非商业密钥。一旦您获得了您的密钥和密钥,请将它们添加到您的Pelican配置中。
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许可证。
项目详情
下载文件
下载您平台上的文件。如果您不确定选择哪一个,请了解更多关于安装包的信息。