[How I organize posts in Jekyll (code snippets for blog post - see comments)] #tags: tool

category_plugin.rb

module Jekyll

  Page.class_eval {
  
    def clone
      Page.new(@site, @base, @dir, @name)
    end

  }

  class CategoryPageGenerator < Generator
    safe true
    priority :high

    def generate(site)
      main_cat_page = site.pages.select { |p| p.name == "category.html" }.first

      site.categories.each do |cat|
        cat_page = main_cat_page.clone
        cat_name = cat.first.gsub(/\s+/, '-')

        cat_page.data.merge!(
          "title" => "somic.org category: #{cat_name}",
          "permalink" => "/category/#{cat_name}/",
          "category_name" => cat_name)
        cat_page.render(site.layouts, site.site_payload)

        site.pages << cat_page
      end

    end

  end
end

related_plugin.rb

module Jekyll
  class RelatedGenerator < Generator

    safe true
    priority :high

    N = 8

    def generate(site)
      site.posts.map! do |post|
        related = [ ]
        unless post.categories.empty?
          related += site.categories.map { |k,v|
            v if post.categories.include?(k) }.flatten.uniq.reject { |x|
            x.nil? || x.url == post.url }.sort.reverse.first(N)
        end
        post.data['related'] = related

        post
      end
    end

  end
end

sorted_categories_plugin.rb

module Jekyll
  class SortedCategoriesBuilder < Generator
  
    safe true
    priority :high

    def generate(site)
      site.config['sorted_categories'] = site.categories.map { |cat, posts|
        [ cat, posts.size, posts ] }.sort { |a,b| b[1] <=> a[1] }
    end

  end
end

using_sorted_categories

{% for category in site.sorted_categories %}
here is a category name - {{ category | first }}
here is the number of posts in this category - {{ category | last | size }}
{% for post in category.last %}
posts in this category - {{ post.url }} {{ post.date | date_to_string }}
{% endfor %}
{% endfor %}