Aside

Example of this is the ‘categories’ list on the right hand side of the blog page. It’s always pinned on RHS, regardless of page content.

Instruction

Add to source/_includes/asides/category_list.html with the following content. (remember to delete [delete-this-tag])

<section class="well">
  <h1>Categories</h1>
  <ul id="categories" class="nav nav-list">
    {[delete-this-tag]% category_list %[delete-this-tag]}
  </ul>
</section>

Go to _config.yml and modify default_asides.

default_asides: [asides/category_list.html, asides/recent_posts.html, asides/github.html, asides/delicious.html, asides/pinboard.html, asides/googleplus.html, asides/advertise.html]

Since the ‘category_list’ tag is not natively supported. Add plugins/category_list_tag.rb with the followin content.

module Jekyll
  class CategoryListTag < Liquid::Tag
    def render(context)
      html = ""
      categories = context.registers[:site].categories.keys
      categories.sort.each do |category|
        posts_in_category = context.registers[:site].categories[category].size
        category_dir = context.registers[:site].config['category_dir']
        category_url = File.join(category_dir, category.gsub(/_|\P{Word}/, '-').gsub(/-{2,}/, '-').downcase)
        html << "<li class='category'><a href='/#{category_url}/'>#{category} (#{posts_in_category})</a></li>\n"
      end
      html
    end
  end
end

Liquid::Template.register_tag('category_list', Jekyll::CategoryListTag)

rake generate && rake preview