jekyll 1.0.4 → 1.1.1

checksums.yaml

@@ -1,7 +1,15 @@
 ---
-SHA1:
-  metadata.gz: b26d3aa112f5586dd32f6773a2b62e76eb207a1d
-  data.tar.gz: da2fafe22dd70d6a54096aafd0292690b81d420f
-SHA512:
-  metadata.gz: 2ac40064f68a265c4ce6bda884c974fc2a58db5480ef80114d2db039a7fb3bcd5a3f5820f2d791cdf6fc322c0ede98b9583f75984b6b23d36ab46711d452a66e
-  data.tar.gz: 87c2c4fcb533d09c9b5306642949ddfe005611a3cf62515b3ad13921e21e4c4f26b3bfb70497c2745c8d061a42b211502c44cfb153b1133bab53dd55a33a5b4b
+!binary "U0hBMQ==":
+  metadata.gz: !binary |-
+    NGRlNDhiMDk4MGFjOWFhNmY5Y2E4NzdjM2I0ZTIyNmUxY2M2MDE5OA==
+  data.tar.gz: !binary |-
+    OGYzMmMyNzk5YWZkMzFmOGZjZjNkN2M2ZmFlYzJjNzI3ODgzYTlkZA==
+!binary "U0hBNTEy":
+  metadata.gz: !binary |-
+    MTgwMDQ3YWYyZDUwMzgzM2RmYTZhNWVhNTE0YzNmMWIxMDg2ODU4Njk3YWQ3
+    ZWViYTIwYTVmYWY1OWNiYjQ2MDgwNTc3ZmY1YzVlNTI2M2ViYmYwYjU1ODIx
+    YzkwZmE2MTE4NDExYWU2YTE3Y2YyYTEyN2QxMWEzMTJmODI5Y2E=
+  data.tar.gz: !binary |-
+    ODMyZTI2ODUzNGU0NGE2NTI2ZDg2ZmNlNWIxNjZhNWIxNTE5Y2RjYmQ3ZmQ2
+    MGJkNDNmZGQyM2I0OGQyZDM3MzRjYjMxMTgyOGVlNjNmZjk1ZWUyMGVhYjAx
+    YjJkNTk5YTUwNDRjMjFlYWI1Y2I2NWU5ZWY4ZGE0YjEwMjE4MWY=

data/{CONTRIBUTING.md → CONTRIBUTING.markdown}

@@ -15,7 +15,7 @@ following in mind:
   would be appreciated, and once merged it will be transferred over to the main
   wiki.
 * If your contribution changes any Jekyll behavior, make sure to update the
-  documentation. It lives in `site/_posts`. If the docs are missing information,
+  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.
@@ -50,6 +50,24 @@ Here's the most direct way to get your work merged into the project:
 * 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/History.markdown

@@ -1,7 +1,109 @@
-## 1.0.4 / 2013-07-24
+## HEAD
+
+### Major Enhancements
+
+### Minor Enhancements
+
+### Bug Fixes
+
+### Development Fixes
+
+### Site Enhancements
+
+## v1.1.1 / 2013-07-24
+
+### Minor Enhancements
+  * Remove superfluous `table` selector from main.css in `jekyll new` template (#1328)
+  * Abort with non-zero exit codes (#1338)
 
 ### Bug Fixes
-  * Require Liquid 2.5.1 (#1349)
+  * Fix up the rendering of excerpts (#1339)
+
+### Site Enhancements
+  * Add Jekyll Image Tag to the plugins list (#1306)
+  * Remove erroneous statement that `site.pages` are sorted alphabetically.
+  * Add info about the `_drafts` directory to the directory structure
+    docs (#1320)
+  * Improve the layout of the plugin listing by organizing it into
+    categories (#1310)
+  * Add generator-jekyllrb and grunt-jekyll to plugins page (#1330)
+  * Mention Kramdown as option for markdown parser on Extras page (#1318)
+  * Update Quick-Start page to include reminder that all requirements must be installed (#1327)
+  * Change filename in `include` example to an HTML file so as not to indicate that Jekyll
+    will automatically convert them. (#1303)
+  * Add an RSS feed for commits to Jekyll (#1343)
+
+## 1.1.0 / 2013-07-14
+
+### Major Enhancements
+  * Add `docs` subcommand to read Jekyll's docs when offline. (#1046)
+  * Support passing parameters to templates in `include` tag (#1204)
+  * Add support for Liquid tags to post excerpts (#1302)
+
+### Minor Enhancements
+  * Search the hierarchy of pagination path up to site root to determine template page for
+    pagination. (#1198)
+  * Add the ability to generate a new Jekyll site without a template (#1171)
+  * Use redcarpet as the default markdown engine in newly generated
+    sites (#1245, #1247)
+  * Add `redcarpet` as a runtime dependency so `jekyll build` works out-of-the-box for new
+    sites. (#1247)
+  * In the generated site, remove files that will be replaced by a
+    directory (#1118)
+  * Fail loudly if a user-specified configuration file doesn't exist (#1098)
+  * Allow for all options for Kramdown HTML Converter (#1201)
+
+### Bug Fixes
+  * Fix pagination in subdirectories. (#1198)
+  * Fix an issue with directories and permalinks that have a plus sign
+    (+) in them (#1215)
+  * Provide better error reporting when generating sites (#1253)
+  * Latest posts first in non-LSI `related_posts` (#1271)
+
+### Development Fixes
+  * Merge the theme and layout cucumber steps into one step (#1151)
+  * Restrict activesupport dependency to pre-4.0.0 to maintain compatibility with `<= 1.9.2`
+  * Include/exclude deprecation handling simplification (#1284)
+  * Convert README to Markdown. (#1267)
+  * Refactor Jekyll::Site (#1144)
+
+### Site Enhancements
+  * Add "News" section for release notes, along with an RSS feed (#1093, #1285, #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)
+  * Update link to the official Maruku repo (#1175)
+  * Add documentation about `paginate_path` to "Templates" page in docs (#1129)
+  * Give the quick-start guide its own page (#1191)
+  * Update ProTip on Installation page in docs to point to all the info about Pygments and
+    the 'highlight' tag. (#1196)
+  * Run `site/img` through ImageOptim (thanks @qrush!) (#1208)
+  * Added Jade Converter to `site/docs/plugins` (#1210)
+  * Fix location of docs pages in Contributing pages (#1214)
+  * Add ReadInXMinutes plugin to the plugin list (#1222)
+  * Remove plugins from the plugin list that have equivalents in Jekyll
+    proper (#1223)
+  * Add jekyll-assets to the plugin list (#1225)
+  * Add jekyll-pandoc-mulitple-formats to the plugin list (#1229)
+  * Remove dead link to "Using Git to maintain your blog" (#1227)
+  * Tidy up the third-party plugins listing (#1228)
+  * Update contributor information (#1192)
+  * Update URL of article about Blogger migration (#1242)
+  * Specify that RedCarpet is the default for new Jekyll sites on Quickstart page (#1247)
+  * Added site.pages to Variables page in docs (#1251)
+  * Add Youku and Tudou Embed link on Plugins page. (#1250)
+  * Add note that `gist` tag supports private gists. (#1248)
+  * Add `jekyll-timeago` to list of third-party plugins. (#1260)
+  * Add `jekyll-swfobject` to list of third-party plugins. (#1263)
+  * Add `jekyll-picture-tag` to list of third-party plugins. (#1280)
+  * Update the GitHub Pages documentation regarding relative URLs
+    (#1291)
+  * Update the S3 deployment documentation (#1294)
+  * Add suggestion for Xcode CLT install to troubleshooting page in docs (#1296)
+  * Add 'Working with drafts' page to docs (#1289)
+  * Add information about time zones to the documentation for a page's
+    date (#1304)
 
 ## 1.0.3 / 2013-06-07
 
@@ -169,7 +271,7 @@
   * Fixed Page#dir and Page#url for edge cases (#536)
   * Fix broken post_url with posts with a time in their YAML Front-Matter (#831)
   * Look for plugins under the source directory (#654)
-  * Tumblr Migrator: finds _posts dir correctly, fixes truncation of long
+  * Tumblr Migrator: finds `_posts` dir correctly, fixes truncation of long
       post names (#775)
   * Force Categories to be Strings (#767)
   * Safe YAML plugin to prevent vulnerability (#777)
@@ -261,7 +363,7 @@
 
 ## 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)
   * Complain about YAML and Liquid errors (#249)
   * Remove orphaned files during regeneration (#247)
@@ -278,7 +380,7 @@
   * Bug Fixes
   * Fixed filename basename generation (#208)
   * Set mode to UTF8 on Sequel connections (#237)
-  * Prevent _includes dir from being a symlink
+  * Prevent `_includes` dir from being a symlink
 
 ## 0.7.0 / 2010-08-24
 ### Minor Enhancements
@@ -363,129 +465,116 @@
 ## 0.5.3 / 2009-07-14
   * Bug Fixes
   * Solving the permalink bug where non-html files wouldn't work
-      [github.com/jeffrydegrande]
+      (@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)
+  * 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)
   * Posts can now have an empty YAML front matter or none at all
-      [github.com/bahuvrihi]
+      (@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)
+  * Fixes for pagination and ordering posts on the same day (@ujh)
   * Made pages respect permalinks style and permalinks in yml front matter
-      [github.com/eugenebolshakov]
+      (@eugenebolshakov)
   * Index.html file should always have index.html permalink
-      [github.com/eugenebolshakov]
+      (@eugenebolshakov)
   * Added trailing slash to pretty permalink style so Apache is happy
-      [github.com/eugenebolshakov]
+      (@eugenebolshakov)
   * Bad markdown processor in config fails sooner and with better message
-      [github.com/gcnovus]
-  * Allow CRLFs in yaml frontmatter [github.com/juretta]
+      (@gcnovus)
+  * Allow CRLFs in yaml frontmatter (@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, @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)
   * 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)
   * 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)
+  * CGI escaped post titles (@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)
+  * Ability to set prevent a post from publishing via YAML (@qrush)
+  * Add textilize filter (@willcodeforfoo)
+  * Add 'pretty' permalink style for wordpress-like urls (@dysinger)
+  * Made it possible to enter categories from YAML as an array (@Chrononaut)
+  * Ignore Emacs autosave files (@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)
+  * Close open4 streams to prevent zombies (@rtomayko)
+  * Only query required fields from the WP Database (@ariejan)
+  * Prevent `_posts` from being copied to the destination directory (@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)
+  * Fix tests and convert to Shoulda (@qrush, @technicalpickles)
+  * Add Cucumber acceptance test suite (@qrush, @technicalpickles)
 
 ## 0.4.1
 ### Minor Enhancements
-  * Changed date format on wordpress converter (zeropadding)
-      [github.com/dysinger]
+  * Changed date format on wordpress converter (zeropadding) (@dysinger)
   * Bug Fixes
-  * Add jekyll binary as executable to gemspec [github.com/dysinger]
+  * Add jekyll binary as executable to gemspec (@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)
+  * site.topics accessor (@baz)
+  * Add `array_to_sentence_string` filter (@mchung)
+  * Add a converter for textpattern (@PerfectlyNormal)
+  * Add a working Mephisto / MySQL converter (@ivey)
+  * Allowing .htaccess files to be copied over into the generated site (@briandoll)
+  * Add option to not put file date in permalink URL (@mreid)
+  * Add line number capabilities to highlight blocks (@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)
+  * Fixed an issue with pygments, markdown, and newlines (@zpinter)
+  * Ampersands need to be escaped (@pufuwozu, @ap)
+  * Test and fix the site.categories hash (@zzot)
+  * Fix site payload available to files (@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 and @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)
+  * Added post topics based on directories underneath `_posts`
+  * Added new date filter that shows the full month name (@mreid)
+  * Merge Post's YAML front matter into its to_liquid payload (@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)
   * 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)
+  * 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)
   * 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)
 
 ## 0.2.0 / 2008-12-14
   * Major Changes
@@ -493,7 +582,7 @@
 
 ## 0.1.6 / 2008-12-13
   * Major Features
-  * Include files in _includes with {% include x.textile %}
+  * Include files in `_includes` with `{% include x.textile %}`
 
 ## 0.1.5 / 2008-12-12
 ### Major Enhancements
@@ -501,12 +590,10 @@
   * 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)
   * 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)
+  * Skip `related_posts` when there is only one post (@JackDanger)
 
 ## 0.1.4 / 2008-12-08
   * Bug Fixes
@@ -514,12 +601,12 @@
 
 ## 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)
+  * Mephisto and CSV converters (@vanpelt)
+  * Code hilighting (@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)
 
 ## 0.1.2 / 2008-11-22
   * Major Features
@@ -530,7 +617,7 @@
 
 ## 0.1.1 / 2008-11-22
   * Minor Additions
-  * Posts now support introspectional data e.g. {{ page.url }}
+  * Posts now support introspectional data e.g. `{{ page.url }}`
 
 ## 0.1.0 / 2008-11-05
   * First release

data/README.markdown

@@ -0,0 +1,45 @@
+# Jekyll
+
+[![Build Status](https://secure.travis-ci.org/mojombo/jekyll.png)](https://travis-ci.org/mojombo/jekyll)
+[![Code Climate](https://codeclimate.com/github/mojombo/jekyll.png)](https://codeclimate.com/github/mojombo/jekyll)
+
+By Tom Preston-Werner, Nick Quaranto, and many awesome contributors!
+
+Jekyll is a simple, blog aware, static site generator. It takes a template directory (representing the raw form of a website), runs it through Textile or Markdown and Liquid converters, and spits out a complete, static website suitable for serving with Apache or your favorite web server. This is also the engine behind [GitHub Pages](http://pages.github.com), which you can use to host your project's page or blog right here from GitHub.
+
+## Getting Started
+
+* [Install](http://jekyllrb.com/docs/installation/) the gem
+* Read up about its [Usage](http://jekyllrb.com/docs/usage/) and [Configuration](http://jekyllrb.com/docs/configuration/)
+* Take a gander at some existing [Sites](http://wiki.github.com/mojombo/jekyll/sites)
+* Fork and [Contribute](https://github.com/mojombo/jekyll/blob/master/CONTRIBUTING.md) your own modifications
+* Have questions? Post them on the [Mailing List](http://groups.google.com/group/jekyll-rb)
+
+## Diving In
+
+* [Migrate](http://jekyllrb.com/docs/migrations/) from your previous system
+* Learn how the [YAML Front Matter](http://jekyllrb.com/docs/frontmatter/) works
+* Put information on your site with [Variables](http://jekyllrb.com/docs/variables/)
+* Customize the [Permalinks](http://jekyllrb.com/docs/permalinks/) your posts are generated with
+* Use the built-in [Liquid Extensions](http://jekyllrb.com/docs/templates/) to make your life easier
+* Use custom [Plugins](http://jekyllrb.com/docs/plugins/) to generate content specific to your site
+
+## Runtime Dependencies
+
+* Classifier: Generating related posts (Ruby)
+* Directory Watcher: Auto-regeneration of sites (Ruby)
+* Kramdown: Markdown-superset converter (Ruby)
+* Liquid: Templating system (Ruby)
+* Maruku: Default markdown engine (Ruby)
+
+## Developer Dependencies
+
+* RDiscount: Discount Markdown Processor (Ruby)
+* RedCloth: Textile support (Ruby)
+* RedGreen: Nicer test output (Ruby)
+* RR: Mocking (Ruby)
+* Shoulda: Test framework (Ruby)
+
+## License
+
+See [LICENSE](https://github.com/mojombo/jekyll/blob/master/LICENSE).