A tutorial on embedding a twitter stream to a Jekyll project.

twitterJekyllEmbed.md

Embedding a twitter stream in Jekyll

1. Create a _plugins folder in your root.
2. Add the following to _config.yml

plugins:
  - jekyll-gist

3. If you don't have a Gemfile associated with your Jekyll project, create one with the following text

source 'https://rubygems.org'
group :jekyll_plugins do
    gem 'github-pages'
end

4. Add the following to your Gemfile:

gem 'jekyll-twitter-plugin'

5. Now you're ready to add the following tags in your html. (Check out more attributes from the Twitter API)

<div class='jekyll-twitter-plugin' align="center">
    {% twitter https://twitter.com/anaik96 maxwidth=500 limit=5 %}
</div>

6. The job isn't done yet. The feed will show on your localhost, but not Gihub Pages, which will block all plugins because of safety reasons... -_-
   No problemo, just copy the generated content from _sites folder and replace the html of step 5! :)

Sources

1. Github - jekyll-twitter-plugin
2. Setting up your GitHub Pages site locally with Jekyll
3. Documentation - Jekyll Plugins

Anyone ending up here but not getting it to run (for me it was because of version conflicts of different gems): You can also embed a tweet directly as a html blockquote. Just put this in your post:

<blockquote class="twitter-tweet" data-lang="en"><p lang="en" dir="ltr">halfin (@halfin) <a href="https://twitter.com/halfin/status/1110302988">https://twitter.com/halfin/status/1110302988</a></p>&mdash; halfin (@halfin) <a href="https://twitter.com/halfin/status/1110302988"></a></blockquote>
<script async="" src="//platform.twitter.com/widgets.js" charset="utf-8"></script>

I explained it step by step on how to embed tweets in GitHub Pages