jekyll 2.1.1 → 2.2.0

data/lib/jekyll/tags/include.rb

@@ -131,10 +131,6 @@ eos
         File.exist?(path) && File.realpath(path).start_with?(dir)
       end
 
-      def blank?
-        false
-      end
-
       # This method allows to modify the file content by inheriting from the class.
       def source(file, context)
         File.read(file, file_read_opts(context))

data/lib/jekyll/version.rb

@@ -1,3 +1,3 @@
 module Jekyll
-  VERSION = '2.1.1'
+  VERSION = '2.2.0'
 end

data/script/cibuild

@@ -1,4 +1,7 @@
 #! /bin/bash
 
+set -e
+
 script/branding
-bundle exec rake
+script/proof
+script/test

data/script/proof

@@ -0,0 +1,22 @@
+#! /bin/bash
+#
+# Usage:
+#   script/proof
+
+set -e
+
+git diff --name-only origin $(git log --pretty=format:"%h" -2 | tail -1) | grep '^site/' || {
+    echo "No site files changed. We'll skip proofing."
+    exit 0
+}
+
+echo "Some site files have been changed! Proofing..."
+
+command -v htmlproof || {
+    echo "Installing HTML::Proofer!"
+    gem install html-proofer -- --use-system-libraries
+}
+
+bundle exec jekyll build -s site -d _site --trace
+printf "\e[0;36mProofing begins now!\e[0m\n"
+htmlproof ./_site

data/script/test

@@ -1,11 +1,17 @@
 #! /bin/bash
+#
+# Usage:
+#   script/test
+#   script/test <hi>
 
 set -x
 
 if [ -z "$1" ]; then
-  TEST_FILES="test/test*.rb"
+  TEST_FILES="test/test_*.rb"
 else
   TEST_FILES="$@"
 fi
 
-/usr/bin/env bundle exec ruby -I"lib:test" -r rake -r rake/rake_test_loader ${TEST_FILES}
+set -x
+
+bundle exec rake

data/site/_config.yml

@@ -7,4 +7,3 @@ excerpt_separator: noifniof3nioaniof3nioafafinoafnoif
 repository: https://github.com/jekyll/jekyll
 help_url: https://github.com/jekyll/jekyll-help
 google_analytics_id: UA-50755011-1
-timezone: America/Los_Angeles

data/site/_posts/2013-05-06-jekyll-1-0-0-released.markdown

@@ -19,5 +19,5 @@ examples and for compiling this list):
 
 Take a look at the [Upgrading][] page in the docs for more detailed information.
 
-[history]: /docs/history/#100__20130506
+[history]: /docs/history/#v1-0-0
 [Upgrading]: /docs/upgrading/

data/site/_posts/2013-05-08-jekyll-1-0-1-released.markdown

@@ -24,4 +24,4 @@ See the [History][] page for more information on this release.
 [#{{ issue }}]: {{ site.repository }}/issues/{{ issue }}
 {% endfor %}
 
-[History]: /docs/history/#101__20130508
+[History]: /docs/history/#v1-0-1

data/site/_posts/2013-05-12-jekyll-1-0-2-released.markdown

@@ -25,4 +25,4 @@ See the [History][] page for more information on this release.
 [#{{ issue }}]: {{ site.repository }}/issues/{{ issue }}
 {% endfor %}
 
-[History]: /docs/history/#102__20130512
+[History]: /docs/history/#v1-0-2

data/site/_posts/2013-06-07-jekyll-1-0-3-released.markdown

@@ -22,4 +22,4 @@ See the [History][] page for more information on this release.
 [#{{ issue }}]: {{ site.repository }}/issues/{{ issue }}
 {% endfor %}
 
-[History]: /docs/history/#103__20130607
+[History]: /docs/history/#v1-0-3

data/site/_posts/2014-03-24-jekyll-1-5-0-released.markdown

@@ -16,4 +16,4 @@ For a full changelog, check out our [history][] page.
 Now, back to work on 2.0.0!
 
 [fun issue with path sanitizing]: https://github.com/jekyll/jekyll/issues/1948
-[history]: /docs/history/#150__20140324
+[history]: /docs/history/#v1-5-0

data/site/_posts/2014-05-06-jekyll-turns-2-0-0.markdown

@@ -22,10 +22,10 @@ Check out our [changelog][] for a complete list of all (200+) changes.
 
 Many thanks to these 183 contributors for making Jekyll 2.0.0 happen:
 
-Parker Moore, Matt Rogers, maul.esel, Anatol Broder, Zach Gersh, Joel Glovier, Ben Balter, XhmikosR, Coby Chapple, John Piasetzki, Aidan Feldman, Robin Dupret, Pascal Borreli, Troy Swanson, Erik Michaels-Ober, albertogg, Lucas Jenss, Matt Rogers & Persa Zula, Eric Mill, Shigeya Suzuki, Jens Nazarenus, ddavison, Pat Hawks, Rob Wierzbowski, MURAOKA Taro, Casey Lang, Fabian Rodriguez, Greg Karékinian, Zlatan Vasović, Christopher Nicotera, Dmitry Chestnykh, Ryan Morrissey, Jordon, John Hughes, akira yamada, Matt Swanson, Jashank Jeremy, Matthew Iversen, Meeka, liufengyun, Anand Narayan, nitoyon, Geoff Shannon, Benjamin J. Balter, Juan Ignacio Donoso, David Briggs, Benjamin Esham, Slava Pavlutin, Assaf Gelber, Josh Brown, Nick Fagerlund, Davide Ficano, pilosus, Anthony Smith, André Arko, Mikael Konutgan, Matthew Scharley, Dan Tao, scribu, Mort Yao, m, Stephen McDonald, Marcus Stollsteimer, Thomas Torsney-Weir, Jordon Bedwell, Tom Preston-Werner, Lincoln Mullen, Philip Poots, Ivan Tse, Christopher Giroir, Valery Tolstov, Wlodek Bzyl, Xavier Noria, Yi Zeng, Persa Zula, Phil Leggetter, Pirogov Evgenij, Rafael Revi, Rob McGuire-Dale, Rob Muhlestein, Robin Mehner, Roland Warmerdam, Rusty Geldmacher, Sam Rayner, Santeri Paavolainen, Sebastian Morr, Stephan Groß, Steven Spasbo, Tobias Brunner, Tuomas Kareinen, Tyler Margison, Uwe Dauernheim, Yihang Ho, Zach Leatherman, Zequez, andrew morton, andrewhavens, imathis, jannypie, jaybe@jekyll, kk_Ataka, markets, redwallhp, schneems, szymzet, thomasdao, tomsugden, wǒ_is神仙, 张君君, Noah Slater, Abhi Yerra, Adam Heckler, Ahmed Hazem, Aigars Dzerviniks, Aleksey V. Zapparov, Andreas Möller, Andy Lindeman, Arlen Cuss, Aziz Shamim, Ben Baker-Smith, Ben Hanzl, Ben Hildred, Brian Kim, Brice, Carol Nichols, Chezou, Chris Jones, Christian Grobmeier, Christoph Hochstrasser, Christoph Schiessl, Clint Shryock, Colin Dean, Corey Ward, Damian Lettie, Daniel Schauenberg, David Ensinger, David Paschich, David Sawyer, David Silva Smith, Donald Perry, Doug Johnston, Edward Ball, Eric Dobson, Erik Dungan, Florent Guilleux, Francis, Frederic ROS, GSI2013, Garen Torikian, George Anderson, Giuseppe Capizzi, Ishibashi Hideto, Jarrod Birch, Jeff Kolesky, Jens Bissinger, Jens Krause, John Firebaugh, John Papandriopoulos, Josh Branchaud, Katy DeCorah, Lachlan Holden, Mark Prins, Markus Roth, Martin Charles, Matt Iversen, Matt Sheehan, Matt Swensen, Matthias Vogelgesang, Michael Parker, Miha Rekar, Nathan Youngman, Nick Quaranto, Nick Quinlan, Nick Schonning, Nicolas Alpi, Nicolás Reynolds, Nikkau, 4ensicLog, Octavian Damiean, Olov Lassus, PatrickC8t, Paul Annesley, and Paul Oppenheim.
+Parker Moore, Matt Rogers, maul.esel, Anatol Broder, Zach Gersh, Joel Glovier, Ben Balter, XhmikosR, Coby Chapple, John Piasetzki, Aidan Feldman, Robin Dupret, Pascal Borreli, Troy Swanson, Erik Michaels-Ober, albertogg, Lucas Jenss, Matt Rogers & Persa Zula, Eric Mill, Shigeya Suzuki, Jens Nazarenus, ddavison, Pat Hawks, Rob Wierzbowski, MURAOKA Taro, Casey Lang, Fabian Rodriguez, Greg Karékinian, Zlatan Vasović, Christopher Nicotera, Dmitry Chestnykh, Ryan Morrissey, Jordon, John Hughes, akira yamada, Matt Swanson, Jashank Jeremy, Matthew Iversen, Meeka, liufengyun, Anand Narayan, nitoyon, Geoff Shannon, Benjamin J. Balter, Juan Ignacio Donoso, David Briggs, Benjamin Esham, Slava Pavlutin, Assaf Gelber, Josh Brown, Nick Fagerlund, Davide Ficano, pilosus, Anthony Smith, André Arko, Mikael Konutgan, Matthew Scharley, Dan Tao, scribu, Mort Yao, m, Stephen McDonald, Marcus Stollsteimer, Thomas Torsney-Weir, Jordon Bedwell, Tom Preston-Werner, Lincoln Mullen, Philip Poots, Ivan Tse, Christopher Giroir, Valery Tolstov, Wlodek Bzyl, Xavier Noria, Yi Zeng, Persa Zula, Phil Leggetter, Pirogov Evgenij, Rafael Revi, Rob McGuire-Dale, Rob Muhlestein, Robin Mehner, Roland Warmerdam, Rusty Geldmacher, Sam Rayner, Santeri Paavolainen, Sebastian Morr, Stephan Groß, Steven Spasbo, Tobias Brunner, Tuomas Kareinen, Tyler Margison, Uwe Dauernheim, Yihang Ho, Zach Leatherman, Zequez, andrew morton, andrewhavens, imathis, jannypie, jaybe@jekyll, kk_Ataka, markets, redwallhp, schneems, szymzet, thomasdao, tomsugden, wǒis神仙, 张君君, Noah Slater, Abhi Yerra, Adam Heckler, Ahmed Hazem, Aigars Dzerviniks, Aleksey V. Zapparov, Andreas Möller, Andy Lindeman, Arlen Cuss, Aziz Shamim, Ben Baker-Smith, Ben Hanzl, Ben Hildred, Brian Kim, Brice, Carol Nichols, Chezou, Chris Jones, Christian Grobmeier, Christoph Hochstrasser, Christoph Schiessl, Clint Shryock, Colin Dean, Corey Ward, Damian Lettie, Daniel Schauenberg, David Ensinger, David Paschich, David Sawyer, David Silva Smith, Donald Perry, Doug Johnston, Edward Ball, Eric Dobson, Erik Dungan, Florent Guilleux, Francis, Frederic ROS, GSI2013, Garen Torikian, George Anderson, Giuseppe Capizzi, Ishibashi Hideto, Jarrod Birch, Jeff Kolesky, Jens Bissinger, Jens Krause, John Firebaugh, John Papandriopoulos, Josh Branchaud, Katy DeCorah, Lachlan Holden, Mark Prins, Markus Roth, Martin Charles, Matt Iversen, Matt Sheehan, Matt Swensen, Matthias Vogelgesang, Michael Parker, Miha Rekar, Nathan Youngman, Nick Quaranto, Nick Quinlan, Nick Schonning, Nicolas Alpi, Nicolás Reynolds, Nikkau, 4ensicLog, Octavian Damiean, Olov Lassus, PatrickC8t, Paul Annesley, and Paul Oppenheim.
 
 Happy developing!
 
 [changelog]: /docs/history/
 [@jglovier]: https://github.com/jglovier
-[jekyll-1]: {% post_url 2013-05-05-jekyll-1-0-0-released %}
+[jekyll-1]: /news/2013/05/06/jekyll-1-0-0-released/

data/site/_posts/2014-06-28-jekyll-turns-21-i-mean-2-1-0.markdown

@@ -24,7 +24,7 @@ things to look forward to:
 
 Let's go party!
 
-*Check out the [full changelog](/docs/history/) for more.*
+*Check out the [full changelog](/docs/history/#v2-1-0) for more.*
 
 Many thanks to these 37 contributors for the 2.1.0 release:
 

data/site/_posts/2014-07-29-jekyll-2-2-0-released.markdown

@@ -0,0 +1,19 @@
+---
+layout: news_item
+title: 'Jekyll 2.2.0 Released'
+date: 2014-07-29 18:59:13 -0400
+author: parkr
+version: 2.2.0
+categories: [release]
+---
+
+Jekyll 2.2.0 contains a few key updates:
+
+1. A warning will now fire if you specify a layout in any of your pages or
+    posts that doesn't exist.
+2. Certain Pygments options are now whitelisted in safe mode
+3. Categories in a post's path are now respected (i.e. folders in `_posts`
+   will now work properly).
+
+As always, a full list of the updates are on the
+[history page](/docs/history#v2-2-0). Happy Jekylling!

data/site/docs/assets.md

@@ -21,9 +21,9 @@ or `.coffee`) and start the file with two lines of triple dashes, like this:
 
 Jekyll treats these files the same as a regular page, in that the output file
 will be placed in the same directory that it came from. For instance, if you
-have a file named `/css/styles.scss` in your site's source folder, Jekyll
+have a file named `css/styles.scss` in your site's source folder, Jekyll
 will process it and put it in your site's destination folder under
-`/css/styles.css`.
+`css/styles.css`.
 
 ## Sass/SCSS
 
@@ -38,7 +38,21 @@ sass:
     sass_dir: _sass
 {% endhighlight %}
 
-The Sass converter will default to `_sass`.
+The Sass converter will default the `sass_dir` configuration option to
+`_sass`.
+
+<div class="note info">
+  <h5>The <code>sass_dir</code> is only used by Sass</h5>
+  <p>
+
+    Note that the `sass_dir` becomes the load path for Sass imports,
+    nothing more. This means that Jekyll does not know about these files
+    directly, so any files here should not contain the YAML front matter as
+    described above nor will they be transformed as described above. This
+    folder should only contain imports.
+
+  </p>
+</div>
 
 You may also specify the output style with the `style` option in your
 `_config.yml` file:

data/site/docs/contributing.md

@@ -106,7 +106,7 @@ The [Jekyll wiki]({{ site.repository }}/wiki) on GitHub
 can be freely updated without a pull request as all
 GitHub users have access.
 
-If you want to add your plugin to the [list of plugins](/docs/plugins/#available_plugins),
+If you want to add your plugin to the [list of plugins](/docs/plugins/#available-plugins),
 please submit a pull request modifying the [plugins page source
 file]({{ site.repository }}/blob/master/site/docs/plugins.md) by adding a
 link to your plugin under the proper subheading depending upon its type.

data/site/docs/deployment-methods.md

@@ -73,10 +73,23 @@ Deploying is now as easy as telling nginx or Apache to look at
 laptops$ git push deploy master
 {% endhighlight %}
 
+### Jekyll-hook
+
+You can also use jekyll-hook, a server that listens for webhook posts from
+GitHub, generates a website with Jekyll, and moves it somewhere to be
+published. Use this to run your own GitHub Pages-style web server.
+
+This method is useful if you need to serve your websites behind a firewall,
+need extra server-level features like HTTP basic authentication or want to
+host your site directly on a CDN or file host like S3.
+
+Setup steps are fully documented
+[in the `jekyll-hook` repo](https://github.com/developmentseed/jekyll-hook).
+
 ### Rake
 
 Another way to deploy your Jekyll site is to use [Rake](https://github.com/jimweirich/rake), [HighLine](https://github.com/JEG2/highline), and
-[Net::SSH](http://net-ssh.rubyforge.org/). A more complex example of deploying Jekyll with Rake that deals with multiple branches can be found in [Git Ready](https://github.com/gitready/gitready/blob/cdfbc4ec5321ff8d18c3ce936e9c749dbbc4f190/Rakefile).
+[Net::SSH](https://github.com/net-ssh/net-ssh). A more complex example of deploying Jekyll with Rake that deals with multiple branches can be found in [Git Ready](https://github.com/gitready/gitready/blob/cdfbc4ec5321ff8d18c3ce936e9c749dbbc4f190/Rakefile).
 
 ### rsync
 
@@ -86,7 +99,7 @@ this script from within Textmate.
 
 ## Rack-Jekyll
 
-[Rack-Jekyll](https://github.com/adaoraul/rack-jekyll/) is an easy way to deploy your site on any Rack server such as Amazon EC2, Slicehost, Heroku, and so forth. It also can run with [shotgun](https://github.com/rtomakyo/shotgun/), [rackup](https://github.com/rack/rack), [mongrel](https://github.com/mongrel/mongrel), [unicorn](https://github.com/defunkt/unicorn/), and [others](https://github.com/adaoraul/rack-jekyll#readme).
+[Rack-Jekyll](https://github.com/adaoraul/rack-jekyll/) is an easy way to deploy your site on any Rack server such as Amazon EC2, Slicehost, Heroku, and so forth. It also can run with [shotgun](https://github.com/rtomayko/shotgun/), [rackup](https://github.com/rack/rack), [mongrel](https://github.com/mongrel/mongrel), [unicorn](https://github.com/defunkt/unicorn/), and [others](https://github.com/adaoraul/rack-jekyll#readme).
 
 Read [this post](http://blog.crowdint.com/2010/08/02/instant-blog-using-jekyll-and-heroku.html) on how to deploy to Heroku using Rack-Jekyll.
 

data/site/docs/extras.md

@@ -9,82 +9,10 @@ permalink: /docs/extras/
 There are a number of (optional) extra features that Jekyll supports that you
 may want to install, depending on how you plan to use Jekyll.
 
-## LaTeX Support
+## Math Support
 
-Maruku comes with optional support for LaTeX to PNG rendering via blahtex
-(Version 0.6) which must be in your `$PATH` along with `dvips`.
+Kramdown comes with optional support for LaTeX to PNG rendering via [MathJax](http://www.mathjax.org/) within math blocks. See the Kramdown documentation on [math blocks](http://kramdown.gettalong.org/syntax.html#math-blocks) and [math support](http://kramdown.gettalong.org/converter/html.html#math-support) for more details.
 
 ## Alternative Markdown Processors
 
-While Jekyll defaults to using Maruku for Markdown conversion, you may use one
-of the other three pre-defined markdown parsers or define your own.
-
-### RDiscount
-
-If you prefer to use [RDiscount](https://github.com/rtomayko/rdiscount) instead
-of [Maruku](https://github.com/bhollis/maruku) for Markdown, just make sure you have
-it installed:
-
-{% highlight bash %}
-$ [sudo] gem install rdiscount
-{% endhighlight %}
-
-And then specify RDiscount as the Markdown engine in your `_config.yml` file to
-have Jekyll run with that option.
-
-{% highlight yaml %}
-# In _config.yml
-markdown: rdiscount
-{% endhighlight %}
-
-### Kramdown
-
-You can also use [Kramdown](http://kramdown.rubyforge.org/) instead of Maruku
-for Markdown. Make sure that Kramdown is installed:
-
-{% highlight bash %}
-$ [sudo] gem install kramdown
-{% endhighlight %}
-
-Then you can specify Kramdown as the Markdown engine in `_config.yml`.
-
-{% highlight yaml %}
-# In _config.yml
-markdown: kramdown
-{% endhighlight %}
-
-Kramdown has various options for customizing the HTML output. The
-[Configuration](/docs/configuration/) page lists the default options used by
-Jekyll. A complete list of options is also available on the [Kramdown
-website](http://kramdown.rubyforge.org/options.html).
-
-### User-Defined
-
-So, you're totally at odds with our four built-in markdown parsers, eh? No
-sweat. You can define one as a plugin:
-
-{% highlight ruby %}
-require 'jekyll'
-require 'some_renderer'
-
-class Jekyll::Converters::Markdown::MyCustomParser
-  def initialize(config)
-    @site_config = config
-  end
-
-  def convert(content)
-    # (this _must_ return the resulting String after the rendering)
-    SomeRenderer.new(@site_config).to_html(content)
-  end
-end
-{% endhighlight %}
-
-Once you've got that setup, ask Jekyll to use your custom markdown parser in
-your `_config.yml` file:
-
-{% highlight yaml %}
-markdown: MyCustomParser
-{% endhighlight %}
-
-(Note that this **is case-sensitive**, and is only the piece after
-`Jekyll::Converters::Markdown`.) And there you are!
+See the Markdown section on the [configuration page](/docs/configuration/#markdown-options) for instructions on how to use and configure alternative Markdown processors, as well as how to create [custom processors](/docs/configuration/#custom-markdown-processors).

data/site/docs/github-pages.md

@@ -8,7 +8,7 @@ permalink: /docs/github-pages/
 
 [GitHub Pages](http://pages.github.com) are public web pages for users,
 organizations, and repositories, that are freely hosted on GitHub's
-[github.io]() domain or on a custom domain name of your choice. GitHub Pages are
+`github.io` domain or on a custom domain name of your choice. GitHub Pages are
 powered by Jekyll behind the scenes, so in addition to supporting regular HTML
 content, they’re also a great way to host your Jekyll-powered website for free.
 

data/site/docs/history.md

@@ -5,9 +5,69 @@ permalink: "/docs/history/"
 prev_section: contributing
 ---
 
+## 2.2.0 / 2014-07-29
+{: #v2-2-0}
+
+### Minor Enhancements
+{: #minor-enhancements-v2-2-0}
+
+- Throw a warning if the specified layout does not exist ([#2620]({{ site.repository }}/issues/2620))
+- Whitelist Pygments options in safe mode ([#2642]({{ site.repository }}/issues/2642))
+
+### Bug Fixes
+{: #bug-fixes-v2-2-0}
+
+- Remove unnecessary `Jekyll::Tags::IncludeTag#blank?` method ([#2625]({{ site.repository }}/issues/2625))
+- Categories in the path are ignored ([#2633]({{ site.repository }}/issues/2633))
+
+### Development Fixes
+{: #development-fixes-v2-2-0}
+
+- Refactoring Errors & Requires of Third-Party stuff ([#2591]({{ site.repository }}/issues/2591))
+- Add further tests for categories ([#2584]({{ site.repository }}/issues/2584))
+- Proof site with html-proofer on change ([#2605]({{ site.repository }}/issues/2605))
+- Fix up bug in [#2605]({{ site.repository }}/issues/2605) which caused proofing the site not to function ([#2608]({{ site.repository }}/issues/2608))
+- Use `bundle exec` in `script/proof` ([#2610]({{ site.repository }}/issues/2610))
+
+### Site Enhancements
+{: #site-enhancements-v2-2-0}
+
+- Update Kramdown urls ([#2588]({{ site.repository }}/issues/2588))
+- Add `Jekyll::AutolinkEmail` and `Jekyll::GitMetadata` to the list of
+    third-party plugins ([#2596]({{ site.repository }}/issues/2596))
+- Fix a bunch of broken links in the site ([#2601]({{ site.repository }}/issues/2601))
+- Replace dead links with working links ([#2611]({{ site.repository }}/issues/2611))
+- Add jekyll-hook to deployment methods ([#2617]({{ site.repository }}/issues/2617))
+- Added kramdown-with-pygments plugin to the list of third-party plugins ([#2623]({{ site.repository }}/issues/2623))
+- Update outdated "Extras" page and remove duplicate documentation ([#2622]({{ site.repository }}/issues/2622))
+- Add co2 plugin to list of third-party plugins ([#2639]({{ site.repository }}/issues/2639))
+- Attempt to clarify the way Sass imports happen ([#2642]({{ site.repository }}/issues/2642))
+
+
+## 2.1.1 / 2014-07-01
+{: #v2-1-1}
+
+### Bug Fixes
+{: #bug-fixes-v2-1-1}
+
+- Patch read vulnerabilities for data & confirm none for layouts ([#2563]({{ site.repository }}/issues/2563))
+- Update Maruku dependency to allow use of the latest version ([#2576]({{ site.repository }}/issues/2576))
+- Remove conditional assignment from document URL to prevent stale urls ([#2575]({{ site.repository }}/issues/2575))
+
+### Site Enhancements
+{: #site-enhancements-v2-1-1}
+
+- Add vertical margin to `highlight` to separate code blocks ([#2558]({{ site.repository }}/issues/2558))
+- Add `html_pages` to Variables docs ([#2567]({{ site.repository }}/issues/2567))
+- Fixed broken link to Permalinks page ([#2572]({{ site.repository }}/issues/2572))
+- Update link to Windows installation guide ([#2578]({{ site.repository }}/issues/2578))
+
+
 ## 2.1.0 / 2014-06-28
+{: #v2-1-0}
 
 ### Minor Enhancements
+{: #minor-enhancements-v2-1-0}
 
 - Bump to the latest Liquid version, 2.6.1 ([#2495]({{ site.repository }}/issues/2495))
 - Add support for JSON files in the `_data` directory ([#2369]({{ site.repository }}/issues/2369))
@@ -36,6 +96,7 @@ prev_section: contributing
 - Spike out `--watch` flag into a separate gem ([#2550]({{ site.repository }}/issues/2550))
 
 ### Bug Fixes
+{: #bug-fixes-v2-1-0}
 
 - Liquid `sort` filter should sort even if one of the values is `nil` ([#2345]({{ site.repository }}/issues/2345))
 - Remove padding on `pre code` in the site template CSS ([#2383]({{ site.repository }}/issues/2383))
@@ -60,6 +121,7 @@ prev_section: contributing
 - Be quiet very quickly. ([#2520]({{ site.repository }}/issues/2520))
 
 ### Development Fixes
+{: #development-fixes-v2-1-0}
 
 - Test Ruby 2.1.2 instead of 2.1.1 ([#2374]({{ site.repository }}/issues/2374))
 - Add test for sorting UTF-8 characters ([#2384]({{ site.repository }}/issues/2384))
@@ -68,6 +130,7 @@ prev_section: contributing
 - Fix a bit of missing TomDoc to `Jekyll::Commands::Build#build` ([#2554]({{ site.repository }}/issues/2554))
 
 ### Site Enhancements
+{: #site-enhancements-v2-1-0}
 
 - Set `timezone` to `America/Los_Angeles` ([#2394]({{ site.repository }}/issues/2394))
 - Improve JavaScript in `anchor_links.html` ([#2368]({{ site.repository }}/issues/2368))
@@ -91,9 +154,12 @@ prev_section: contributing
 - Remove `url` from configuration docs ([#2547]({{ site.repository }}/issues/2547))
 - Documentation for Continuous Integration for your Jekyll Site ([#2432]({{ site.repository }}/issues/2432))
 
+
 ## 2.0.3 / 2014-05-08
+{: #v2-0-3}
 
 ### Bug Fixes
+{: #bug-fixes-v2-0-3}
 
 - Properly prefix links in site template with URL or baseurl depending upon
     need. ([#2319]({{ site.repository }}/issues/2319))
@@ -108,6 +174,7 @@ prev_section: contributing
 - Rescue errors thrown so `--watch` doesn't fail ([#2364]({{ site.repository }}/issues/2364))
 
 ### Site Enhancements
+{: #site-enhancements-v2-0-3}
 
 - Add missing "as" to assets docs page ([#2337]({{ site.repository }}/issues/2337))
 - Update docs to reflect new `baseurl` default ([#2341]({{ site.repository }}/issues/2341))
@@ -116,27 +183,37 @@ prev_section: contributing
 - Fix link to frontmatter defaults docs ([#2353]({{ site.repository }}/issues/2353))
 - Fix for `History.markdown` in order to fix history page in docs ([#2363]({{ site.repository }}/issues/2363))
 
+
 ## 2.0.2 / 2014-05-07
+{: #v2-0-2}
 
 ### Bug Fixes
+{: #bug-fixes-v2-0-2}
 
 - Correct use of `url` and `baseurl` in the site template. ([#2317]({{ site.repository }}/issues/2317))
 - Default `baseurl` to `""` ([#2317]({{ site.repository }}/issues/2317))
 
 ### Site Enhancements
+{: #site-enhancements-v2-0-2}
 
 - Correct docs for the `gist` plugin so it always includes the username. ([#2314]({{ site.repository }}/issues/2314))
 - Clarify new (defaults, `where` filter) features in docs ([#2316]({{ site.repository }}/issues/2316))
 
+
 ## 2.0.1 / 2014-05-06
+{: #v2-0-1}
 
 ### Bug Fixes
+{: #bug-fixes-v2-0-1}
 
 - Require `kramdown` gem instead of `maruku` gem
 
+
 ## 2.0.0 / 2014-05-06
+{: #v2-0-0}
 
 ### Major Enhancements
+{: #major-enhancements-v2-0-0}
 - Add "Collections" feature ([#2199]({{ site.repository }}/issues/2199))
 - Add gem-based plugin whitelist to safe mode ([#1657]({{ site.repository }}/issues/1657))
 - Replace the commander command line parser with a more robust
@@ -158,6 +235,7 @@ prev_section: contributing
 - Exclude files based on prefix as well as `fnmatch?` ([#2303]({{ site.repository }}/issues/2303))
 
 ### Minor Enhancements
+{: #minor-enhancements-v2-0-0}
 - Move the EntryFilter class into the Jekyll module to avoid polluting the
     global namespace ([#1800]({{ site.repository }}/issues/1800))
 - Add `group_by` Liquid filter create lists of items grouped by a common
@@ -210,6 +288,7 @@ prev_section: contributing
 - Take into account missing values in the Liquid sort filter ([#2299]({{ site.repository }}/issues/2299))
 
 ### Bug Fixes
+{: #bug-fixes-v2-0-0}
 - Don't allow nil entries when loading posts ([#1796]({{ site.repository }}/issues/1796))
 - Remove the scrollbar that's always displayed in new sites generated
     from the site template ([#1805]({{ site.repository }}/issues/1805))
@@ -245,6 +324,7 @@ prev_section: contributing
 - Add `output` to `Document` liquid output hash ([#2309]({{ site.repository }}/issues/2309))
 
 ### Development Fixes
+{: #development-fixes-v2-0-0}
 - Add a link to the site in the README.md file ([#1795]({{ site.repository }}/issues/1795))
 - Add in History and site changes from `v1-stable` branch ([#1836]({{ site.repository }}/issues/1836))
 - Testing additions on the Excerpt class ([#1893]({{ site.repository }}/issues/1893))
@@ -280,6 +360,7 @@ prev_section: contributing
 - Workaround for Travis bug ([#2290]({{ site.repository }}/issues/2290))
 
 ### Site Enhancements
+{: #site-enhancements-v2-0-0}
 - Document Kramdown's GFM parser option ([#1791]({{ site.repository }}/issues/1791))
 - Move CSS to includes & update normalize.css to v2.1.3 ([#1787]({{ site.repository }}/issues/1787))
 - Minify CSS only in production ([#1803]({{ site.repository }}/issues/1803))
@@ -361,84 +442,114 @@ prev_section: contributing
 - Add docs for `where` and `group_by` Liquid filters ([#2298]({{ site.repository }}/issues/2298))
 - Remove notes in docs for unreleased features ([#2309]({{ site.repository }}/issues/2309))
 
+
 ## 1.5.1 / 2014-03-27
+{: #v1-5-1}
 
 ### Bug Fixes
+{: #bug-fixes-v1-5-1}
 
 - Only strip the drive name if it begins the string ([#2176]({{ site.repository }}/issues/2176))
 
+
 ## 1.5.0 / 2014-03-24
+{: #v1-5-0}
 
 ### Minor Enhancements
+{: #minor-enhancements-v1-5-0}
 
 - Loosen `safe_yaml` dependency to `~> 1.0` ([#2167]({{ site.repository }}/issues/2167))
 - Bump `safe_yaml` dependency to `~> 1.0.0` ([#1942]({{ site.repository }}/issues/1942))
 
 ### Bug Fixes
+{: #bug-fixes-v1-5-0}
 
 - Fix issue where filesystem traversal restriction broke Windows ([#2167]({{ site.repository }}/issues/2167))
 - Lock `maruku` at `0.7.0` ([#2167]({{ site.repository }}/issues/2167))
 
 ### Development Fixes
+{: #development-fixes-v1-5-0}
 
 - Lock `cucumber` at `1.3.11` ([#2167]({{ site.repository }}/issues/2167))
 
+
 ## 1.4.3 / 2014-01-13
+{: #v1-4-3}
 
 ### Bug Fixes
+{: #bug-fixes-v1-4-3}
 - Patch show-stopping security vulnerabilities ([#1944]({{ site.repository }}/issues/1944))
 
+
 ## 1.4.2 / 2013-12-16
+{: #v1-4-2}
 
 ### Bug Fixes
+{: #bug-fixes-v1-4-2}
 - Turn on Maruku fenced code blocks by default ([#1830]({{ site.repository }}/issues/1830))
 
+
 ## 1.4.1 / 2013-12-09
+{: #v1-4-1}
 
 ### Bug Fixes
+{: #bug-fixes-v1-4-1}
 - Don't allow nil entries when loading posts ([#1796]({{ site.repository }}/issues/1796))
 
+
 ## 1.4.0 / 2013-12-07
+{: #v1-4-0}
 
 ### Major Enhancements
+{: #major-enhancements-v1-4-0}
 - Add support for TOML config files ([#1765]({{ site.repository }}/issues/1765))
 
 ### Minor Enhancements
+{: #minor-enhancements-v1-4-0}
 - Sort plugins as a way to establish a load order ([#1682]({{ site.repository }}/issues/1682))
 - Update Maruku to 0.7.0 ([#1775]({{ site.repository }}/issues/1775))
 
 ### Bug Fixes
+{: #bug-fixes-v1-4-0}
 - Add a space between two words in a Pagination warning message ([#1769]({{ site.repository }}/issues/1769))
 - Upgrade `toml` gem to `v0.1.0` to maintain compat with Ruby 1.8.7 ([#1778]({{ site.repository }}/issues/1778))
 
 ### Development Fixes
+{: #development-fixes-v1-4-0}
 - Remove some whitespace in the code ([#1755]({{ site.repository }}/issues/1755))
 - Remove some duplication in the reading of posts and drafts ([#1779]({{ site.repository }}/issues/1779))
 
 ### Site Enhancements
+{: #site-enhancements-v1-4-0}
 - Fixed case of a word in the Jekyll v1.3.0 release post ([#1762]({{ site.repository }}/issues/1762))
 - Fixed the mime type for the favicon ([#1772]({{ site.repository }}/issues/1772))
 
+
 ## 1.3.1 / 2013-11-26
+{: #v1-3-1}
 
 ### Minor Enhancements
+{: #minor-enhancements-v1-3-1}
 - Add a `--prefix` option to passthrough for the importers ([#1669]({{ site.repository }}/issues/1669))
 - Push the paginator plugin lower in the plugin priority order so
     other plugins run before it ([#1759]({{ site.repository }}/issues/1759))
 
 ### Bug Fixes
+{: #bug-fixes-v1-3-1}
 - Fix the include tag when ran in a loop ([#1726]({{ site.repository }}/issues/1726))
 - Fix errors when using `--watch` on 1.8.7 ([#1730]({{ site.repository }}/issues/1730))
 - Specify where the include is called from if an included file is
     missing ([#1746]({{ site.repository }}/issues/1746))
 
 ### Development Fixes
+{: #development-fixes-v1-3-1}
 - Extract `Site#filter_entries` into its own object ([#1697]({{ site.repository }}/issues/1697))
 - Enable Travis' bundle caching ([#1734]({{ site.repository }}/issues/1734))
 - Remove trailing whitespace in some files ([#1736]({{ site.repository }}/issues/1736))
 - Fix a duplicate test name ([#1754]({{ site.repository }}/issues/1754))
 
 ### Site Enhancements
+{: #site-enhancements-v1-3-1}
 - Update link to example Rakefile to point to specific commit ([#1741]({{ site.repository }}/issues/1741))
 - Fix drafts docs to indicate that draft time is based on file modification
     time, not `Time.now` ([#1695]({{ site.repository }}/issues/1695))
@@ -452,15 +563,19 @@ prev_section: contributing
 - Add docs for `post_url` when posts are in subdirectories ([#1718]({{ site.repository }}/issues/1718))
 - Update the docs to point to `example.com` ([#1448]({{ site.repository }}/issues/1448))
 
+
 ## 1.3.0 / 2013-11-04
+{: #v1-3-0}
 
 ### Major Enhancements
+{: #major-enhancements-v1-3-0}
 - Add support for adding data as YAML files under a site's `_data`
     directory ([#1003]({{ site.repository }}/issues/1003))
 - Allow variables to be used with `include` tags ([#1495]({{ site.repository }}/issues/1495))
 - Allow using gems for plugin management ([#1557]({{ site.repository }}/issues/1557))
 
 ### Minor Enhancements
+{: #minor-enhancements-v1-3-0}
 - Decrease the specificity in the site template CSS ([#1574]({{ site.repository }}/issues/1574))
 - Add `encoding` configuration option ([#1449]({{ site.repository }}/issues/1449))
 - Provide better error handling for Jekyll's custom Liquid tags
@@ -478,6 +593,7 @@ prev_section: contributing
     missing ([#1662]({{ site.repository }}/issues/1662))
 
 ### Bug Fixes
+{: #bug-fixes-v1-3-0}
 - Fix up matching against source and destination when the two
     locations are similar ([#1556]({{ site.repository }}/issues/1556))
 - Fix the missing `pathname` require in certain cases ([#1255]({{ site.repository }}/issues/1255))
@@ -493,6 +609,7 @@ prev_section: contributing
     incompatibilities ([#1687]({{ site.repository }}/issues/1687))
 
 ### Development Fixes
+{: #development-fixes-v1-3-0}
 - Add coverage reporting with Coveralls ([#1539]({{ site.repository }}/issues/1539))
 - Refactor the Liquid `include` tag ([#1490]({{ site.repository }}/issues/1490))
 - Update launchy dependency to `~> 2.3` ([#1608]({{ site.repository }}/issues/1608))
@@ -509,6 +626,7 @@ prev_section: contributing
 - Improve comparisons of timestamps by ignoring the seconds ([#1582]({{ site.repository }}/issues/1582))
 
 ### Site Enhancements
+{: #site-enhancements-v1-3-0}
 - Fix params for `JekyllImport::WordPress.process` arguments ([#1554]({{ site.repository }}/issues/1554))
 - Add `jekyll-suggested-tweet` to list of third-party plugins ([#1555]({{ site.repository }}/issues/1555))
 - Link to Liquid's docs for tags and filters ([#1553]({{ site.repository }}/issues/1553))
@@ -526,37 +644,47 @@ prev_section: contributing
 - Fix navigation in the "Working with Drafts" page ([#1667]({{ site.repository }}/issues/1667))
 - Fix an error with the data documentation ([#1691]({{ site.repository }}/issues/1691))
 
+
 ## 1.2.1 / 2013-09-14
+{: #v1-2-1}
 
 ### Minor Enhancements
+{: #minor-enhancements-v1-2-1}
 - Print better messages for detached server. Mute output on detach. ([#1518]({{ site.repository }}/issues/1518))
 - Disable reverse lookup when running `jekyll serve` ([#1363]({{ site.repository }}/issues/1363))
 - Upgrade RedCarpet dependency to `~> 2.3.0` ([#1515]({{ site.repository }}/issues/1515))
 - Upgrade to Liquid `>= 2.5.2, < 2.6` ([#1536]({{ site.repository }}/issues/1536))
 
 ### Bug Fixes
+{: #bug-fixes-v1-2-1}
 - Fix file discrepancy in gemspec ([#1522]({{ site.repository }}/issues/1522))
 - Force rendering of Include tag ([#1525]({{ site.repository }}/issues/1525))
 
 ### Development Fixes
+{: #development-fixes-v1-2-1}
 - Add a rake task to generate a new release post ([#1404]({{ site.repository }}/issues/1404))
 - Mute LSI output in tests ([#1531]({{ site.repository }}/issues/1531))
 - Update contributor documentation ([#1537]({{ site.repository }}/issues/1537))
 
 ### Site Enhancements
+{: #site-enhancements-v1-2-1}
 - Fix a couple of validation errors on the site ([#1511]({{ site.repository }}/issues/1511))
 - Make navigation menus reusable ([#1507]({{ site.repository }}/issues/1507))
 - Fix link to History page from Release v1.2.0 notes post.
 - Fix markup in History file for command line options ([#1512]({{ site.repository }}/issues/1512))
 - Expand 1.2 release post title to 1.2.0 ([#1516]({{ site.repository }}/issues/1516))
 
+
 ## 1.2.0 / 2013-09-06
+{: #v1-2-0}
 
 ### Major Enhancements
+{: #major-enhancements-v1-2-0}
 - Disable automatically-generated excerpts when `excerpt_separator` is `""`. ([#1386]({{ site.repository }}/issues/1386))
 - Add checking for URL conflicts when running `jekyll doctor` ([#1389]({{ site.repository }}/issues/1389))
 
 ### Minor Enhancements
+{: #minor-enhancements-v1-2-0}
 - Catch and fix invalid `paginate` values ([#1390]({{ site.repository }}/issues/1390))
 - Remove superfluous `div.container` from the default html template for
     `jekyll new` ([#1315]({{ site.repository }}/issues/1315))
@@ -572,6 +700,7 @@ prev_section: contributing
     `jekyll.version` variable ([#1481]({{ site.repository }}/issues/1481))
 
 ### Bug Fixes
+{: #bug-fixes-v1-2-0}
 - Markdown extension matching matches only exact matches ([#1382]({{ site.repository }}/issues/1382))
 - Fixed NoMethodError when message passed to `Stevenson#message` is nil ([#1388]({{ site.repository }}/issues/1388))
 - Use binary mode when writing file ([#1364]({{ site.repository }}/issues/1364))
@@ -587,6 +716,7 @@ prev_section: contributing
     tag ([#1494]({{ site.repository }}/issues/1494))
 
 ### Development Fixes
+{: #development-fixes-v1-2-0}
 - Remove redundant argument to
     Jekyll::Commands::New#scaffold_post_content ([#1356]({{ site.repository }}/issues/1356))
 - Add new dependencies to the README ([#1360]({{ site.repository }}/issues/1360))
@@ -598,6 +728,7 @@ prev_section: contributing
 - Add Gem version and dependency badge to README ([#1497]({{ site.repository }}/issues/1497))
 
 ### Site Enhancements
+{: #site-enhancements-v1-2-0}
 - Add info about new releases ([#1353]({{ site.repository }}/issues/1353))
 - Update plugin list with jekyll-rss plugin ([#1354]({{ site.repository }}/issues/1354))
 - Update the site list page with Ruby's official site ([#1358]({{ site.repository }}/issues/1358))
@@ -619,21 +750,29 @@ prev_section: contributing
 - XML escape the blog post title in our feed ([#1501]({{ site.repository }}/issues/1501))
 - Add `jekyll-toc-generator` to list of third-party plugins ([#1506]({{ site.repository }}/issues/1506))
 
+
 ## 1.1.2 / 2013-07-25
+{: #v1-1-2}
 
 ### Bug Fixes
+{: #bug-fixes-v1-1-2}
 - Require Liquid 2.5.1 ([#1349]({{ site.repository }}/issues/1349))
 
+
 ## 1.1.1 / 2013-07-24
+{: #v1-1-1}
 
 ### Minor Enhancements
+{: #minor-enhancements-v1-1-1}
 - Remove superfluous `table` selector from main.css in `jekyll new` template ([#1328]({{ site.repository }}/issues/1328))
 - Abort with non-zero exit codes ([#1338]({{ site.repository }}/issues/1338))
 
 ### Bug Fixes
+{: #bug-fixes-v1-1-1}
 - Fix up the rendering of excerpts ([#1339]({{ site.repository }}/issues/1339))
 
 ### Site Enhancements
+{: #site-enhancements-v1-1-1}
 - Add Jekyll Image Tag to the plugins list ([#1306]({{ site.repository }}/issues/1306))
 - Remove erroneous statement that `site.pages` are sorted alphabetically.
 - Add info about the `_drafts` directory to the directory structure
@@ -647,14 +786,18 @@ prev_section: contributing
     will automatically convert them. ([#1303]({{ site.repository }}/issues/1303))
 - Add an RSS feed for commits to Jekyll ([#1343]({{ site.repository }}/issues/1343))
 
+
 ## 1.1.0 / 2013-07-14
+{: #v1-1-0}
 
 ### Major Enhancements
+{: #major-enhancements-v1-1-0}
 - Add `docs` subcommand to read Jekyll's docs when offline. ([#1046]({{ site.repository }}/issues/1046))
 - Support passing parameters to templates in `include` tag ([#1204]({{ site.repository }}/issues/1204))
 - Add support for Liquid tags to post excerpts ([#1302]({{ site.repository }}/issues/1302))
 
 ### Minor Enhancements
+{: #minor-enhancements-v1-1-0}
 - Search the hierarchy of pagination path up to site root to determine template page for
     pagination. ([#1198]({{ site.repository }}/issues/1198))
 - Add the ability to generate a new Jekyll site without a template ([#1171]({{ site.repository }}/issues/1171))
@@ -668,6 +811,7 @@ prev_section: contributing
 - Allow for all options for Kramdown HTML Converter ([#1201]({{ site.repository }}/issues/1201))
 
 ### Bug Fixes
+{: #bug-fixes-v1-1-0}
 - Fix pagination in subdirectories. ([#1198]({{ site.repository }}/issues/1198))
 - Fix an issue with directories and permalinks that have a plus sign
     (+) in them ([#1215]({{ site.repository }}/issues/1215))
@@ -675,6 +819,7 @@ prev_section: contributing
 - Latest posts first in non-LSI `related_posts` ([#1271]({{ site.repository }}/issues/1271))
 
 ### Development Fixes
+{: #development-fixes-v1-1-0}
 - Merge the theme and layout Cucumber steps into one step ([#1151]({{ site.repository }}/issues/1151))
 - Restrict activesupport dependency to pre-4.0.0 to maintain compatibility with `<= 1.9.2`
 - Include/exclude deprecation handling simplification ([#1284]({{ site.repository }}/issues/1284))
@@ -682,6 +827,7 @@ prev_section: contributing
 - Refactor Jekyll::Site ([#1144]({{ site.repository }}/issues/1144))
 
 ### Site Enhancements
+{: #site-enhancements-v1-1-0}
 - Add "News" section for release notes, along with an RSS feed ([#1093]({{ site.repository }}/issues/1093), [#1285]({{ site.repository }}/issues/1285), [#1286]({{ site.repository }}/issues/1286))
 - Add "History" page.
 - Restructured docs sections to include "Meta" section.
@@ -719,9 +865,12 @@ prev_section: contributing
 - Add information about time zones to the documentation for a page's
     date ([#1304]({{ site.repository }}/issues/1304))
 
+
 ## 1.0.3 / 2013-06-07
+{: #v1-0-3}
 
 ### Minor Enhancements
+{: #minor-enhancements-v1-0-3}
 - Add support to gist tag for private gists. ([#1189]({{ site.repository }}/issues/1189))
 - Fail loudly when Maruku errors out ([#1190]({{ site.repository }}/issues/1190))
 - Move the building of related posts into their own class ([#1057]({{ site.repository }}/issues/1057))
@@ -730,6 +879,7 @@ prev_section: contributing
 - Convert IDs in the site template to classes ([#1170]({{ site.repository }}/issues/1170))
 
 ### Bug Fixes
+{: #bug-fixes-v1-0-3}
 - Fix typo in Stevenson constant "ERROR". ([#1166]({{ site.repository }}/issues/1166))
 - Rename Jekyll::Logger to Jekyll::Stevenson to fix inheritance issue ([#1106]({{ site.repository }}/issues/1106))
 - Exit with a non-zero exit code when dealing with a Liquid error ([#1121]({{ site.repository }}/issues/1121))
@@ -740,6 +890,7 @@ prev_section: contributing
     ([#1156]({{ site.repository }}/issues/1156))
 
 ### Site Enhancements
+{: #site-enhancements-v1-0-3}
 - Add a Pro Tip to docs about front matter variables being optional ([#1147]({{ site.repository }}/issues/1147))
 - Add changelog to site as History page in /docs/ ([#1065]({{ site.repository }}/issues/1065))
 - Add note to Upgrading page about new config options in 1.0.x ([#1146]({{ site.repository }}/issues/1146))
@@ -759,59 +910,75 @@ prev_section: contributing
 - Add the Jekyll Gallery Plugin to the plugin list ([#1143]({{ site.repository }}/issues/1143))
 
 ### Development Fixes
+{: #development-fixes-v1-0-3}
 - Use Jekyll.logger instead of Jekyll::Stevenson to log things ([#1149]({{ site.repository }}/issues/1149))
 - Fix pesky Cucumber infinite loop ([#1139]({{ site.repository }}/issues/1139))
 - Do not write posts with timezones in Cucumber tests ([#1124]({{ site.repository }}/issues/1124))
 - Use ISO formatted dates in Cucumber features ([#1150]({{ site.repository }}/issues/1150))
 
+
 ## 1.0.2 / 2013-05-12
+{: #v1-0-2}
 
 ### Major Enhancements
+{: #major-enhancements-v1-0-2}
 - Add `jekyll doctor` command to check site for any known compatibility problems ([#1081]({{ site.repository }}/issues/1081))
 - Backwards-compatibilize relative permalinks ([#1081]({{ site.repository }}/issues/1081))
 
 ### Minor Enhancements
+{: #minor-enhancements-v1-0-2}
 - Add a `data-lang="<lang>"` attribute to Redcarpet code blocks ([#1066]({{ site.repository }}/issues/1066))
 - Deprecate old config `server_port`, match to `port` if `port` isn't set ([#1084]({{ site.repository }}/issues/1084))
 - Update pygments.rb version to 0.5.0 ([#1061]({{ site.repository }}/issues/1061))
 - Update Kramdown version to 1.0.2 ([#1067]({{ site.repository }}/issues/1067))
 
 ### Bug Fixes
+{: #bug-fixes-v1-0-2}
 - Fix issue when categories are numbers ([#1078]({{ site.repository }}/issues/1078))
 - Catching that Redcarpet gem isn't installed ([#1059]({{ site.repository }}/issues/1059))
 
 ### Site Enhancements
+{: #site-enhancements-v1-0-2}
 - Add documentation about `relative_permalinks` ([#1081]({{ site.repository }}/issues/1081))
 - Remove pygments-installation instructions, as pygments.rb is bundled with it ([#1079]({{ site.repository }}/issues/1079))
 - Move pages to be Pages for realz ([#985]({{ site.repository }}/issues/985))
 - Updated links to Liquid documentation ([#1073]({{ site.repository }}/issues/1073))
 
+
 ## 1.0.1 / 2013-05-08
+{: #v1-0-1}
 
 ### Minor Enhancements
+{: #minor-enhancements-v1-0-1}
 - Do not force use of `toc_token` when using `generate_tok` in RDiscount ([#1048]({{ site.repository }}/issues/1048))
 - Add newer `language-` class name prefix to code blocks ([#1037]({{ site.repository }}/issues/1037))
 - Commander error message now preferred over process abort with incorrect args ([#1040]({{ site.repository }}/issues/1040))
 
 ### Bug Fixes
+{: #bug-fixes-v1-0-1}
 - Make Redcarpet respect the pygments configuration option ([#1053]({{ site.repository }}/issues/1053))
 - Fix the index build with LSI ([#1045]({{ site.repository }}/issues/1045))
 - Don't print deprecation warning when no arguments are specified. ([#1041]({{ site.repository }}/issues/1041))
 - Add missing `</div>` to site template used by `new` subcommand, fixed typos in code ([#1032]({{ site.repository }}/issues/1032))
 
 ### Site Enhancements
+{: #site-enhancements-v1-0-1}
 - Changed https to http in the GitHub Pages link ([#1051]({{ site.repository }}/issues/1051))
 - Remove CSS cruft, fix typos, fix HTML errors ([#1028]({{ site.repository }}/issues/1028))
 - Removing manual install of Pip and Distribute ([#1025]({{ site.repository }}/issues/1025))
 - Updated URL for Markdown references plugin ([#1022]({{ site.repository }}/issues/1022))
 
 ### Development Fixes
+{: #development-fixes-v1-0-1}
 - Markdownify history file ([#1027]({{ site.repository }}/issues/1027))
 - Update links on README to point to new jekyllrb.com ([#1018]({{ site.repository }}/issues/1018))
 
+
 ## 1.0.0 / 2013-05-06
+{: #v1-0-0}
 
 ### Major Enhancements
+{: #major-enhancements-v1-0-0}
 - Add `jekyll new` subcommand: generate a Jekyll scaffold ([#764]({{ site.repository }}/issues/764))
 - Refactored Jekyll commands into subcommands: build, serve, and migrate. ([#690]({{ site.repository }}/issues/690))
 - Removed importers/migrators from main project, migrated to jekyll-import sub-gem ([#793]({{ site.repository }}/issues/793))
@@ -819,6 +986,7 @@ prev_section: contributing
 - Add ordinal date permalink style (/:categories/:year/:y_day/:title.html) ([#928]({{ site.repository }}/issues/928))
 
 ### Minor Enhancements
+{: #minor-enhancements-v1-0-0}
 - Site template HTML5-ified ([#964]({{ site.repository }}/issues/964))
 - Use post's directory path when matching for the `post_url` tag ([#998]({{ site.repository }}/issues/998))
 - Loosen dependency on Pygments so it's only required when it's needed ([#1015]({{ site.repository }}/issues/1015))
@@ -893,6 +1061,7 @@ prev_section: contributing
 - Prevent custom destination from causing continuous regen on watch ([#528]({{ site.repository }}/issues/528), [#820]({{ site.repository }}/issues/820), [#862]({{ site.repository }}/issues/862))
 
 ### Site Enhancements
+{: #site-enhancements-v1-0-0}
 - Responsify ([#860]({{ site.repository }}/issues/860))
 - Fix spelling, punctuation and phrasal errors ([#989]({{ site.repository }}/issues/989))
 - Update quickstart instructions with `new` command ([#966]({{ site.repository }}/issues/966))
@@ -903,6 +1072,7 @@ prev_section: contributing
 - Redesigned site ([#583]({{ site.repository }}/issues/583))
 
 ### Development Fixes
+{: #development-fixes-v1-0-0}
 - Exclude Cucumber 1.2.4, which causes tests to fail in 1.9.2 ([#938]({{ site.repository }}/issues/938))
 - Added "features:html" rake task for debugging purposes, cleaned up
       Cucumber profiles ([#832]({{ site.repository }}/issues/832))
@@ -914,18 +1084,24 @@ prev_section: contributing
       of greater than 1.9 ([#771]({{ site.repository }}/issues/771))
 - Switch to Simplecov for coverage report ([#765]({{ site.repository }}/issues/765))
 
+
 ## 0.12.1 / 2013-02-19
+{: #v0-12-1}
 
 ### Minor Enhancements
+{: #minor-enhancements-v0-12-1}
 - Update Kramdown version to 0.14.1 ([#744]({{ site.repository }}/issues/744))
 - Test Enhancements
 - Update Rake version to 10.0.3 ([#744]({{ site.repository }}/issues/744))
 - Update Shoulda version to 3.3.2 ([#744]({{ site.repository }}/issues/744))
 - Update Redcarpet version to 2.2.2 ([#744]({{ site.repository }}/issues/744))
 
+
 ## 0.12.0 / 2012-12-22
+{: #v0-12-0}
 
 ### Minor Enhancements
+{: #minor-enhancements-v0-12-0}
 - Add ability to explicitly specify included files ([#261]({{ site.repository }}/issues/261))
 - Add `--default-mimetype` option ([#279]({{ site.repository }}/issues/279))
 - Allow setting of RedCloth options ([#284]({{ site.repository }}/issues/284))
@@ -944,24 +1120,32 @@ prev_section: contributing
 - Allow setting of Kramdown `smart_quotes` ([#482]({{ site.repository }}/issues/482))
 - Ensure front-matter is at start of file ([#562]({{ site.repository }}/issues/562))
 
+
 ## 0.11.2 / 2011-12-27
+{: #v0-11-2}
 - Bug Fixes
 - Fix gemspec
 
+
 ## 0.11.1 / 2011-12-27
+{: #v0-11-1}
 - Bug Fixes
 - Fix extra blank line in highlight blocks ([#409]({{ site.repository }}/issues/409))
 - Update dependencies
 
+
 ## 0.11.0 / 2011-07-10
+{: #v0-11-0}
 
 ### Major Enhancements
+{: #major-enhancements-v0-11-0}
 - Add command line importer functionality ([#253]({{ site.repository }}/issues/253))
 - Add Redcarpet Markdown support ([#318]({{ site.repository }}/issues/318))
 - Make markdown/textile extensions configurable ([#312]({{ site.repository }}/issues/312))
 - Add `markdownify` filter
 
 ### Minor Enhancements
+{: #minor-enhancements-v0-11-0}
 - Switch to Albino gem
 - Bundler support
 - Use English library to avoid hoops ([#292]({{ site.repository }}/issues/292))
@@ -974,22 +1158,30 @@ prev_section: contributing
 - Bug Fixes
 - Secure additional path exploits
 
+
 ## 0.10.0 / 2010-12-16
+{: #v0-10-0}
 - Bug Fixes
 - Add `--no-server` option.
 
+
 ## 0.9.0 / 2010-12-15
+{: #v0-9-0}
 
 ### Minor Enhancements
+{: #minor-enhancements-v0-9-0}
 - Use OptionParser's `[no-]` functionality for better boolean parsing.
 - Add Drupal migrator ([#245]({{ site.repository }}/issues/245))
 - Complain about YAML and Liquid errors ([#249]({{ site.repository }}/issues/249))
 - Remove orphaned files during regeneration ([#247]({{ site.repository }}/issues/247))
 - Add Marley migrator ([#28]({{ site.repository }}/issues/28))
 
+
 ## 0.8.0 / 2010-11-22
+{: #v0-8-0}
 
 ### Minor Enhancements
+{: #minor-enhancements-v0-8-0}
 - Add wordpress.com importer ([#207]({{ site.repository }}/issues/207))
 - Add `--limit-posts` cli option ([#212]({{ site.repository }}/issues/212))
 - Add `uri_escape` filter ([#234]({{ site.repository }}/issues/234))
@@ -1001,28 +1193,38 @@ prev_section: contributing
 - Set mode to UTF8 on Sequel connections ([#237]({{ site.repository }}/issues/237))
 - Prevent `_includes` dir from being a symlink
 
+
 ## 0.7.0 / 2010-08-24
+{: #v0-7-0}
 
 ### Minor Enhancements
+{: #minor-enhancements-v0-7-0}
 - Add support for rdiscount extensions ([#173]({{ site.repository }}/issues/173))
 - Bug Fixes
 - Highlight should not be able to render local files
 - The site configuration may not always provide a 'time' setting ([#184]({{ site.repository }}/issues/184))
 
+
 ## 0.6.2 / 2010-06-25
+{: #v0-6-2}
 - Bug Fixes
 - Fix Rakefile 'release' task (tag pushing was missing origin)
 - Ensure that RedCloth is loaded when textilize filter is used ([#183]({{ site.repository }}/issues/183))
 - Expand source, destination, and plugin paths ([#180]({{ site.repository }}/issues/180))
 - Fix `page.url` to include full relative path ([#181]({{ site.repository }}/issues/181))
 
+
 ## 0.6.1 / 2010-06-24
+{: #v0-6-1}
 - Bug Fixes
 - Fix Markdown Pygments prefix and suffix ([#178]({{ site.repository }}/issues/178))
 
+
 ## 0.6.0 / 2010-06-23
+{: #v0-6-0}
 
 ### Major Enhancements
+{: #major-enhancements-v0-6-0}
 - Proper plugin system ([#19]({{ site.repository }}/issues/19), [#100]({{ site.repository }}/issues/100))
 - Add safe mode so unsafe converters/generators can be added
 - Maruku is now the only processor dependency installed by default.
@@ -1030,6 +1232,7 @@ prev_section: contributing
       user to install them when necessary) ([#57]({{ site.repository }}/issues/57))
 
 ### Minor Enhancements
+{: #minor-enhancements-v0-6-0}
 - Inclusion/exclusion of future dated posts ([#59]({{ site.repository }}/issues/59))
 - Generation for a specific time ([#59]({{ site.repository }}/issues/59))
 - Allocate `site.time` on render not per site_payload invocation ([#59]({{ site.repository }}/issues/59))
@@ -1048,9 +1251,12 @@ prev_section: contributing
 - Preserve generated attributes over front matter ([#119]({{ site.repository }}/issues/119))
 - Fix source directory binding using `Dir.pwd` ([#75]({{ site.repository }}/issues/75))
 
+
 ## 0.5.7 / 2010-01-12
+{: #v0-5-7}
 
 ### Minor Enhancements
+{: #minor-enhancements-v0-5-7}
 - Allow overriding of post date in the front matter ([#62]({{ site.repository }}/issues/62), [#38]({{ site.repository }}/issues/38))
 - Bug Fixes
 - Categories isn't always an array ([#73]({{ site.repository }}/issues/73))
@@ -1060,36 +1266,48 @@ prev_section: contributing
 - Cucumber features no longer use site.posts.first where a better
       alternative is available
 
+
 ## 0.5.6 / 2010-01-08
+{: #v0-5-6}
 - Bug Fixes
 - Require redcloth >= 4.2.1 in tests ([#92]({{ site.repository }}/issues/92))
 - Don't break on triple dashes in yaml frontmatter ([#93]({{ site.repository }}/issues/93))
 
 ### Minor Enhancements
+{: #minor-enhancements-v0-5-6}
 - Allow .mkd as markdown extension
 - Use $stdout/err instead of constants ([#99]({{ site.repository }}/issues/99))
 - Properly wrap code blocks ([#91]({{ site.repository }}/issues/91))
 - Add javascript mime type for webrick ([#98]({{ site.repository }}/issues/98))
 
+
 ## 0.5.5 / 2010-01-08
+{: #v0-5-5}
 - Bug Fixes
 - Fix pagination % 0 bug ([#78]({{ site.repository }}/issues/78))
 - Ensure all posts are processed first ([#71]({{ site.repository }}/issues/71))
 
+
 ## NOTE
 - After this point I will no longer be giving credit in the history;
     that is what the commit log is for.
 
+
 ## 0.5.4 / 2009-08-23
+{: #v0-5-4}
 - Bug Fixes
 - Do not allow symlinks (security vulnerability)
 
+
 ## 0.5.3 / 2009-07-14
+{: #v0-5-3}
 - Bug Fixes
 - Solving the permalink bug where non-html files wouldn't work
       ([@jeffrydegrande](https://github.com/jeffrydegrande))
 
+
 ## 0.5.2 / 2009-06-24
+{: #v0-5-2}
 - Enhancements
 - Added --paginate option to the executable along with a paginator object
       for the payload ([@calavera](https://github.com/calavera))
@@ -1098,9 +1316,9 @@ prev_section: contributing
 - Configuration options set in config.yml are now available through the
       site payload ([@vilcans](https://github.com/vilcans))
 - Posts can now have an empty YAML front matter or none at all
-      ([@bahuvrihi](https://github.com/bahuvrihi))
+      (@ bahuvrihi)
 - Bug Fixes
-- Fixing Ruby 1.9 issue that requires to_s on the err object
+- Fixing Ruby 1.9 issue that requires `#to_s` on the err object
       ([@Chrononaut](https://github.com/Chrononaut))
 - Fixes for pagination and ordering posts on the same day ([@ujh](https://github.com/ujh))
 - Made pages respect permalinks style and permalinks in yml front matter
@@ -1110,13 +1328,16 @@ prev_section: contributing
 - Added trailing slash to pretty permalink style so Apache is happy
       ([@eugenebolshakov](https://github.com/eugenebolshakov))
 - Bad markdown processor in config fails sooner and with better message
-      ([@gcnovus](https://github.com/gcnovus))
+      (@ gcnovus)
 - Allow CRLFs in yaml frontmatter ([@juretta](https://github.com/juretta))
 - Added Date#xmlschema for Ruby versions < 1.9
 
+
 ## 0.5.1 / 2009-05-06
+{: #v0-5-1}
 
 ### Major Enhancements
+{: #major-enhancements-v0-5-1}
 - Next/previous posts in site payload ([@pantulis](https://github.com/pantulis), [@tomo](https://github.com/tomo))
 - Permalink templating system
 - Moved most of the README out to the GitHub wiki
@@ -1129,9 +1350,12 @@ prev_section: contributing
       after highlight ([@henrik](https://github.com/henrik))
 - CGI escaped post titles ([@Chrononaut](https://github.com/Chrononaut))
 
+
 ## 0.5.0 / 2009-04-07
+{: #v0-5-0}
 
 ### Minor Enhancements
+{: #minor-enhancements-v0-5-0}
 - Ability to set post categories via YAML ([@qrush](https://github.com/qrush))
 - Ability to set prevent a post from publishing via YAML ([@qrush](https://github.com/qrush))
 - Add textilize filter ([@willcodeforfoo](https://github.com/willcodeforfoo))
@@ -1148,19 +1372,25 @@ prev_section: contributing
 - Fix tests and convert to Shoulda ([@qrush](https://github.com/qrush), [@technicalpickles](https://github.com/technicalpickles))
 - Add Cucumber acceptance test suite ([@qrush](https://github.com/qrush), [@technicalpickles](https://github.com/technicalpickles))
 
+
 ## 0.4.1
 
 ### Minor Enhancements
+{: #minor-enhancements-v--}
 - Changed date format on wordpress converter (zeropadding) ([@dysinger](https://github.com/dysinger))
 - Bug Fixes
 - Add Jekyll binary as executable to gemspec ([@dysinger](https://github.com/dysinger))
 
+
 ## 0.4.0 / 2009-02-03
+{: #v0-4-0}
 
 ### Major Enhancements
+{: #major-enhancements-v0-4-0}
 - Switch to Jeweler for packaging tasks
 
 ### Minor Enhancements
+{: #minor-enhancements-v0-4-0}
 - Type importer ([@codeslinger](https://github.com/codeslinger))
 - `site.topics` accessor ([@baz](https://github.com/baz))
 - Add `array_to_sentence_string` filter ([@mchung](https://github.com/mchung))
@@ -1176,13 +1406,17 @@ prev_section: contributing
 - Test and fix the site.categories hash ([@zzot](https://github.com/zzot))
 - Fix site payload available to files ([@matrix9180](https://github.com/matrix9180))
 
+
 ## 0.3.0 / 2008-12-24
+{: #v0-3-0}
 
 ### Major Enhancements
+{: #major-enhancements-v0-3-0}
 - Added `--server` option to start a simple WEBrick server on destination
       directory ([@johnreilly](https://github.com/johnreilly) and [@mchung](https://github.com/mchung))
 
 ### Minor Enhancements
+{: #minor-enhancements-v0-3-0}
 - Added post categories based on directories containing `_posts` ([@mreid](https://github.com/mreid))
 - Added post topics based on directories underneath `_posts`
 - Added new date filter that shows the full month name ([@mreid](https://github.com/mreid))
@@ -1195,39 +1429,54 @@ prev_section: contributing
       templates ([@mreid](https://github.com/mreid))
 - Properly reject directories in `_layouts`
 
+
 ## 0.2.1 / 2008-12-15
+{: #v0-2-1}
 - Major Changes
 - Use Maruku (pure Ruby) for Markdown by default ([@mreid](https://github.com/mreid))
 - Allow use of RDiscount with `--rdiscount` flag
 
 ### Minor Enhancements
+{: #minor-enhancements-v0-2-1}
 - Don't load directory_watcher unless it's needed ([@pjhyett](https://github.com/pjhyett))
 
+
 ## 0.2.0 / 2008-12-14
+{: #v0-2-0}
 - Major Changes
 - related_posts is now found in `site.related_posts`
 
+
 ## 0.1.6 / 2008-12-13
+{: #v0-1-6}
 - Major Features
 - Include files in `_includes` with {% raw %}`{% include x.textile %}`{% endraw %}
 
+
 ## 0.1.5 / 2008-12-12
+{: #v0-1-5}
 
 ### Major Enhancements
+{: #major-enhancements-v0-1-5}
 - Code highlighting with Pygments if `--pygments` is specified
 - Disable true LSI by default, enable with `--lsi`
 
 ### Minor Enhancements
+{: #minor-enhancements-v0-1-5}
 - Output informative message if RDiscount is not available ([@JackDanger](https://github.com/JackDanger))
 - Bug Fixes
 - Prevent Jekyll from picking up the output directory as a source ([@JackDanger](https://github.com/JackDanger))
 - Skip `related_posts` when there is only one post ([@JackDanger](https://github.com/JackDanger))
 
+
 ## 0.1.4 / 2008-12-08
+{: #v0-1-4}
 - Bug Fixes
 - DATA does not work properly with rubygems
 
+
 ## 0.1.3 / 2008-12-06
+{: #v0-1-3}
 - Major Features
 - Markdown support ([@vanpelt](https://github.com/vanpelt))
 - Mephisto and CSV converters ([@vanpelt](https://github.com/vanpelt))
@@ -1236,22 +1485,30 @@ prev_section: contributing
 - Bug Fixes
 - Accept both `\r\n` and `\n` in YAML header ([@vanpelt](https://github.com/vanpelt))
 
+
 ## 0.1.2 / 2008-11-22
+{: #v0-1-2}
 - Major Features
 - Add a real "related posts" implementation using Classifier
 - Command Line Changes
 - Allow cli to be called with 0, 1, or 2 args intuiting dir paths
       if they are omitted
 
+
 ## 0.1.1 / 2008-11-22
+{: #v0-1-1}
 - Minor Additions
 - Posts now support introspectional data e.g. {% raw %}`{{ page.url }}`{% endraw %}
 
+
 ## 0.1.0 / 2008-11-05
+{: #v0-1-0}
 - First release
 - Converts posts written in Textile
 - Converts regular site pages
 - Simple copy of binary files
 
+
 ## 0.0.0 / 2008-10-19
+{: #v0-0-0}
 - Birthday!