README.md

Liquid Tweet Tag for Jekyll and Octopress

This is a simple Liquid tag that makes it easy to embed tweets. This is great for quoting a tweet in a blog post,
for example. It uses Twitter's oEmbed API for their Embedded Tweet
feature. Features include:

The first argument to the tweet tag must be the tweet URL, but everything after that is optional. You can pass
any parameter supported by the Twitter oEmbed API in the form
key='value'.

In an attempt to maintain compatibility with Robert Böhnke's Embed.ly Tag,
the tweet tag wraps the embedded code with a <div class='embed tweet'>.

Caching

The Twitter oEmbed API is rate-limited. The tweet tag caches all API responses in a directory named .tweet-cache.
This way, regenerating your site does not re-query for every embedded tweet every time. You can safely delete the
.tweet-cache directory. It will be recreated and embedded tweets will be re-queried.

You can also use the tweetnocache tag to embed a tweet that bypasses the cache. This is not recommended since
it will request the embed code from twitter every time that page is regenerated.