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

  1. 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>

  2. 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]

  3. 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)

  4. rake generate && rake preview