kidsil/generate_categories.rb

## generate_categories.rb
# encoding: utf-8
#
# Jekyll category page generator.
# http://recursive-design.com/projects/jekyll-plugins/
#
# Version: 0.2.4 (201210160037)
#
# Copyright (c) 2010 Dave Perrett, http://recursive-design.com/
# Licensed under the MIT license (http://www.opensource.org/licenses/mit-license.php)
#
# A generator that creates category pages for jekyll sites.
#
# To use it, simply drop this script into the _plugins directory of your Jekyll site. You should
# also create a file called 'category_index.html' in the _layouts directory of your jekyll site
# with the following contents (note: you should remove the leading '# ' characters):
#
# ================================== COPY BELOW THIS LINE ==================================
# ---
# layout: default
# ---
#
# <h1 class="category">{{ page.title }}</h1>
# <ul class="posts">
# {% for post in site.categories[page.category] %}
#     <div>{{ post.date | date_to_html_string }}</div>
#     <h2><a href="{{ post.url }}">{{ post.title }}</a></h2>
#     <div class="categories">Filed under {{ post.categories | category_links }}</div>
# {% endfor %}
# </ul>
# ================================== COPY ABOVE THIS LINE ==================================
#
# You can alter the _layout_ setting if you wish to use an alternate layout, and obviously you
# can change the HTML above as you see fit.
#
# When you compile your jekyll site, this plugin will loop through the list of categories in your
# site, and use the layout above to generate a page for each one with a list of links to the
# individual posts.
#
# You can also (optionally) generate an atom.xml feed for each category. To do this, copy
# the category_feed.xml file to the _includes/custom directory of your own project
# (https://github.com/recurser/jekyll-plugins/blob/master/_includes/custom/category_feed.xml).
# You'll also need to copy the octopress_filters.rb file into the _plugins directory of your
# project as the category_feed.xml requires a couple of extra filters
# (https://github.com/recurser/jekyll-plugins/blob/master/_plugins/octopress_filters.rb).
#
# Included filters :
# - category_links:      Outputs the list of categories as comma-separated <a> links.
# - date_to_html_string: Outputs the post.date as formatted html, with hooks for CSS styling.
#
# Available _config.yml settings :
# - category_dir:          The subfolder to build category pages in (default is 'categories').
# - category_title_prefix: The string used before the category name in the page title (default is
#                          'Category: ').
module Jekyll

  # The CategoryIndex class creates a single category page for the specified category.
  class CategoryPage < Page

    # Initializes a new CategoryIndex.
    #
    #  +template_path+ is the path to the layout template to use.
    #  +site+          is the Jekyll Site instance.
    #  +base+          is the String path to the <source>.
    #  +category_dir+  is the String path between <source> and the category folder.
    #  +category+      is the category currently being processed.
    def initialize(template_path, name, site, base, category_dir, category)
      @site  = site
      @base  = base
      @dir   = category_dir
      @name  = name

      self.process(name)

      if File.exist?(template_path)
        @perform_render = true
        template_dir    = File.dirname(template_path)
        template        = File.basename(template_path)
        # Read the YAML data from the layout page.
        self.read_yaml(template_dir, template)
        self.data['category']    = category
        # Set the title for this page.
        title_prefix             = site.config['category_title_prefix'] || 'Category: '
        self.data['title']       = "#{title_prefix}#{category}"
        # Set the meta-description for this page.
        meta_description_prefix  = site.config['category_meta_description_prefix'] || 'Category: '
        self.data['description'] = "#{meta_description_prefix}#{category}"
      else
        @perform_render = false
      end
    end

    def render?
      @perform_render
    end

  end

  # The CategoryIndex class creates a single category page for the specified category.
  class CategoryIndex < CategoryPage

    # Initializes a new CategoryIndex.
    #
    #  +site+         is the Jekyll Site instance.
    #  +base+         is the String path to the <source>.
    #  +category_dir+ is the String path between <source> and the category folder.
    #  +category+     is the category currently being processed.
    def initialize(site, base, category_dir, category)
      template_path = File.join(base, '_layouts', 'category_index.html')
      super(template_path, 'index.html', site, base, category_dir, category)
    end

  end

  # The CategoryFeed class creates an Atom feed for the specified category.
  class CategoryFeed < CategoryPage

    # Initializes a new CategoryFeed.
    #
    #  +site+         is the Jekyll Site instance.
    #  +base+         is the String path to the <source>.
    #  +category_dir+ is the String path between <source> and the category folder.
    #  +category+     is the category currently being processed.
    def initialize(site, base, category_dir, category)
      template_path = File.join(base, '_includes', 'custom', 'category_feed.xml')
      super(template_path, 'atom.xml', site, base, category_dir, category)

      # Set the correct feed URL.
      self.data['feed_url'] = "#{category_dir}/#{name}" if render?
    end

  end

  # The Site class is a built-in Jekyll class with access to global site config information.
  class Site

    # Creates an instance of CategoryIndex for each category page, renders it, and
    # writes the output to a file.
    #
    #  +category+ is the category currently being processed.
    def write_category_index(category)
      target_dir = GenerateCategories.category_dir(self.config['category_dir'], category)
      index      = CategoryIndex.new(self, self.source, target_dir, category)
      if index.render?
        index.render(self.layouts, site_payload)
        index.write(self.dest)
        # Record the fact that this pages has been added, otherwise Site::cleanup will remove it.
        self.pages << index
      end

      # Create an Atom-feed for each index.
      feed = CategoryFeed.new(self, self.source, target_dir, category)
      if feed.render?
        feed.render(self.layouts, site_payload)
        feed.write(self.dest)
        # Record the fact that this pages has been added, otherwise Site::cleanup will remove it.
        self.pages << feed
      end
    end

    # Loops through the list of category pages and processes each one.
    def write_category_indexes
      if self.layouts.key? 'category_index'
        self.categories.keys.each do |category|
          self.write_category_index(category)
        end

      # Throw an exception if the layout couldn't be found.
      else
        throw "No 'category_index' layout found."
      end
    end

  end


  # Jekyll hook - the generate method is called by jekyll, and generates all of the category pages.
  class GenerateCategories < Generator
    safe true
    priority :low

    CATEGORY_DIR = 'categories'

    def generate(site)
      site.write_category_indexes
    end

    # Processes the given dir and removes leading and trailing slashes. Falls
    # back on the default if no dir is provided.
    def self.category_dir(base_dir, category)
      base_dir = (base_dir || CATEGORY_DIR).gsub(/^\/*(.*)\/*$/, '\1')
      category = category.gsub(/_|\P{Word}/, '-').gsub(/-{2,}/, '-').downcase
      File.join(base_dir, category)
    end

  end


  # Adds some extra filters used during the category creation process.
  module Filters

    # Outputs a list of categories as comma-separated <a> links. This is used
    # to output the category list for each post on a category page.
    #
    #  +categories+ is the list of categories to format.
    #
    # Returns string
    def category_links(categories)
      base_dir = @context.registers[:site].config['category_dir']
      categories = categories.sort!.map do |category|
        category_dir = GenerateCategories.category_dir(base_dir, category)
        # Make sure the category directory begins with a slash.
        category_dir = "/#{category_dir}" unless category_dir =~ /^\//
        "<a class='category' href='#{category_dir}/'>#{category}</a>"
      end

      case categories.length
      when 0
        ""
      when 1
        categories[0].to_s
      else
        categories.join(', ')
      end
    end

    # Outputs the post.date as formatted html, with hooks for CSS styling.
    #
    #  +date+ is the date object to format as HTML.
    #
    # Returns string
    def date_to_html_string(date)
      result = '<span class="month">' + date.strftime('%b').upcase + '</span> '
      result += date.strftime('<span class="day">%d</span> ')
      result += date.strftime('<span class="year">%Y</span> ')
      result
    end

  end

end

## generate_tags.rb
# encoding: utf-8
#
# Jekyll tag page generator.
# http://recursive-design.com/projects/jekyll-plugins/
#
# Version: 0.2.4 (201210160037)
#
# Copyright (c) 2010 Dave Perrett, http://recursive-design.com/
# Licensed under the MIT license (http://www.opensource.org/licenses/mit-license.php)
#
# A generator that creates tag pages for jekyll sites.
#
# To use it, simply drop this script into the _plugins directory of your Jekyll site. You should
# also create a file called 'tag_index.html' in the _layouts directory of your jekyll site
# with the following contents (note: you should remove the leading '# ' characters):
#
# ================================== COPY BELOW THIS LINE ==================================
# ---
# layout: default
# ---
#
# <h1 class="tag">{{ page.title }}</h1>
# <ul class="posts">
# {% for post in site.tags[page.tag] %}
#     <div>{{ post.date | date_to_html_string }}</div>
#     <h2><a href="{{ post.url }}">{{ post.title }}</a></h2>
#     <div class="tags">Filed under {{ post.tags | tag_links }}</div>
# {% endfor %}
# </ul>
# ================================== COPY ABOVE THIS LINE ==================================
#
# You can alter the _layout_ setting if you wish to use an alternate layout, and obviously you
# can change the HTML above as you see fit.
#
# When you compile your jekyll site, this plugin will loop through the list of tags in your
# site, and use the layout above to generate a page for each one with a list of links to the
# individual posts.
#
# You can also (optionally) generate an atom.xml feed for each tag. To do this, copy
# the tag_feed.xml file to the _includes/custom directory of your own project
# (https://github.com/recurser/jekyll-plugins/blob/master/_includes/custom/tag_feed.xml).
# You'll also need to copy the octopress_filters.rb file into the _plugins directory of your
# project as the tag_feed.xml requires a couple of extra filters
# (https://github.com/recurser/jekyll-plugins/blob/master/_plugins/octopress_filters.rb).
#
# Included filters :
# - tag_links:      Outputs the list of tags as comma-separated <a> links.
# - date_to_html_string: Outputs the post.date as formatted html, with hooks for CSS styling.
#
# Available _config.yml settings :
# - tag_dir:          The subfolder to build tag pages in (default is 'tags').
# - tag_title_prefix: The string used before the tag name in the page title (default is
#                          'Tag: ').
module Jekyll

  # The TagIndex class creates a single tag page for the specified tag.
  class TagPage < Page

    # Initializes a new TagIndex.
    #
    #  +template_path+ is the path to the layout template to use.
    #  +site+          is the Jekyll Site instance.
    #  +base+          is the String path to the <source>.
    #  +tag_dir+  is the String path between <source> and the tag folder.
    #  +tag+      is the tag currently being processed.
    def initialize(template_path, name, site, base, tag_dir, tag)
      @site  = site
      @base  = base
      @dir   = tag_dir
      @name  = name

      self.process(name)

      if File.exist?(template_path)
        @perform_render = true
        template_dir    = File.dirname(template_path)
        template        = File.basename(template_path)
        # Read the YAML data from the layout page.
        self.read_yaml(template_dir, template)
        self.data['tag']    = tag
        # Set the title for this page.
        title_prefix             = site.config['tag_title_prefix'] || 'Tag: '
        self.data['title']       = "#{title_prefix}#{tag}"
        # Set the meta-description for this page.
        meta_description_prefix  = site.config['tag_meta_description_prefix'] || 'Tag: '
        self.data['description'] = "#{meta_description_prefix}#{tag}"
      else
        @perform_render = false
      end
    end

    def render?
      @perform_render
    end

  end

  # The TagIndex class creates a single tag page for the specified tag.
  class TagIndex < TagPage

    # Initializes a new TagIndex.
    #
    #  +site+         is the Jekyll Site instance.
    #  +base+         is the String path to the <source>.
    #  +tag_dir+ is the String path between <source> and the tag folder.
    #  +tag+     is the tag currently being processed.
    def initialize(site, base, tag_dir, tag)
      template_path = File.join(base, '_layouts', 'tag_index.html')
      super(template_path, 'index.html', site, base, tag_dir, tag)
    end

  end

  # The TagFeed class creates an Atom feed for the specified tag.
  class TagFeed < TagPage

    # Initializes a new TagFeed.
    #
    #  +site+         is the Jekyll Site instance.
    #  +base+         is the String path to the <source>.
    #  +tag_dir+ is the String path between <source> and the tag folder.
    #  +tag+     is the tag currently being processed.
    def initialize(site, base, tag_dir, tag)
      template_path = File.join(base, '_includes', 'custom', 'tag_feed.xml')
      super(template_path, 'atom.xml', site, base, tag_dir, tag)

      # Set the correct feed URL.
      self.data['feed_url'] = "#{tag_dir}/#{name}" if render?
    end

  end

  # The Site class is a built-in Jekyll class with access to global site config information.
  class Site

    # Creates an instance of TagIndex for each tag page, renders it, and
    # writes the output to a file.
    #
    #  +tag+ is the tag currently being processed.
    def write_tag_index(tag)
      target_dir = GenerateTags.tag_dir(self.config['tag_dir'], tag)
      index      = TagIndex.new(self, self.source, target_dir, tag)
      if index.render?
        index.render(self.layouts, site_payload)
        index.write(self.dest)
        # Record the fact that this pages has been added, otherwise Site::cleanup will remove it.
        self.pages << index
      end

      # Create an Atom-feed for each index.
      feed = TagFeed.new(self, self.source, target_dir, tag)
      if feed.render?
        feed.render(self.layouts, site_payload)
        feed.write(self.dest)
        # Record the fact that this pages has been added, otherwise Site::cleanup will remove it.
        self.pages << feed
      end
    end

    # Loops through the list of tag pages and processes each one.
    def write_tag_indexes
      if self.layouts.key? 'tag_index'
        self.tags.keys.each do |tag|
          self.write_tag_index(tag)
        end

      # Throw an exception if the layout couldn't be found.
      else
        throw "No 'tag_index' layout found."
      end
    end

  end


  # Jekyll hook - the generate method is called by jekyll, and generates all of the tag pages.
  class GenerateTags < Generator
    safe true
    priority :low

    TAG_DIR = 'tag'

    def generate(site)
      site.write_tag_indexes
    end

    # Processes the given dir and removes leading and trailing slashes. Falls
    # back on the default if no dir is provided.
    def self.tag_dir(base_dir, tag)
      base_dir = (base_dir || TAG_DIR).gsub(/^\/*(.*)\/*$/, '\1')
      tag = tag.gsub(/_|\P{Word}/, '-').gsub(/-{2,}/, '-').downcase
      File.join(base_dir, tag)
    end

  end


  # Adds some extra filters used during the tag creation process.
  module Filters

    # Outputs a list of tags as comma-separated <a> links. This is used
    # to output the tag list for each post on a tag page.
    #
    #  +tags+ is the list of tags to format.
    #
    # Returns string
    def tag_links(tags)
      base_dir = @context.registers[:site].config['tag_dir']
      tags = tags.sort!.map do |tag|
        tag_dir = GenerateTags.tag_dir(base_dir, tag)
        # Make sure the tag directory begins with a slash.
        tag_dir = "/#{tag_dir}" unless tag_dir =~ /^\//
        "<a class='tag' href='#{tag_dir}/'>#{tag}</a>"
      end

      case tags.length
      when 0
        ""
      when 1
        tags[0].to_s
      else
        tags.join(', ')
      end
    end

    # Outputs the post.date as formatted html, with hooks for CSS styling.
    #
    #  +date+ is the date object to format as HTML.
    #
    # Returns string
    def date_to_html_string(date)
      result = '<span class="month">' + date.strftime('%b').upcase + '</span> '
      result += date.strftime('<span class="day">%d</span> ')
      result += date.strftime('<span class="year">%Y</span> ')
      result
    end

  end

end

## new_template.html
{% comment %}TODO put this in a separate include to save some trouble. Obviously there's some room for improvement here. {% endcomment %}
<div class="post-tags">Tagged with <span>
  {% for tag in post.tags %}
	<a class="tag" href="{{ "/tag/" | append: tag | downcase | replace: " ", "-" | uri_escape }}">{{ tag }}</a>{% if forloop.last %}{% else %}, {% endif %}
	{% endfor %}
</span></div>
<div class="post-category">Posted in <span>
	{% for category in post.categories %}
	<a class="category" href="{{ "/category/" | append: category | downcase | replace: " ", "-" | uri_escape }}">{{ category }}</a>{% if forloop.last %}{% else %}, {% endif %}
	{% endfor %}
</span></div>

## old_template.html
<!-- This used to work for Jekyll 2 -->
<div class="post-tags">Tagged with <span>{{ post.tags | tag_links }}</span></div>
<div class="post-category">Posted in <span>{{ post.categories | category_links }}</span></div>
	# encoding: utf-8
	#
	# Jekyll category page generator.
	# http://recursive-design.com/projects/jekyll-plugins/
	#
	# Version: 0.2.4 (201210160037)
	#
	# Copyright (c) 2010 Dave Perrett, http://recursive-design.com/
	# Licensed under the MIT license (http://www.opensource.org/licenses/mit-license.php)
	#
	# A generator that creates category pages for jekyll sites.
	#
	# To use it, simply drop this script into the _plugins directory of your Jekyll site. You should
	# also create a file called 'category_index.html' in the _layouts directory of your jekyll site
	# with the following contents (note: you should remove the leading '# ' characters):
	#
	# ================================== COPY BELOW THIS LINE ==================================
	# ---
	# layout: default
	# ---
	#
	# <h1 class="category">{{ page.title }}</h1>
	# <ul class="posts">
	# {% for post in site.categories[page.category] %}
	# <div>{{ post.date \| date_to_html_string }}</div>
	# <h2><a href="{{ post.url }}">{{ post.title }}</a></h2>
	# <div class="categories">Filed under {{ post.categories \| category_links }}</div>
	# {% endfor %}
	# </ul>
	# ================================== COPY ABOVE THIS LINE ==================================
	#
	# You can alter the _layout_ setting if you wish to use an alternate layout, and obviously you
	# can change the HTML above as you see fit.
	#
	# When you compile your jekyll site, this plugin will loop through the list of categories in your
	# site, and use the layout above to generate a page for each one with a list of links to the
	# individual posts.
	#
	# You can also (optionally) generate an atom.xml feed for each category. To do this, copy
	# the category_feed.xml file to the _includes/custom directory of your own project
	# (https://github.com/recurser/jekyll-plugins/blob/master/_includes/custom/category_feed.xml).
	# You'll also need to copy the octopress_filters.rb file into the _plugins directory of your
	# project as the category_feed.xml requires a couple of extra filters
	# (https://github.com/recurser/jekyll-plugins/blob/master/_plugins/octopress_filters.rb).
	#
	# Included filters :
	# - category_links: Outputs the list of categories as comma-separated <a> links.
	# - date_to_html_string: Outputs the post.date as formatted html, with hooks for CSS styling.
	#
	# Available _config.yml settings :
	# - category_dir: The subfolder to build category pages in (default is 'categories').
	# - category_title_prefix: The string used before the category name in the page title (default is
	# 'Category: ').
	module Jekyll

	# The CategoryIndex class creates a single category page for the specified category.
	class CategoryPage < Page

	# Initializes a new CategoryIndex.
	#
	# +template_path+ is the path to the layout template to use.
	# +site+ is the Jekyll Site instance.
	# +base+ is the String path to the <source>.
	# +category_dir+ is the String path between <source> and the category folder.
	# +category+ is the category currently being processed.
	def initialize(template_path, name, site, base, category_dir, category)
	@site = site
	@base = base
	@dir = category_dir
	@name = name

	self.process(name)

	if File.exist?(template_path)
	@perform_render = true
	template_dir = File.dirname(template_path)
	template = File.basename(template_path)
	# Read the YAML data from the layout page.
	self.read_yaml(template_dir, template)
	self.data['category'] = category
	# Set the title for this page.
	title_prefix = site.config['category_title_prefix'] \|\| 'Category: '
	self.data['title'] = "#{title_prefix}#{category}"
	# Set the meta-description for this page.
	meta_description_prefix = site.config['category_meta_description_prefix'] \|\| 'Category: '
	self.data['description'] = "#{meta_description_prefix}#{category}"
	else
	@perform_render = false
	end
	end

	def render?
	@perform_render
	end

	end

	# The CategoryIndex class creates a single category page for the specified category.
	class CategoryIndex < CategoryPage

	# Initializes a new CategoryIndex.
	#
	# +site+ is the Jekyll Site instance.
	# +base+ is the String path to the <source>.
	# +category_dir+ is the String path between <source> and the category folder.
	# +category+ is the category currently being processed.
	def initialize(site, base, category_dir, category)
	template_path = File.join(base, '_layouts', 'category_index.html')
	super(template_path, 'index.html', site, base, category_dir, category)
	end

	end

	# The CategoryFeed class creates an Atom feed for the specified category.
	class CategoryFeed < CategoryPage

	# Initializes a new CategoryFeed.
	#
	# +site+ is the Jekyll Site instance.
	# +base+ is the String path to the <source>.
	# +category_dir+ is the String path between <source> and the category folder.
	# +category+ is the category currently being processed.
	def initialize(site, base, category_dir, category)
	template_path = File.join(base, '_includes', 'custom', 'category_feed.xml')
	super(template_path, 'atom.xml', site, base, category_dir, category)

	# Set the correct feed URL.
	self.data['feed_url'] = "#{category_dir}/#{name}" if render?
	end

	end

	# The Site class is a built-in Jekyll class with access to global site config information.
	class Site

	# Creates an instance of CategoryIndex for each category page, renders it, and
	# writes the output to a file.
	#
	# +category+ is the category currently being processed.
	def write_category_index(category)
	target_dir = GenerateCategories.category_dir(self.config['category_dir'], category)
	index = CategoryIndex.new(self, self.source, target_dir, category)
	if index.render?
	index.render(self.layouts, site_payload)
	index.write(self.dest)
	# Record the fact that this pages has been added, otherwise Site::cleanup will remove it.
	self.pages << index
	end

	# Create an Atom-feed for each index.
	feed = CategoryFeed.new(self, self.source, target_dir, category)
	if feed.render?
	feed.render(self.layouts, site_payload)
	feed.write(self.dest)
	# Record the fact that this pages has been added, otherwise Site::cleanup will remove it.
	self.pages << feed
	end
	end

	# Loops through the list of category pages and processes each one.
	def write_category_indexes
	if self.layouts.key? 'category_index'
	self.categories.keys.each do \|category\|
	self.write_category_index(category)
	end

	# Throw an exception if the layout couldn't be found.
	else
	throw "No 'category_index' layout found."
	end
	end

	end


	# Jekyll hook - the generate method is called by jekyll, and generates all of the category pages.
	class GenerateCategories < Generator
	safe true
	priority :low

	CATEGORY_DIR = 'categories'

	def generate(site)
	site.write_category_indexes
	end

	# Processes the given dir and removes leading and trailing slashes. Falls
	# back on the default if no dir is provided.
	def self.category_dir(base_dir, category)
	base_dir = (base_dir \|\| CATEGORY_DIR).gsub(/^\/(.)\/*$/, '\1')
	category = category.gsub(/_\|\P{Word}/, '-').gsub(/-{2,}/, '-').downcase
	File.join(base_dir, category)
	end

	end


	# Adds some extra filters used during the category creation process.
	module Filters

	# Outputs a list of categories as comma-separated <a> links. This is used
	# to output the category list for each post on a category page.
	#
	# +categories+ is the list of categories to format.
	#
	# Returns string
	def category_links(categories)
	base_dir = @context.registers[:site].config['category_dir']
	categories = categories.sort!.map do \|category\|
	category_dir = GenerateCategories.category_dir(base_dir, category)
	# Make sure the category directory begins with a slash.
	category_dir = "/#{category_dir}" unless category_dir =~ /^\//
	"<a class='category' href='#{category_dir}/'>#{category}</a>"
	end

	case categories.length
	when 0
	""
	when 1
	categories[0].to_s
	else
	categories.join(', ')
	end
	end

	# Outputs the post.date as formatted html, with hooks for CSS styling.
	#
	# +date+ is the date object to format as HTML.
	#
	# Returns string
	def date_to_html_string(date)
	result = '<span class="month">' + date.strftime('%b').upcase + '</span> '
	result += date.strftime('<span class="day">%d</span> ')
	result += date.strftime('<span class="year">%Y</span> ')
	result
	end

	end

	end
	# encoding: utf-8
	#
	# Jekyll tag page generator.
	# http://recursive-design.com/projects/jekyll-plugins/
	#
	# Version: 0.2.4 (201210160037)
	#
	# Copyright (c) 2010 Dave Perrett, http://recursive-design.com/
	# Licensed under the MIT license (http://www.opensource.org/licenses/mit-license.php)
	#
	# A generator that creates tag pages for jekyll sites.
	#
	# To use it, simply drop this script into the _plugins directory of your Jekyll site. You should
	# also create a file called 'tag_index.html' in the _layouts directory of your jekyll site
	# with the following contents (note: you should remove the leading '# ' characters):
	#
	# ================================== COPY BELOW THIS LINE ==================================
	# ---
	# layout: default
	# ---
	#
	# <h1 class="tag">{{ page.title }}</h1>
	# <ul class="posts">
	# {% for post in site.tags[page.tag] %}
	# <div>{{ post.date \| date_to_html_string }}</div>
	# <h2><a href="{{ post.url }}">{{ post.title }}</a></h2>
	# <div class="tags">Filed under {{ post.tags \| tag_links }}</div>
	# {% endfor %}
	# </ul>
	# ================================== COPY ABOVE THIS LINE ==================================
	#
	# You can alter the _layout_ setting if you wish to use an alternate layout, and obviously you
	# can change the HTML above as you see fit.
	#
	# When you compile your jekyll site, this plugin will loop through the list of tags in your
	# site, and use the layout above to generate a page for each one with a list of links to the
	# individual posts.
	#
	# You can also (optionally) generate an atom.xml feed for each tag. To do this, copy
	# the tag_feed.xml file to the _includes/custom directory of your own project
	# (https://github.com/recurser/jekyll-plugins/blob/master/_includes/custom/tag_feed.xml).
	# You'll also need to copy the octopress_filters.rb file into the _plugins directory of your
	# project as the tag_feed.xml requires a couple of extra filters
	# (https://github.com/recurser/jekyll-plugins/blob/master/_plugins/octopress_filters.rb).
	#
	# Included filters :
	# - tag_links: Outputs the list of tags as comma-separated <a> links.
	# - date_to_html_string: Outputs the post.date as formatted html, with hooks for CSS styling.
	#
	# Available _config.yml settings :
	# - tag_dir: The subfolder to build tag pages in (default is 'tags').
	# - tag_title_prefix: The string used before the tag name in the page title (default is
	# 'Tag: ').
	module Jekyll

	# The TagIndex class creates a single tag page for the specified tag.
	class TagPage < Page

	# Initializes a new TagIndex.
	#
	# +template_path+ is the path to the layout template to use.
	# +site+ is the Jekyll Site instance.
	# +base+ is the String path to the <source>.
	# +tag_dir+ is the String path between <source> and the tag folder.
	# +tag+ is the tag currently being processed.
	def initialize(template_path, name, site, base, tag_dir, tag)
	@site = site
	@base = base
	@dir = tag_dir
	@name = name

	self.process(name)

	if File.exist?(template_path)
	@perform_render = true
	template_dir = File.dirname(template_path)
	template = File.basename(template_path)
	# Read the YAML data from the layout page.
	self.read_yaml(template_dir, template)
	self.data['tag'] = tag
	# Set the title for this page.
	title_prefix = site.config['tag_title_prefix'] \|\| 'Tag: '
	self.data['title'] = "#{title_prefix}#{tag}"
	# Set the meta-description for this page.
	meta_description_prefix = site.config['tag_meta_description_prefix'] \|\| 'Tag: '
	self.data['description'] = "#{meta_description_prefix}#{tag}"
	else
	@perform_render = false
	end
	end

	def render?
	@perform_render
	end

	end

	# The TagIndex class creates a single tag page for the specified tag.
	class TagIndex < TagPage

	# Initializes a new TagIndex.
	#
	# +site+ is the Jekyll Site instance.
	# +base+ is the String path to the <source>.
	# +tag_dir+ is the String path between <source> and the tag folder.
	# +tag+ is the tag currently being processed.
	def initialize(site, base, tag_dir, tag)
	template_path = File.join(base, '_layouts', 'tag_index.html')
	super(template_path, 'index.html', site, base, tag_dir, tag)
	end

	end

	# The TagFeed class creates an Atom feed for the specified tag.
	class TagFeed < TagPage

	# Initializes a new TagFeed.
	#
	# +site+ is the Jekyll Site instance.
	# +base+ is the String path to the <source>.
	# +tag_dir+ is the String path between <source> and the tag folder.
	# +tag+ is the tag currently being processed.
	def initialize(site, base, tag_dir, tag)
	template_path = File.join(base, '_includes', 'custom', 'tag_feed.xml')
	super(template_path, 'atom.xml', site, base, tag_dir, tag)

	# Set the correct feed URL.
	self.data['feed_url'] = "#{tag_dir}/#{name}" if render?
	end

	end

	# The Site class is a built-in Jekyll class with access to global site config information.
	class Site

	# Creates an instance of TagIndex for each tag page, renders it, and
	# writes the output to a file.
	#
	# +tag+ is the tag currently being processed.
	def write_tag_index(tag)
	target_dir = GenerateTags.tag_dir(self.config['tag_dir'], tag)
	index = TagIndex.new(self, self.source, target_dir, tag)
	if index.render?
	index.render(self.layouts, site_payload)
	index.write(self.dest)
	# Record the fact that this pages has been added, otherwise Site::cleanup will remove it.
	self.pages << index
	end

	# Create an Atom-feed for each index.
	feed = TagFeed.new(self, self.source, target_dir, tag)
	if feed.render?
	feed.render(self.layouts, site_payload)
	feed.write(self.dest)
	# Record the fact that this pages has been added, otherwise Site::cleanup will remove it.
	self.pages << feed
	end
	end

	# Loops through the list of tag pages and processes each one.
	def write_tag_indexes
	if self.layouts.key? 'tag_index'
	self.tags.keys.each do \|tag\|
	self.write_tag_index(tag)
	end

	# Throw an exception if the layout couldn't be found.
	else
	throw "No 'tag_index' layout found."
	end
	end

	end


	# Jekyll hook - the generate method is called by jekyll, and generates all of the tag pages.
	class GenerateTags < Generator
	safe true
	priority :low

	TAG_DIR = 'tag'

	def generate(site)
	site.write_tag_indexes
	end

	# Processes the given dir and removes leading and trailing slashes. Falls
	# back on the default if no dir is provided.
	def self.tag_dir(base_dir, tag)
	base_dir = (base_dir \|\| TAG_DIR).gsub(/^\/(.)\/*$/, '\1')
	tag = tag.gsub(/_\|\P{Word}/, '-').gsub(/-{2,}/, '-').downcase
	File.join(base_dir, tag)
	end

	end


	# Adds some extra filters used during the tag creation process.
	module Filters

	# Outputs a list of tags as comma-separated <a> links. This is used
	# to output the tag list for each post on a tag page.
	#
	# +tags+ is the list of tags to format.
	#
	# Returns string
	def tag_links(tags)
	base_dir = @context.registers[:site].config['tag_dir']
	tags = tags.sort!.map do \|tag\|
	tag_dir = GenerateTags.tag_dir(base_dir, tag)
	# Make sure the tag directory begins with a slash.
	tag_dir = "/#{tag_dir}" unless tag_dir =~ /^\//
	"<a class='tag' href='#{tag_dir}/'>#{tag}</a>"
	end

	case tags.length
	when 0
	""
	when 1
	tags[0].to_s
	else
	tags.join(', ')
	end
	end

	# Outputs the post.date as formatted html, with hooks for CSS styling.
	#
	# +date+ is the date object to format as HTML.
	#
	# Returns string
	def date_to_html_string(date)
	result = '<span class="month">' + date.strftime('%b').upcase + '</span> '
	result += date.strftime('<span class="day">%d</span> ')
	result += date.strftime('<span class="year">%Y</span> ')
	result
	end

	end

	end
	{% comment %}TODO put this in a separate include to save some trouble. Obviously there's some room for improvement here. {% endcomment %}
	<div class="post-tags">Tagged with <span>
	{% for tag in post.tags %}
	<a class="tag" href="{{ "/tag/" \| append: tag \| downcase \| replace: " ", "-" \| uri_escape }}">{{ tag }}</a>{% if forloop.last %}{% else %}, {% endif %}
	{% endfor %}
	</span></div>
	<div class="post-category">Posted in <span>
	{% for category in post.categories %}
	<a class="category" href="{{ "/category/" \| append: category \| downcase \| replace: " ", "-" \| uri_escape }}">{{ category }}</a>{% if forloop.last %}{% else %}, {% endif %}
	{% endfor %}
	</span></div>
	<!-- This used to work for Jekyll 2 -->
	<div class="post-tags">Tagged with <span>{{ post.tags \| tag_links }}</span></div>
	<div class="post-category">Posted in <span>{{ post.categories \| category_links }}</span></div>