From bcb88a4bc508e44a1f8db7ca6263b6304bd7fbda Mon Sep 17 00:00:00 2001 From: Parker Moore Date: Mon, 5 May 2014 03:00:00 -0400 Subject: [PATCH 01/11] Add Jekyll 2.0.0 release post. --- .../2014-05-05-jekyll-2-0-0-released.markdown | 25 +++++++++++++++++++ 1 file changed, 25 insertions(+) create mode 100644 site/_posts/2014-05-05-jekyll-2-0-0-released.markdown diff --git a/site/_posts/2014-05-05-jekyll-2-0-0-released.markdown b/site/_posts/2014-05-05-jekyll-2-0-0-released.markdown new file mode 100644 index 00000000..972adb5a --- /dev/null +++ b/site/_posts/2014-05-05-jekyll-2-0-0-released.markdown @@ -0,0 +1,25 @@ +--- +layout: news_item +title: 'Jekyll 2.0.0 Released' +date: 2014-05-05 02:50:09 -0400 +author: parkr +version: 2.0.0 +categories: [release] +--- + +It's here. After nearly 1,000 commits and about 5 months, the Jekyll team is excited to announce the release of Jekyll 2.0! Jam-packed with some [highly-requested features and bugfixes galore][changelog], this is the best Jekyll yet. Notable changes: + +1. [Collections](/docs/collections/) +2. Brand new site template for `jekyll new` (thanks [@jglovier][]!) +3. [Native Sass & CoffeeScript support](/docs/assets/) +4. [YAML Front-Matter defaults](/docs/configuration/#frontmatter_defaults) +5. Custom markdown processors +6. Addition of `where` and `sort_by` Liquid filters +7. Switch from Maruku to Kramdown as default markdown converter + +Check out our [changelog][] for a complete list of all (200+) changes. + +Happy developing! + +[changelog]: /docs/history/ +[@jglovier]: https://github.com/jglovier From 7f88f80d8e99f83943bea7dcc6de52f0674fa9fc Mon Sep 17 00:00:00 2001 From: Parker Moore Date: Mon, 5 May 2014 03:01:28 -0400 Subject: [PATCH 02/11] Add nostalgia. --- site/_posts/2014-05-05-jekyll-2-0-0-released.markdown | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/site/_posts/2014-05-05-jekyll-2-0-0-released.markdown b/site/_posts/2014-05-05-jekyll-2-0-0-released.markdown index 972adb5a..1d129383 100644 --- a/site/_posts/2014-05-05-jekyll-2-0-0-released.markdown +++ b/site/_posts/2014-05-05-jekyll-2-0-0-released.markdown @@ -7,7 +7,9 @@ version: 2.0.0 categories: [release] --- -It's here. After nearly 1,000 commits and about 5 months, the Jekyll team is excited to announce the release of Jekyll 2.0! Jam-packed with some [highly-requested features and bugfixes galore][changelog], this is the best Jekyll yet. Notable changes: +One year ago, [we release Jekyll 1.0.0][]. One year later, we present to you the next major version: Jekyll 2.0. + +Jam-packed with some [highly-requested features and bugfixes galore][changelog], this is the best Jekyll yet. Some notable changes: 1. [Collections](/docs/collections/) 2. Brand new site template for `jekyll new` (thanks [@jglovier][]!) From 491b3f8b1acff82fe92033f0f404aa09ce0893fa Mon Sep 17 00:00:00 2001 From: Parker Moore Date: Mon, 5 May 2014 03:05:37 -0400 Subject: [PATCH 03/11] Curse you, timezones. --- site/_posts/2014-05-05-jekyll-2-0-0-released.markdown | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/site/_posts/2014-05-05-jekyll-2-0-0-released.markdown b/site/_posts/2014-05-05-jekyll-2-0-0-released.markdown index 1d129383..c0386c5f 100644 --- a/site/_posts/2014-05-05-jekyll-2-0-0-released.markdown +++ b/site/_posts/2014-05-05-jekyll-2-0-0-released.markdown @@ -7,7 +7,7 @@ version: 2.0.0 categories: [release] --- -One year ago, [we release Jekyll 1.0.0][]. One year later, we present to you the next major version: Jekyll 2.0. +One year ago, [we released Jekyll 1.0.0][jekyll-1]. One year later, we present to you the next major version: Jekyll 2.0. Jam-packed with some [highly-requested features and bugfixes galore][changelog], this is the best Jekyll yet. Some notable changes: @@ -25,3 +25,4 @@ Happy developing! [changelog]: /docs/history/ [@jglovier]: https://github.com/jglovier +[jekyll-1]: {% post_url 2013-05-05-jekyll-1-0-0-released %} From fe696991461df0a08bc48335ee798e32a7bd6438 Mon Sep 17 00:00:00 2001 From: Parker Moore Date: Mon, 5 May 2014 13:33:18 -0400 Subject: [PATCH 04/11] Remove date, better title props @benbalter --- site/_posts/2014-05-05-jekyll-2-0-0-released.markdown | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/site/_posts/2014-05-05-jekyll-2-0-0-released.markdown b/site/_posts/2014-05-05-jekyll-2-0-0-released.markdown index c0386c5f..0c95f765 100644 --- a/site/_posts/2014-05-05-jekyll-2-0-0-released.markdown +++ b/site/_posts/2014-05-05-jekyll-2-0-0-released.markdown @@ -1,7 +1,6 @@ --- layout: news_item -title: 'Jekyll 2.0.0 Released' -date: 2014-05-05 02:50:09 -0400 +title: 'Jekyll turns 2.0.0' author: parkr version: 2.0.0 categories: [release] From 4c3c3a3f90e5c50dd3465a4aad58c38013bf9497 Mon Sep 17 00:00:00 2001 From: Parker Moore Date: Mon, 5 May 2014 13:33:23 -0400 Subject: [PATCH 05/11] group_by not sort_by --- site/_posts/2014-05-05-jekyll-2-0-0-released.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/site/_posts/2014-05-05-jekyll-2-0-0-released.markdown b/site/_posts/2014-05-05-jekyll-2-0-0-released.markdown index 0c95f765..b22c7ed6 100644 --- a/site/_posts/2014-05-05-jekyll-2-0-0-released.markdown +++ b/site/_posts/2014-05-05-jekyll-2-0-0-released.markdown @@ -15,7 +15,7 @@ Jam-packed with some [highly-requested features and bugfixes galore][changelog], 3. [Native Sass & CoffeeScript support](/docs/assets/) 4. [YAML Front-Matter defaults](/docs/configuration/#frontmatter_defaults) 5. Custom markdown processors -6. Addition of `where` and `sort_by` Liquid filters +6. Addition of `where` and `group_by` Liquid filters 7. Switch from Maruku to Kramdown as default markdown converter Check out our [changelog][] for a complete list of all (200+) changes. From 6b54b715d7ce0cdb33dd3f49135096ca1867a571 Mon Sep 17 00:00:00 2001 From: Parker Moore Date: Mon, 5 May 2014 22:38:37 -0400 Subject: [PATCH 06/11] MAXIMUM NOSTALGIA --- site/_posts/2014-05-05-jekyll-2-0-0-released.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/site/_posts/2014-05-05-jekyll-2-0-0-released.markdown b/site/_posts/2014-05-05-jekyll-2-0-0-released.markdown index b22c7ed6..b5ed83e3 100644 --- a/site/_posts/2014-05-05-jekyll-2-0-0-released.markdown +++ b/site/_posts/2014-05-05-jekyll-2-0-0-released.markdown @@ -6,7 +6,7 @@ version: 2.0.0 categories: [release] --- -One year ago, [we released Jekyll 1.0.0][jekyll-1]. One year later, we present to you the next major version: Jekyll 2.0. +Almost a year later to the day, [we released Jekyll 1.0.0][jekyll-1]. One year later, we present to you the next major version: Jekyll 2.0. Jam-packed with some [highly-requested features and bugfixes galore][changelog], this is the best Jekyll yet. Some notable changes: From 7056da079de8360b0d2a1bfdbd4277b4798ff115 Mon Sep 17 00:00:00 2001 From: Parker Moore Date: Mon, 5 May 2014 22:41:33 -0400 Subject: [PATCH 07/11] Add list of 2.0.0 contributors. --- site/_posts/2014-05-05-jekyll-2-0-0-released.markdown | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/site/_posts/2014-05-05-jekyll-2-0-0-released.markdown b/site/_posts/2014-05-05-jekyll-2-0-0-released.markdown index b5ed83e3..556d46d8 100644 --- a/site/_posts/2014-05-05-jekyll-2-0-0-released.markdown +++ b/site/_posts/2014-05-05-jekyll-2-0-0-released.markdown @@ -20,6 +20,10 @@ Jam-packed with some [highly-requested features and bugfixes galore][changelog], 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, Paul Oppenheim, + Happy developing! [changelog]: /docs/history/ From f1a00a01cf6f4780654908a552ce57d0d849b52b Mon Sep 17 00:00:00 2001 From: Parker Moore Date: Mon, 5 May 2014 23:37:17 -0400 Subject: [PATCH 08/11] Give them a 1/4" hole, which is what they want --- .../2014-05-05-jekyll-2-0-0-released.markdown | 18 +++++++++--------- 1 file changed, 9 insertions(+), 9 deletions(-) diff --git a/site/_posts/2014-05-05-jekyll-2-0-0-released.markdown b/site/_posts/2014-05-05-jekyll-2-0-0-released.markdown index 556d46d8..d6cdd795 100644 --- a/site/_posts/2014-05-05-jekyll-2-0-0-released.markdown +++ b/site/_posts/2014-05-05-jekyll-2-0-0-released.markdown @@ -10,19 +10,19 @@ Almost a year later to the day, [we released Jekyll 1.0.0][jekyll-1]. One year l Jam-packed with some [highly-requested features and bugfixes galore][changelog], this is the best Jekyll yet. Some notable changes: -1. [Collections](/docs/collections/) -2. Brand new site template for `jekyll new` (thanks [@jglovier][]!) -3. [Native Sass & CoffeeScript support](/docs/assets/) -4. [YAML Front-Matter defaults](/docs/configuration/#frontmatter_defaults) -5. Custom markdown processors -6. Addition of `where` and `group_by` Liquid filters -7. Switch from Maruku to Kramdown as default markdown converter +1. [Collections](/docs/collections/) - Collections allow you to define an unlimited number of custom document types (beyond just posts and pages) for different types of content you may want to author in Jekyll such as API documentation or a cookbook! +2. [Brand new site template](https://github.com/jekyll/jekyll/pull/2050#issuecomment-35938016) (thanks [@jglovier][]!) - Getting started with Jekyll just got a lot easier and a lot more beautiful. Just run `jekyll new ` and you're good to go. +3. [Native Sass & CoffeeScript support](/docs/assets/) - We love CSS and JavaScript as much as the next guy, but there will always be a special place in our hearts for Sass and CoffeeScript. We now offer native support for these file types — no more messing around with Rake or Grunt! +4. [YAML Front-Matter defaults](/docs/configuration/#frontmatter_defaults) - If you've set `layout: post` more than once in your life, you'll love this new feature: set front-matter defaults for a given directory or type. +5. [Custom markdown processors](/docs/configuration/#custom_markdown_processors) - Always wanted to use your favourite home-grown Markdown converter, but couldn't with Jekyll? Now you can. Simply specify `markdown: MyConverterClass` and you're on your way. +6. [Addition of `where` and `group_by` Liquid filters](/docs/templates/#filters) - Simplifying your Liquid templates one filter at a time. The `where` filter selects from an array all items within which have a given value for a property. The `group_by` filter groups all items in an array which have the same value for a given property. +7. [Switch from Maruku to Kramdown as default markdown converter](https://github.com/jekyll/jekyll/pull/1988) - Maruku is dead. We've replaced it with the converter which has the closest feature parity: Kramdown! 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! +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, 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! From 2f660674c3044a818170209aea4803d3ecf31ea0 Mon Sep 17 00:00:00 2001 From: Parker Moore Date: Mon, 5 May 2014 23:37:25 -0400 Subject: [PATCH 09/11] Add docs for group_by and where filters --- site/docs/templates.md | 26 ++++++++++++++++++++++++++ 1 file changed, 26 insertions(+) diff --git a/site/docs/templates.md b/site/docs/templates.md index a4c79184..12ae5d41 100644 --- a/site/docs/templates.md +++ b/site/docs/templates.md @@ -79,6 +79,32 @@ common tasks easier.

+ + +

Where

+

Select all the object in an array where the key has the given.

+ + +

+ {% raw %}{{ site.members | where:"graduation_year","2014" }}{% endraw %} +

+ + + + +

Group By

+

Group an array's items by a given property.

+ + +

+ {% raw %}{{ site.members | group_by:"graduation_year" }}{% endraw %} +

+

+ [{"name"=>"2013", "items"=>[...]}, +{"name"=>"2014", "items"=>[...]}] +

+ +

XML Escape

From 581b07d09674c327dd2d6401f3cbebdc7d4f3ebe Mon Sep 17 00:00:00 2001 From: Parker Moore Date: Mon, 5 May 2014 23:45:18 -0400 Subject: [PATCH 10/11] Add docs about custom markdown processor --- .../2014-05-05-jekyll-2-0-0-released.markdown | 2 +- site/docs/configuration.md | 27 +++++++++++++++++++ 2 files changed, 28 insertions(+), 1 deletion(-) diff --git a/site/_posts/2014-05-05-jekyll-2-0-0-released.markdown b/site/_posts/2014-05-05-jekyll-2-0-0-released.markdown index d6cdd795..b5a15e69 100644 --- a/site/_posts/2014-05-05-jekyll-2-0-0-released.markdown +++ b/site/_posts/2014-05-05-jekyll-2-0-0-released.markdown @@ -14,7 +14,7 @@ Jam-packed with some [highly-requested features and bugfixes galore][changelog], 2. [Brand new site template](https://github.com/jekyll/jekyll/pull/2050#issuecomment-35938016) (thanks [@jglovier][]!) - Getting started with Jekyll just got a lot easier and a lot more beautiful. Just run `jekyll new ` and you're good to go. 3. [Native Sass & CoffeeScript support](/docs/assets/) - We love CSS and JavaScript as much as the next guy, but there will always be a special place in our hearts for Sass and CoffeeScript. We now offer native support for these file types — no more messing around with Rake or Grunt! 4. [YAML Front-Matter defaults](/docs/configuration/#frontmatter_defaults) - If you've set `layout: post` more than once in your life, you'll love this new feature: set front-matter defaults for a given directory or type. -5. [Custom markdown processors](/docs/configuration/#custom_markdown_processors) - Always wanted to use your favourite home-grown Markdown converter, but couldn't with Jekyll? Now you can. Simply specify `markdown: MyConverterClass` and you're on your way. +5. [Custom markdown processors](/docs/configuration/#custom-markdown-processors) - Always wanted to use your favourite home-grown Markdown converter, but couldn't with Jekyll? Now you can. Simply specify `markdown: MyConverterClass` and you're on your way. 6. [Addition of `where` and `group_by` Liquid filters](/docs/templates/#filters) - Simplifying your Liquid templates one filter at a time. The `where` filter selects from an array all items within which have a given value for a property. The `group_by` filter groups all items in an array which have the same value for a given property. 7. [Switch from Maruku to Kramdown as default markdown converter](https://github.com/jekyll/jekyll/pull/1988) - Maruku is dead. We've replaced it with the converter which has the closest feature parity: Kramdown! diff --git a/site/docs/configuration.md b/site/docs/configuration.md index b93f973e..c273ca6a 100644 --- a/site/docs/configuration.md +++ b/site/docs/configuration.md @@ -454,3 +454,30 @@ For example, in your `_config.yml`: kramdown: input: GFM + +### Custom Markdown Processors + +If you're interested in creating a custom markdown processor, you're in luck! Create a new class in the `Jekyll::Converters::Markdown` namespace: + +{% highlight ruby %} +class Jekyll::Converters::Markdown::MyCustomProcessor + def initialize(config) + require 'funky_markdown' + @config = config + rescue LoadError + STDERR.puts 'You are missing a library required for Markdown. Please run:' + STDERR.puts ' $ [sudo] gem install funky_markdown' + raise FatalException.new("Missing dependency: funky_markdown") + end + + def convert(content) + ::FunkyMarkdown.new(content).convert + end +end +{% endhighlight %} + +Once you've created your class and have it properly setup either as a plugin in the `_plugins` folder or as a gem, specify it in your `_config.yml`: + +{% highlight yaml %} +markdown: MyCustomProcessor +{% endhighlight %} From b2d7938cec6dab0ad9f0db00689166d66a45f2ff Mon Sep 17 00:00:00 2001 From: Parker Moore Date: Tue, 6 May 2014 12:18:00 -0400 Subject: [PATCH 11/11] Speak English properly. --- site/_posts/2014-05-05-jekyll-2-0-0-released.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/site/_posts/2014-05-05-jekyll-2-0-0-released.markdown b/site/_posts/2014-05-05-jekyll-2-0-0-released.markdown index b5a15e69..35ab3d43 100644 --- a/site/_posts/2014-05-05-jekyll-2-0-0-released.markdown +++ b/site/_posts/2014-05-05-jekyll-2-0-0-released.markdown @@ -6,7 +6,7 @@ version: 2.0.0 categories: [release] --- -Almost a year later to the day, [we released Jekyll 1.0.0][jekyll-1]. One year later, we present to you the next major version: Jekyll 2.0. +Almost a year ago to the day, [we released Jekyll 1.0.0][jekyll-1]. One year later, we present to you the next major version: Jekyll 2.0.0. Jam-packed with some [highly-requested features and bugfixes galore][changelog], this is the best Jekyll yet. Some notable changes: