Jekyll Social Icons

Jekyll Social Icons plugin allows you rendering your social networks on your Jekyll project.

1. Installation

1. Add the following to your site's Gemfile:

gem 'jekyll_social_icons'

2. Add the following to your site's _config.yml:

gems:
  - jekyll_social_icons

3. Run bundle install in your command line:

$ bundle install

2. Usage

2.1. Configuration

Add your social networks URLs to the _config.yml file:

socials:
  twitter: https://twitter.com/unabris
  github: https://github.com/unabris

Here is a full list of all the available social networks: facebook, twitter, google-plus, instagram, linkedin, youtube, github and rss.

2.2. Rendering

Use {% social_icons %} Jekyll Tag to render all your configured social networks with the default styling. For example, the configuration above will render this html content:

<div class="social-container" id="" style="">
  <div class="social" style="">
    <a href="https://twitter.com/unabris" target="_blank">
      <i class="fa fa-fw fa-twitter" style=""></i>
    </a>
  </div>
  <div class="social" style="">
    <a href="https://github.com/unabris" target="_blank">
      <i class="fa fa-fw fa-github" style=""></i>
    </a>
  </div>
</div>

You can also specify the social networks you want to render adding them to the Jekyll Tag this way:

{% social_icons twitter github %}

2.3. Styling

There are so many attributes you can use to customize the style of your social networks icons. To use them, just add the attribute and the value you want to the social_icons Jekyll Tag this way:

{% social_icons twitter github id="footer-icons" width="30px" height="30px" radius="100%" %}

Here is a full list of all the available attributes with their default values:

3. Contributing

1. Fork it
2. Create your feature branch (git checkout -b my-new-feature)
3. Commit your changes (git commit -am 'Add some feature')
4. Push to the branch (git push origin my-new-feature)
5. Create a new Pull Request

4. License

The gem is available as open source under the terms of the MIT License.