jekyll 1.0.4 → 1.1.1

data/site/docs/configuration.md

@@ -236,7 +236,16 @@ before your site is served.
 
 Jekyll runs with the following configuration options by default. Unless
 alternative settings for these options are explicitly specified in the
-configuration file or on the command-line, Jekyll will run using these options.
+[[configuration]] file or on the command-line, Jekyll will run using these options.
+
+<div class="note warning">
+  <h5>There are two unsupported kramdown options</h5>
+  <p>
+    Please note that both remove_block_html_tags and
+    remove_span_html_tags are currently unsupported in jekyll due to the
+    fact that they are not included within the kramdown HTML converter.
+  </p>
+</div>
 
 {% highlight yaml %}
 source:      .

data/site/docs/contributing.md

@@ -1,8 +1,8 @@
 ---
 layout: docs
 title: Contributing
-prev_section: deployment-methods
-next_section: troubleshooting
+prev_section: upgrading
+next_section: history
 permalink: /docs/contributing/
 ---
 
@@ -19,7 +19,7 @@ following in mind:
   directory would be appreciated, and once merged it will also appear in
   the next update of the main site.
 * If your contribution adds or changes any Jekyll behavior, make sure to update
-  the documentation. It lives in `site/_posts`. If the docs are missing
+  the documentation. It lives in `site/docs`. If the docs are missing
   information, please feel free to add it in. Great docs make a great project!
 * Please follow the [GitHub Ruby Styleguide](https://github.com/styleguide/ruby)
   when modifying Ruby code.
@@ -82,6 +82,24 @@ git push origin my_awesome_feature
 * Create a pull request against mojombo/jekyll and describe what your change
   does and the why you think it should be merged.
 
+Updating Documentation
+----------------------
+
+We want the Jekyll documentation to be the best it can be. We've
+open-sourced our docs and we welcome any pull requests if you find it
+lacking.
+
+You can find the documentation for jekyllrb.com in the
+[site](https://github.com/mojombo/jekyll/tree/master/site) directory of
+Jekyll's repo on GitHub.com.
+
+All documentation pull requests should be directed at `master`.  Pull
+requests directed at another branch will not be accepted.
+
+The [Jekyll wiki](https://github.com/mojombo/jekyll/wiki) on GitHub 
+can be freely updated without a pull request as all 
+GitHub users have access.
+
 Gotchas
 -------
 

data/site/docs/deployment-methods.md

@@ -2,7 +2,7 @@
 layout: docs
 title: Deployment methods
 prev_section: github-pages
-next_section: contributing
+next_section: troubleshooting
 permalink: /docs/deployment-methods/
 ---
 
@@ -97,7 +97,7 @@ If you want to maintain Jekyll inside your existing Rails app, [Jekyll-Admin](ht
 ## Amazon S3
 
 If you want to host your site in Amazon S3, you can do so with
-[jekyll-s3](https://github.com/laurilehmijoki/jekyll-s3) application. It will
+[s3_website](https://github.com/laurilehmijoki/s3_website) application. It will
 push your site to Amazon S3 where it can be served like any web server,
 dynamically scaling to almost unlimited traffic. This approach has the
 benefit of being about the cheapest hosting option available for

data/site/docs/drafts.md

@@ -0,0 +1,20 @@
+---
+layout: docs
+title: Working with drafts
+permalink: /docs/drafts/
+---
+
+Drafts are posts without a date. They're posts you're still working on and don't want to
+publish yet. To get up and running with drafts, create a `_drafts` folder in your site's
+root (as described in the [site structure](/docs/structure/) section) and create your
+first draft:
+
+{% highlight text %}
+|-- _drafts/
+|   |-- a-draft-post.md
+{% endhighlight %}
+
+To preview your site with drafts, simply run `jekyll serve` or `jekyll build` with
+the `--drafts` switch.  Each will be assigned the value of `Time.now`
+for its date, and thus you will see them generated as the latest posts.
+

data/site/docs/extras.md

@@ -19,17 +19,38 @@ fork](http://github.com/remi/maruku).
 ## RDiscount
 
 If you prefer to use [RDiscount](http://github.com/rtomayko/rdiscount) instead
-of [Maruku](http://maruku.rubyforge.org/) for markdown, just make sure you have
+of [Maruku](http://github.com/bhollis/maruku) for Markdown, just make sure you have
 it installed:
 
 {% highlight bash %}
-$ sudo gem install rdiscount
+$ [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 bash %}
+{% 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).

data/site/docs/github-pages.md

@@ -54,6 +54,31 @@ actual software project for Jekyll, however the Jekyll website (that you’re
 looking at right now) is contained in the [gh-pages
 branch](https://github.com/mojombo/jekyll/tree/gh-pages) of the same repository.
 
+### Project Page URL Structure
+
+Sometimes it's nice to preview your Jekyll site before you push your `gh-pages`
+branch to GitHub. However, the subdirectory-like URL structure GitHub uses for
+Project Pages complicates the proper resolution of URLs. Here is an approach to
+utilizing the GitHub Project Page URL structure (`username.github.io/project-name/`)
+whilst maintaining the ability to preview your Jekyll site locally.
+
+1. In `_config.yml`, set the `baseurl` option to `/project-name` -- note the
+   leading slash and the **absence** of a trailing slash.
+2. When referencing JS or CSS files, do it like this:
+   `{% raw %}{{ site.baseurl}}/path/to/css.css{% endraw %}` -- note the slash
+   immediately following the variable (just before "path").
+3. When doing permalinks or internal links, do it like this:
+   `{% raw %}{{ site.baseurl }}{{ post.url }}{% endraw %}` -- note that there
+   is **no** slash between the two variables.
+4. Finally, if you'd like to preview your site before committing/deploying using
+   `jekyll serve`, be sure to pass an **empty string** to the `--baseurl` option,
+   so that you can view everything at `localhost:4000` normally (without
+   `/project-name` at the beginning): `jekyll serve --baseurl ''`
+
+This way you can preview your site locally from the site root on localhost,
+but when GitHub generates your pages from the gh-pages branch all the URLs
+will start with `/project-name` and resolve properly.
+
 <div class="note">
   <h5>GitHub Pages Documentation, Help, and Support</h5>
   <p>

data/site/docs/history.md

@@ -2,18 +2,93 @@
 layout: docs
 title: History
 permalink: /docs/history/
-prev_section: upgrading
+prev_section: contributing
 ---
 
-## HEAD
+## 1.1.0 / 2013-07-14
+
 ### Major Enhancements
+- Add `docs` subcommand to read Jekyll's docs when offline. ([#1046](https://github.com/mojombo/jekyll/issues/1046))
+- Support passing parameters to templates in `include` tag ([#1204](https://github.com/mojombo/jekyll/issues/1204))
+- Add support for Liquid tags to post excerpts ([#1302](https://github.com/mojombo/jekyll/issues/1302))
+
+### Minor Enhancements
+- Search the hierarchy of pagination path up to site root to determine template page for
+    pagination. ([#1198](https://github.com/mojombo/jekyll/issues/1198))
+- Add the ability to generate a new Jekyll site without a template ([#1171](https://github.com/mojombo/jekyll/issues/1171))
+- Use redcarpet as the default markdown engine in newly generated
+    sites ([#1245](https://github.com/mojombo/jekyll/issues/1245), [#1247](https://github.com/mojombo/jekyll/issues/1247))
+- Add `redcarpet` as a runtime dependency so `jekyll build` works out-of-the-box for new
+    sites. ([#1247](https://github.com/mojombo/jekyll/issues/1247))
+- In the generated site, remove files that will be replaced by a
+    directory ([#1118](https://github.com/mojombo/jekyll/issues/1118))
+- Fail loudly if a user-specified configuration file doesn't exist ([#1098](https://github.com/mojombo/jekyll/issues/1098))
+- Allow for all options for Kramdown HTML Converter ([#1201](https://github.com/mojombo/jekyll/issues/1201))
+
+### Bug Fixes
+- Fix pagination in subdirectories. ([#1198](https://github.com/mojombo/jekyll/issues/1198))
+- Fix an issue with directories and permalinks that have a plus sign
+    (+) in them ([#1215](https://github.com/mojombo/jekyll/issues/1215))
+- Provide better error reporting when generating sites ([#1253](https://github.com/mojombo/jekyll/issues/1253))
+- Latest posts first in non-LSI `related_posts` ([#1271](https://github.com/mojombo/jekyll/issues/1271))
+
+### Development Fixes
+- Merge the theme and layout cucumber steps into one step ([#1151](https://github.com/mojombo/jekyll/issues/1151))
+- Restrict activesupport dependency to pre-4.0.0 to maintain compatibility with `<= 1.9.2`
+- Include/exclude deprecation handling simplification ([#1284](https://github.com/mojombo/jekyll/issues/1284))
+- Convert README to Markdown. ([#1267](https://github.com/mojombo/jekyll/issues/1267))
+- Refactor Jekyll::Site ([#1144](https://github.com/mojombo/jekyll/issues/1144))
+
+### Site Enhancements
+- Add "News" section for release notes, along with an RSS feed ([#1093](https://github.com/mojombo/jekyll/issues/1093), [#1285](https://github.com/mojombo/jekyll/issues/1285), [#1286](https://github.com/mojombo/jekyll/issues/1286))
+- Add "History" page.
+- Restructured docs sections to include "Meta" section.
+- Add message to "Templates" page that specifies that Python must be installed in order
+    to use Pygments. ([#1182](https://github.com/mojombo/jekyll/issues/1182))
+- Update link to the official Maruku repo ([#1175](https://github.com/mojombo/jekyll/issues/1175))
+- Add documentation about `paginate_path` to "Templates" page in docs ([#1129](https://github.com/mojombo/jekyll/issues/1129))
+- Give the quick-start guide its own page ([#1191](https://github.com/mojombo/jekyll/issues/1191))
+- Update ProTip on Installation page in docs to point to all the info about Pygments and
+    the 'highlight' tag. ([#1196](https://github.com/mojombo/jekyll/issues/1196))
+- Run `site/img` through ImageOptim (thanks [@qrush](https://github.com/qrush)!) ([#1208](https://github.com/mojombo/jekyll/issues/1208))
+- Added Jade Converter to `site/docs/plugins` ([#1210](https://github.com/mojombo/jekyll/issues/1210))
+- Fix location of docs pages in Contributing pages ([#1214](https://github.com/mojombo/jekyll/issues/1214))
+- Add ReadInXMinutes plugin to the plugin list ([#1222](https://github.com/mojombo/jekyll/issues/1222))
+- Remove plugins from the plugin list that have equivalents in Jekyll
+    proper ([#1223](https://github.com/mojombo/jekyll/issues/1223))
+- Add jekyll-assets to the plugin list ([#1225](https://github.com/mojombo/jekyll/issues/1225))
+- Add jekyll-pandoc-mulitple-formats to the plugin list ([#1229](https://github.com/mojombo/jekyll/issues/1229))
+- Remove dead link to "Using Git to maintain your blog" ([#1227](https://github.com/mojombo/jekyll/issues/1227))
+- Tidy up the third-party plugins listing ([#1228](https://github.com/mojombo/jekyll/issues/1228))
+- Update contributor information ([#1192](https://github.com/mojombo/jekyll/issues/1192))
+- Update URL of article about Blogger migration ([#1242](https://github.com/mojombo/jekyll/issues/1242))
+- Specify that RedCarpet is the default for new Jekyll sites on Quickstart page ([#1247](https://github.com/mojombo/jekyll/issues/1247))
+- Added site.pages to Variables page in docs ([#1251](https://github.com/mojombo/jekyll/issues/1251))
+- Add Youku and Tudou Embed link on Plugins page. ([#1250](https://github.com/mojombo/jekyll/issues/1250))
+- Add note that `gist` tag supports private gists. ([#1248](https://github.com/mojombo/jekyll/issues/1248))
+- Add `jekyll-timeago` to list of third-party plugins. ([#1260](https://github.com/mojombo/jekyll/issues/1260))
+- Add `jekyll-swfobject` to list of third-party plugins. ([#1263](https://github.com/mojombo/jekyll/issues/1263))
+- Add `jekyll-picture-tag` to list of third-party plugins. ([#1280](https://github.com/mojombo/jekyll/issues/1280))
+- Update the GitHub Pages documentation regarding relative URLs
+    ([#1291](https://github.com/mojombo/jekyll/issues/1291))
+- Update the S3 deployment documentation ([#1294](https://github.com/mojombo/jekyll/issues/1294))
+- Add suggestion for Xcode CLT install to troubleshooting page in docs ([#1296](https://github.com/mojombo/jekyll/issues/1296))
+- Add 'Working with drafts' page to docs ([#1289](https://github.com/mojombo/jekyll/issues/1289))
+- Add information about time zones to the documentation for a page's
+    date ([#1304](https://github.com/mojombo/jekyll/issues/1304))
+
+## 1.0.3 / 2013-06-07
 
 ### Minor Enhancements
+- Add support to gist tag for private gists. ([#1189](https://github.com/mojombo/jekyll/issues/1189))
+- Fail loudly when MaRuKu errors out ([#1190](https://github.com/mojombo/jekyll/issues/1190))
 - Move the building of related posts into their own class ([#1057](https://github.com/mojombo/jekyll/issues/1057))
 - Removed trailing spaces in several places throughout the code ([#1116](https://github.com/mojombo/jekyll/issues/1116))
 - Add a `--force` option to `jekyll new` ([#1115](https://github.com/mojombo/jekyll/issues/1115))
+- Convert IDs in the site template to classes ([#1170](https://github.com/mojombo/jekyll/issues/1170))
 
 ### Bug Fixes
+- Fix typo in Stevenson constant "ERROR". ([#1166](https://github.com/mojombo/jekyll/issues/1166))
 - Rename Jekyll::Logger to Jekyll::Stevenson to fix inheritance issue ([#1106](https://github.com/mojombo/jekyll/issues/1106))
 - Exit with a non-zero exit code when dealing with a Liquid error ([#1121](https://github.com/mojombo/jekyll/issues/1121))
 - Make the `exclude` and `include` options backwards compatible with
@@ -23,6 +98,9 @@ prev_section: upgrading
     ([#1156](https://github.com/mojombo/jekyll/issues/1156))
 
 ### Site Enhancements
+- Add a Pro Tip to docs about front matter variables being optional ([#1147](https://github.com/mojombo/jekyll/issues/1147))
+- Add changelog to site as History page in /docs/ ([#1065](https://github.com/mojombo/jekyll/issues/1065))
+- Add note to Upgrading page about new config options in 1.0.x ([#1146](https://github.com/mojombo/jekyll/issues/1146))
 - Documentation for `date_to_rfc822` and `uri_escape` ([#1142](https://github.com/mojombo/jekyll/issues/1142))
 - Documentation highlight boxes shouldn't show scrollbars if not necessary ([#1123](https://github.com/mojombo/jekyll/issues/1123))
 - Add link to jekyll-minibundle in the doc's plugins list ([#1035](https://github.com/mojombo/jekyll/issues/1035))
@@ -39,8 +117,10 @@ prev_section: upgrading
 - Add the Jekyll Gallery Plugin to the plugin list ([#1143](https://github.com/mojombo/jekyll/issues/1143))
 
 ### Development Fixes
+- Use Jekyll.logger instead of Jekyll::Stevenson to log things ([#1149](https://github.com/mojombo/jekyll/issues/1149))
 - Fix pesky Cucumber infinite loop ([#1139](https://github.com/mojombo/jekyll/issues/1139))
 - Do not write posts with timezones in Cucumber tests ([#1124](https://github.com/mojombo/jekyll/issues/1124))
+- Use ISO formatted dates in Cucumber features ([#1150](https://github.com/mojombo/jekyll/issues/1150))
 
 ## 1.0.2 / 2013-05-12
 
@@ -163,7 +243,7 @@ prev_section: upgrading
 - Fixed Page#dir and Page#url for edge cases ([#536](https://github.com/mojombo/jekyll/issues/536))
 - Fix broken post_url with posts with a time in their YAML Front-Matter ([#831](https://github.com/mojombo/jekyll/issues/831))
 - Look for plugins under the source directory ([#654](https://github.com/mojombo/jekyll/issues/654))
-- Tumblr Migrator: finds _posts dir correctly, fixes truncation of long
+- Tumblr Migrator: finds `_posts` dir correctly, fixes truncation of long
       post names ([#775](https://github.com/mojombo/jekyll/issues/775))
 - Force Categories to be Strings ([#767](https://github.com/mojombo/jekyll/issues/767))
 - Safe YAML plugin to prevent vulnerability ([#777](https://github.com/mojombo/jekyll/issues/777))
@@ -255,7 +335,7 @@ prev_section: upgrading
 
 ## 0.9.0 / 2010-12-15
 ### Minor Enhancements
-- Use OptionParser's [no-] functionality for better boolean parsing.
+- Use OptionParser's `[no-]` functionality for better boolean parsing.
 - Add Drupal migrator ([#245](https://github.com/mojombo/jekyll/issues/245))
 - Complain about YAML and Liquid errors ([#249](https://github.com/mojombo/jekyll/issues/249))
 - Remove orphaned files during regeneration ([#247](https://github.com/mojombo/jekyll/issues/247))
@@ -272,7 +352,7 @@ prev_section: upgrading
 - Bug Fixes
 - Fixed filename basename generation ([#208](https://github.com/mojombo/jekyll/issues/208))
 - Set mode to UTF8 on Sequel connections ([#237](https://github.com/mojombo/jekyll/issues/237))
-- Prevent _includes dir from being a symlink
+- Prevent `_includes` dir from being a symlink
 
 ## 0.7.0 / 2010-08-24
 ### Minor Enhancements
@@ -357,129 +437,116 @@ prev_section: upgrading
 ## 0.5.3 / 2009-07-14
 - Bug Fixes
 - Solving the permalink bug where non-html files wouldn't work
-      [github.com/jeffrydegrande]
+      ([@jeffrydegrande](https://github.com/jeffrydegrande))
 
 ## 0.5.2 / 2009-06-24
 - Enhancements
 - Added --paginate option to the executable along with a paginator object
-      for the payload [github.com/calavera]
-- Upgraded RedCloth to 4.2.1, which makes <notextile> tags work once
+      for the payload ([@calavera](https://github.com/calavera))
+- Upgraded RedCloth to 4.2.1, which makes `<notextile>` tags work once
       again.
 - Configuration options set in config.yml are now available through the
-      site payload [github.com/vilcans]
+      site payload ([@vilcans](https://github.com/vilcans))
 - Posts can now have an empty YAML front matter or none at all
-      [github.com/bahuvrihi]
+      ([@bahuvrihi](https://github.com/bahuvrihi))
 - Bug Fixes
 - Fixing Ruby 1.9 issue that requires to_s on the err object
-      [github.com/Chrononaut]
-- Fixes for pagination and ordering posts on the same day [github.com/ujh]
+      ([@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
-      [github.com/eugenebolshakov]
+      ([@eugenebolshakov](https://github.com/eugenebolshakov))
 - Index.html file should always have index.html permalink
-      [github.com/eugenebolshakov]
+      ([@eugenebolshakov](https://github.com/eugenebolshakov))
 - Added trailing slash to pretty permalink style so Apache is happy
-      [github.com/eugenebolshakov]
+      ([@eugenebolshakov](https://github.com/eugenebolshakov))
 - Bad markdown processor in config fails sooner and with better message
-      [github.com/gcnovus]
-- Allow CRLFs in yaml frontmatter [github.com/juretta]
+      ([@gcnovus](https://github.com/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
 ### Major Enhancements
-- Next/previous posts in site payload [github.com/pantulis,
-      github.com/tomo]
+- 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
 - Exclude option in configuration so specified files won't be brought over
-      with generated site [github.com/duritong]
+      with generated site ([@duritong](https://github.com/duritong))
 - Bug Fixes
 - Making sure config.yaml references are all gone, using only config.yml
-- Fixed syntax highlighting breaking for UTF-8 code [github.com/henrik]
+- Fixed syntax highlighting breaking for UTF-8 code ([@henrik](https://github.com/henrik))
 - Worked around RDiscount bug that prevents Markdown from getting parsed
-      after highlight [github.com/henrik]
-- CGI escaped post titles [github.com/Chrononaut]
+      after highlight ([@henrik](https://github.com/henrik))
+- CGI escaped post titles ([@Chrononaut](https://github.com/Chrononaut))
 
 ## 0.5.0 / 2009-04-07
 ### Minor Enhancements
-- Ability to set post categories via YAML [github.com/qrush]
-- Ability to set prevent a post from publishing via YAML
-      [github.com/qrush]
-- Add textilize filter [github.com/willcodeforfoo]
-- Add 'pretty' permalink style for wordpress-like urls
-      [github.com/dysinger]
-- Made it possible to enter categories from YAML as an array
-      [github.com/Chrononaut]
-- Ignore Emacs autosave files [github.com/Chrononaut]
+- 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))
+- Add 'pretty' permalink style for wordpress-like urls ([@dysinger](https://github.com/dysinger))
+- Made it possible to enter categories from YAML as an array ([@Chrononaut](https://github.com/Chrononaut))
+- Ignore Emacs autosave files ([@Chrononaut](https://github.com/Chrononaut))
 - Bug Fixes
-- Use block syntax of popen4 to ensure that subprocesses are properly
-      disposed [github.com/jqr]
-- Close open4 streams to prevent zombies [github.com/rtomayko]
-- Only query required fields from the WP Database [github.com/ariejan]
-- Prevent _posts from being copied to the destination directory
-      [github.com/bdimcheff]
+- Use block syntax of popen4 to ensure that subprocesses are properly disposed ([@jqr](https://github.com/jqr))
+- Close open4 streams to prevent zombies ([@rtomayko](https://github.com/rtomayko))
+- Only query required fields from the WP Database ([@ariejan](https://github.com/ariejan))
+- Prevent `_posts` from being copied to the destination directory ([@bdimcheff](https://github.com/bdimcheff))
 - Refactors
-- Factored the filtering code into a method [github.com/Chrononaut]
-- Fix tests and convert to Shoulda [github.com/qrush,
-      github.com/technicalpickles]
-- Add Cucumber acceptance test suite [github.com/qrush,
-      github.com/technicalpickles]
+- Factored the filtering code into a method ([@Chrononaut](https://github.com/Chrononaut))
+- 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
-- Changed date format on wordpress converter (zeropadding)
-      [github.com/dysinger]
+- Changed date format on wordpress converter (zeropadding) ([@dysinger](https://github.com/dysinger))
 - Bug Fixes
-- Add jekyll binary as executable to gemspec [github.com/dysinger]
+- Add jekyll binary as executable to gemspec ([@dysinger](https://github.com/dysinger))
 
 ## 0.4.0 / 2009-02-03
 ### Major Enhancements
 - Switch to Jeweler for packaging tasks
 
 ### Minor Enhancements
-- Type importer [github.com/codeslinger]
-- site.topics accessor [github.com/baz]
-- Add array_to_sentence_string filter [github.com/mchung]
-- Add a converter for textpattern [github.com/PerfectlyNormal]
-- Add a working Mephisto / MySQL converter [github.com/ivey]
-- Allowing .htaccess files to be copied over into the generated site
-      [github.com/briandoll]
-- Add option to not put file date in permalink URL [github.com/mreid]
-- Add line number capabilities to highlight blocks [github.com/jcon]
+- 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))
+- Add a converter for textpattern ([@PerfectlyNormal](https://github.com/PerfectlyNormal))
+- Add a working Mephisto / MySQL converter ([@ivey](https://github.com/ivey))
+- Allowing .htaccess files to be copied over into the generated site ([@briandoll](https://github.com/briandoll))
+- Add option to not put file date in permalink URL ([@mreid](https://github.com/mreid))
+- Add line number capabilities to highlight blocks ([@jcon](https://github.com/jcon))
 - Bug Fixes
-- Fix permalink behavior [github.com/cavalle]
-- Fixed an issue with pygments, markdown, and newlines
-      [github.com/zpinter]
-- Ampersands need to be escaped [github.com/pufuwozu, github.com/ap]
-- Test and fix the site.categories hash [github.com/zzot]
-- Fix site payload available to files [github.com/matrix9180]
+- Fix permalink behavior ([@cavalle](https://github.com/cavalle))
+- Fixed an issue with pygments, markdown, and newlines ([@zpinter](https://github.com/zpinter))
+- Ampersands need to be escaped ([@pufuwozu](https://github.com/pufuwozu), [@ap](https://github.com/ap))
+- 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
 ### Major Enhancements
 - Added --server option to start a simple WEBrick server on destination
-      directory [github.com/johnreilly and github.com/mchung]
+      directory ([@johnreilly](https://github.com/johnreilly) and [@mchung](https://github.com/mchung))
 
 ### Minor Enhancements
-- Added post categories based on directories containing _posts
-      [github.com/mreid]
-- Added post topics based on directories underneath _posts
-- Added new date filter that shows the full month name [github.com/mreid]
-- Merge Post's YAML front matter into its to_liquid payload
-      [github.com/remi]
-- Restrict includes to regular files underneath _includes
+- 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))
+- Merge Post's YAML front matter into its to_liquid payload ([@remi](https://github.com/remi))
+- Restrict includes to regular files underneath `_includes`
 - Bug Fixes
 - Change YAML delimiter matcher so as to not chew up 2nd level markdown
-      headers [github.com/mreid]
+      headers ([@mreid](https://github.com/mreid))
 - Fix bug that meant page data (such as the date) was not available in
-      templates [github.com/mreid]
-- Properly reject directories in _layouts
+      templates ([@mreid](https://github.com/mreid))
+- Properly reject directories in `_layouts`
 
 ## 0.2.1 / 2008-12-15
 - Major Changes
-- Use Maruku (pure Ruby) for Markdown by default [github.com/mreid]
+- Use Maruku (pure Ruby) for Markdown by default ([@mreid](https://github.com/mreid))
 - Allow use of RDiscount with --rdiscount flag
 
 ### Minor Enhancements
-- Don't load directory_watcher unless it's needed [github.com/pjhyett]
+- Don't load directory_watcher unless it's needed ([@pjhyett](https://github.com/pjhyett))
 
 ## 0.2.0 / 2008-12-14
 - Major Changes
@@ -487,7 +554,7 @@ prev_section: upgrading
 
 ## 0.1.6 / 2008-12-13
 - Major Features
-- Include files in _includes with {% include x.textile %}
+- Include files in `_includes` with {% raw %}`{% include x.textile %}`{% endraw %}
 
 ## 0.1.5 / 2008-12-12
 ### Major Enhancements
@@ -495,12 +562,10 @@ prev_section: upgrading
 - Disable true LSI by default, enable with --lsi
 
 ### Minor Enhancements
-- Output informative message if RDiscount is not available
-      [github.com/JackDanger]
+- 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
-      [github.com/JackDanger]
-- Skip related_posts when there is only one post [github.com/JackDanger]
+- 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
 - Bug Fixes
@@ -508,12 +573,12 @@ prev_section: upgrading
 
 ## 0.1.3 / 2008-12-06
 - Major Features
-- Markdown support [github.com/vanpelt]
-- Mephisto and CSV converters [github.com/vanpelt]
-- Code hilighting [github.com/vanpelt]
+- Markdown support ([@vanpelt](https://github.com/vanpelt))
+- Mephisto and CSV converters ([@vanpelt](https://github.com/vanpelt))
+- Code hilighting ([@vanpelt](https://github.com/vanpelt))
 - Autobuild
 - Bug Fixes
-- Accept both \r\n and \n in YAML header [github.com/vanpelt]
+- Accept both \r\n and \n in YAML header ([@vanpelt](https://github.com/vanpelt))
 
 ## 0.1.2 / 2008-11-22
 - Major Features
@@ -524,7 +589,7 @@ prev_section: upgrading
 
 ## 0.1.1 / 2008-11-22
 - Minor Additions
-- Posts now support introspectional data e.g. {{ page.url }}
+- Posts now support introspectional data e.g. {% raw %}`{{ page.url }}`{% endraw %}
 
 ## 0.1.0 / 2008-11-05
 - First release