Ruby
Switch branches/tags
Nothing to show
Latest commit 77ad23c Nov 10, 2015 @j0k3r j0k3r Add ENV variables configuration in README
Fix #9 (related to #6), thanks @gep13
Permalink
Failed to load latest commit information.
_plugins Fix some img attributes May 13, 2015
README.md Add ENV variables configuration in README Nov 10, 2015
_config.yml Initial commit (the real one) Feb 24, 2013

README.md

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 :