jekyll-flickr-photoset

It's a Jekyll plugin for embedding Flickr photosets in your Liquid templates.

I was moving from Posterous to Jekyll and I was looking for a slideshow gallery like Posterous had. You put a simple tag with a Flickr photoset ID inside your post and it builds a slideshow gallery. So I made it: one tag generates a gallery, no more. Dead simple.

Here is an example of this integration: http://blog.wildtrip.net

Usage

{% flickr_photoset 12345678901234567 %}
{% flickr_photoset 12345678901234567 "Square" "Medium 640" "Large" "Site MP4" %}

Where:

• 12345678901234567 is the Flickr photoset ID (can be found in this kind of url: http://www.flickr.com/photos/j0k/sets/72157624158475427/)
• "Square" is the size for the thumbnail image (which also the one by default)
• "Medium 640" is the size for the displayed image (which also the one by default)
• "Large" is the size for the opened image (which also the one by default)
• "Site MP4" is the format for the video in case photoset include a video (which also the one by default)

Other Flickr size can be found here.

Requirements

FlickRaw

Flickraw is a library to access flickr API in a simple way.

gem install flickraw

A Flickr API key

You can obtain a Flickr API key here. And follow instructions on the FlickRaw page for authentication:

• create a flickr.rb file with content of "Authentication" bloc code
• replace api_key & shared_secret by the one previously generated on the Flickr website
• launch it with ruby -rubygems flickr.rb
• follow instructions

Then put them inside _config.yml (where flickr: is defined on the root level):

flickr:
  cache_dir:       "./_cache/flickr"
  api_key:          xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
  shared_secret:    xxxxxxxxxxxxxxxx
  access_token:     xxxxxxxxxxxxxxxx-xxxxxxxxxxxxxxxx
  access_secret:    xxxxxxxxxxxxxxxx

Or define them in ENV variables:

• FLICKR_API_KEY
• FLICKR_SHARED_SECRET
• FLICKR_ACCESS_TOKEN
• FLICKR_ACCESS_SECRET

There is also an ability to generate cache. It will put all images references from each photoset. It will save a lot of time when you will have to regenerate all your posts. Cache are written in a yml file. Photoset ID is the file name.

Rendering

Foundation Clearing

The master branch use Clearing, from Foundation, to display a kind of gallery. It handles a list of images, and a fullscreen slideshow.

AD Gallery

This is the plugin used to generate the slideshow gallery, which is almost the same from Posterous. You will find references in adgallery folder, I put the latest version (1.2.7).

If you want to use it, switch to the ad-gallery branch. I didn't test it under Jekyll 1.0+.

Inspiration

I've looked inside :

• jekyll-flickr
• Integrating Flickr and Jekyll