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