jekyll_social_icons

Jekyll Social Icons

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

1. Installation

• Add the following to your site's Gemfile:

gem 'jekyll_social_icons'

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

gems:
  - jekyll_social_icons

• 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:

Option	Description	Default
id	One or more ids separated by a space. This ids are going to be added at the same level than the main social-container class.	-
class	One or more classes separated by a space. This classes are going to be added to the main social-container class.	-
width	The width of the social networks icons.	50px
height	The height of the social networks icons.	50px
align	One of left, center or right.	center
margin	The margin between the different social icons you want to render.	10px
radius	The border radius of the social icons. Put 100% if you want circle icons.	0
size	The size of the social networks brand image.	30px

3. Contributing

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

4. License

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