v3.0.2

Bug Fixes

• Document: throw a useful error when an invalid date is given (#4378)

Release post: http://jekyllrb.com/news/2016/01/20/jekyll-3-0-2-released/

Props to @benbalter for finding this nasty 🐛!

v3.1.0.pre.rc2

Changes since v3.1.0.pre.rc1:

Bug Fixes

• Page should respect output extension of its permalink (#4373)

Development Fixes

• Add @jmcglone's guide to github-pages doc page (#4364)

v3.1.0.pre.rc1

Minor Enhancements

• Shim subcommands with indication of gem possibly required so users know how to use them (#4254)
• Add smartify Liquid filter for SmartyPants (#4323)
• Raise error on empty permalink (#4361)

Bug Fixes

• Make sure jekyll/drops/drop is loaded first. (#4292)
• Convertible/Page/Renderer: use payload hash accessor & setter syntax for backwards-compatibility (#4311)
• Drop: fix hash setter precendence (#4312)
• utils: has_yaml_header? should accept files with extraneous spaces (#4290)
• Escape html from site.title and page.title in site template (#4307)
• Allow custom file extensions if defined in permalink YAML front matter (#4314)
• Fix deep_merge_hashes! handling of drops and hashes (#4359)

Development Fixes

• Fix many Rubocop style errors (#4301)
• Fix spelling of "GitHub" in docs and history (#4322)
• Reorganize and cleanup the Gemfile, shorten required depends. (#4318)
• Remove script/rebund. (#4341)
• Implement codeclimate platform (#4340)
• Remove ObectSpace dumping and start using inherited, it's faster. (#4342)
• Add script/travis so all people can play with Travis-CI images. (#4338)
• Move Cucumber to using RSpec-Expections and furthering JRuby support. (#4343)
• Rearrange Cucumber and add some flair. (#4347)
• Remove old FIXME (#4349)
• Clean up the Gemfile (and keep all the necessary dependencies) (#4350)

Site Enhancements

• Add jekyll-commonmark to list of third-party plugins (#4299)
• Add documentation for incremental regeneration (#4293)
• Add note about removal of relative permalink support in upgrading docs (#4303)
• Add Pro Tip to use front matter variable to create clean URLs (#4296)
• Fix grammar in the documentation for posts. (#4330)
• Add documentation for smartify Liquid filter (#4333)
• Fixed broken link to blog on using mathjax with jekyll (#4344)
• Documentation: correct reference in Precedence section of Configuration docs (#4355)

v3.1.0.pre.beta1

Minor Enhancements

• Use Liquid::Drops instead of Hashes in #to_liquid (#4277)
• Add 'sample' Liquid filter Equivalent to Array#sample functionality (#4223)
• Cache parsed include file to save liquid parsing time. (#4120)
• Slightly speed up url sanitization and handle multiples of ///. (#4168)
• Print debug message when a document is skipped from reading (#4180)
• Include tag should accept multiple variables in the include name (#4183)
• Add -o option to serve command which opens server URL (#4144)
• Add CodeClimate platform for better code quality. (#4220)
• General improvements for WEBrick via jekyll serve such as SSL & custom headers (#4224, #4228)
• Add a default charset to content-type on webrick. (#4231)
• Switch PluginManager to use require_with_graceful_fail for better UX (#4233)
• Allow quoted date in front matter defaults (#4184)
• Add a Jekyll doctor warning for URLs that only differ by case (#3171)
• drops: create one base Drop class which can be set as mutable or not (#4285)
• drops: provide #to_h to allow for hash introspection (#4281)

Bug Fixes

• Pass build options into clean command (#4177)
• Allow users to use .htm and .xhtml (XHTML5.) (#4160)
• Prevent Shell Injection. (#4200)
• Convertible should make layout data accessible via layout instead of page (#4205)
• Avoid using Dir.glob with absolute path to allow special characters in the path (#4150)
• Handle empty config files (#4052)
• Rename @options so that it does not impact Liquid. (#4173)
• utils/drops: update Drop to support Utils.deep_merge_hashes (#4289)

Development Fixes

• jekyll-docs should be easily release-able (#4152)
• Allow use of Cucumber 2.1 or greater (#4181)
• Modernize Kramdown for Markdown converter. (#4109)
• Change TestDoctorCommand to JekyllUnitTest... (#4263)
• Create namespaced rake tasks in separate .rake files under lib/tasks (#4282)
• markdown: refactor for greater readability & efficiency (#3771)

Site Enhancements

• Add three plugins to directory (#4163)
• Add upgrading docs from 2.x to 3.x (#4157)
• Add protect_email to the plugins index. (#4169)
• Add jekyll-deploy to list of third-party plugins (#4179)
• Clarify plugin docs (#4154)
• Add Kickster to deployment methods in documentation (#4190)
• Add DavidBurela's tutorial for Windows to Windows docs page (#4210)
• Change GitHub code block to highlight tag to avoid it overlaps parent div (#4121)
• Update FormKeep link to be something more specific to Jekyll (#4243)
• Remove example Roger Chapman site, as the domain doesn't exist (#4249)
• Added configuration options for draft_posts to configuration docs (#4251)
• Fix checklist in _assets.md (#4259)
• Add Markdown examples to Pages docs (#4275)
• Add jekyll-paginate-category to list of third-party plugins (#4273)
• Add jekyll-responsive_image to list of third-party plugins (#4286)

v3.0.1

Bug Fixes

• Document: only superdirectories of the collection are categories (#4110)
• Convertible#render_liquid should use render! to cause failure on bad Liquid (#4077)
• Don't generate .jekyll-metadata in non-incremental build (#4079)
• Set highlighter config val to kramdown.syntax_highlighter (#4090)
• Align hooks implementation with documentation (#4104)
• Fix the deprecation warning in the doctor command (#4114)
• Fix case in :title and add :slug which is downcased (#4100)

Development Fixes

• Fix test warnings when doing rake {test,spec} or script/test (#4078)

Site Enhancements

• Update normalize.css to v3.0.3. (#4085)
• Update Font Awesome to v4.4.0. (#4086)
• Adds a note about installing the jekyll-gist gem to make gist tag work (#4101)
• Align hooks documentation with implementation (#4104)
• Add Jekyll Flickr Plugin to the list of third party plugins (#4111)
• Remove link to now-deleted blog post (#4125)
• Update the liquid syntax in the pagination docs (#4130)
• Add jekyll-language-plugin to plugins.md (#4134)
• Updated to reflect feedback in #4129 (#4137)
• Clarify assets.md based on feedback of #4129 (#4142)
• Re-correct the liquid syntax in the pagination docs (#4140)

v3.0.0

Major Enhancements

• Liquid profiler (i.e. know how fast or slow your templates render) (#3762)
• Incremental regeneration (#3116)
• Add Hooks: a new kind of plugin (#3553)
• Upgrade to Liquid 3.0.0 (#3002)
• site.posts is now a Collection instead of an Array (#4055)
• Add basic support for JRuby (commit: 0f4477)
• Drop support for Ruby 1.9.3. (#3235)
• Support Ruby v2.2 (#3234)
• Support RDiscount 2 (#2767)
• Remove most runtime deps (#3323)
• Move to Rouge as default highlighter (#3323)
• Mimic GitHub Pages .html extension stripping behavior in WEBrick (#3452)
• Always include file extension on output files (#3490)
• Improved permalinks for pages and collections (#3538)
• Sunset (i.e. remove) Maruku (#3655)
• Remove support for relative permalinks (#3679)
• Iterate over site.collections as an array instead of a hash. (#3670)
• Adapt StaticFile for collections, config defaults (#3823)
• Add a Code of Conduct for the Jekyll project (#3925)
• Added permalink time variables (#3990)
• Add --incremental flag to enable incremental regen (disabled by default) (#4059)

Minor Enhancements

• Deprecate access to Document#data properties and Collection#docs methods (#4058)
• Sort static files just once, and call site_payload once for all collections (#3204)
• Separate jekyll docs and optimize external gem handling (#3241)
• Improve Site#getConverterImpl and call it Site#find_converter_instance (#3240)
• Use relative path for path Liquid variable in Documents for consistency (#2908)
• Generalize Utils#slugify for any scripts (#3047)
• Added basic microdata to post template in site template (#3189)
• Store log messages in an array of messages. (#3244)
• Allow collection documents to override output property in front matter (#3172)
• Keep file modification times between builds for static files (#3220)
• Only downcase mixed-case categories for the URL (#2571)
• Added per post excerpt_separator functionality (#3274)
• Allow collections YAML to end with three dots (#3134)
• Add mode parameter to slugify Liquid filter (#2918)
• Perf: Markdown#matches should avoid regexp (#3321)
• Perf: Use frozen regular expressions for Utils#slugify (#3321)
• Split off Textile support into jekyll-textile-converter (#3319)
• Improve the navigation menu alignment in the site template on small
  screens (#3331)
• Show the regeneration time after the initial generation (#3378)
• Site template: Switch default font to Helvetica Neue (#3376)
• Make the include tag a teensy bit faster. (#3391)
• Add pkill -f jekyll to ways to kill. (#3397)
• Site template: collapsed, variable-driven font declaration (#3360)
• Site template: Don't always show the scrollbar in code blocks (#3419)
• Site template: Remove undefined text class from p element (#3440)
• Site template: Optimize text rendering for legibility (#3382)
• Add draft? method to identify if Post is a Draft & expose to Liquid (#3456)
• Write regeneration metadata even on full rebuild (#3464)
• Perf: Use String#end_with?("/") instead of regexp when checking paths (#3516)
• Docs: document 'ordinal' built-in permalink style (#3532)
• Upgrade liquid-c to 3.x (#3531)
• Use consistent syntax for deprecation warning (#3535)
• Added build --destination and --source flags (#3418)
• Site template: remove unused page.meta attribute (#3537)
• Improve the error message when sorting null objects (#3520)
• Added liquid-md5 plugin (#3598)
• Documentation: RR replaced with RSpec Mocks (#3600)
• Documentation: Fix subpath. (#3599)
• Create 'tmp' dir for test_tags if it doesn't exist (#3609)
• Extract reading of data from Site to reduce responsibilities. (#3545)
• Removed the word 'Jekyll' a few times from the comments (#3617)
• bin/jekyll: with no args, exit with exit code 1 (#3619)
• Incremental build if destination file missing (#3614)
• Static files mtime liquid should return a Time obj (#3596)
• Use Jekyll::Posts for both LSI indexing and lookup. (#3629)
• Add charset=utf-8 for HTML and XML pages in WEBrick (#3649)
• Set log level to debug when verbose flag is set (#3665)
• Added a mention on the Gemfile to complete the instructions (#3671)
• Perf: Cache Document#to_liquid and invalidate where necessary (#3693)
• Perf: Jekyll::Cleaner#existing_files: Call keep_file_regex and
  keep_dirs only once, not once per iteration (#3696)
• Omit jekyll/jekyll-help from list of resources. (#3698)
• Add basic jekyll doctor test to detect fsnotify (OSX) anomalies. (#3704)
• Added talk.jekyllrb.com to "Have questions?" (#3694)
• Performance: Sort files only once (#3707)
• Performance: Marshal metadata (#3706)
• Upgrade highlight wrapper from div to figure (#3779)
• Upgrade mime-types to ~> 2.6 (#3795)
• Update windows.md with Ruby version info (#3818)
• Make the directory for includes configurable (#3782)
• Rename directory configurations to match *_dir convention for consistency (#3782)
• Internal: trigger hooks by owner symbol (#3871)
• Update MIME types from mime-db (#3933)
• Add header to site template _config.yml for clarity & direction (#3997)
• Site template: add timezone offset to post date frontmatter (#4001)
• Make a constant for the regex to find hidden files (#4032)
• Site template: refactor github & twitter icons into includes (#4049)
• Site template: add background to Kramdown Rouge-ified backtick code blocks (#4053)

Bug Fixes

• post_url: fix access deprecation warning & fix deprecation msg (#4060)
• Perform jekyll-paginate deprecation warning correctly. (#3580)
• Make permalink parsing consistent with pages (#3014)
• time()pre-filter method should accept a Date object (#3299)
• Remove unneeded end tag for link in site template (#3236)
• Kramdown: Use enable_coderay key instead of use_coderay (#3237)
• Unescape Document output path (#2924)
• Fix nav items alignment when on multiple rows (#3264)
• Highlight: Only Strip Newlines/Carriage Returns, not Spaces (#3278)
• Find variables in front matter defaults by searching with relative file path. (#2774)
• Allow variables (e.g :categories) in YAML front matter permalinks (#3320)
• Handle nil URL placeholders in permalinks (#3325)
• Template: Fix nav items alignment when in "burger" mode (#3329)
• Template: Remove !important from nav SCSS introduced in #3329 (#3375)
• The :title URL placeholder for collections should be the filename slug. (#3383)
• Trim the generate time diff to just 3 places past the decimal place (#3415)
• The highlight tag should only clip the newlines before and after the entire block, not in between (#3401)
• highlight: fix problem with linenos and rouge. (#3436)
• Site#read_data_file: read CSV's with proper file encoding (#3455)
• Ignore .jekyll-metadata in site template (#3496)
• Template: Point documentation link to the documentation pages (#3502)
• Removed the trailing slash from the example /blog baseurl comment (#3485)
• Clear the regenerator cache every time we process (#3592)
• Readd (bring back) minitest-profile (#3628)
• Add WOFF2 font MIME type to Jekyll server MIME types (#3647)
• Be smarter about extracting the extname in StaticFile (#3632)
• Process metadata for all dependencies (#3608)
• Show error message if the YAML front matter on a page/post is invalid. (#3643)
• Upgrade redcarpet to 3.2 (Security fix: OSVDB-120415) (#3652)
• Create #mock_expects that goes directly to RSpec Mocks. (#3658)
• Open .jekyll-metadata in binary mode to read binary Marshal data (#3713)
• Incremental regeneration: handle deleted, renamed, and moved dependencies (#3717)
• Fix typo on line 19 of pagination.md (#3760)
• Fix it so that 'blog.html' matches 'blog.html' (#3732)
• Remove occasionally-problematic ensure in LiquidRenderer (#3811)
• Fixed an unclear code comment in site template SCSS (#3837)
• Fix reading of binary metadata file (#3845)
• Remove var collision with site template header menu iteration variable (#3838)
• Change non-existent hl_linenos to hl_lines to allow passthrough in safe mode (#3787)
• Add missing flag to disable the watcher (#3820)
• Update CI guide to include more direct explanations of the flow (#3891)
• Set future to false in the default config (#3892)
• filters: where should compare stringified versions of input & comparator (#3935)
• Read build options for jekyll clean command (#3828)
• Fix #3970: Use Gem::Version to compare versions, not >.
• Abort if no subcommand. Fixes confusing message. (#3992)
• Whole-post excerpts should match the post content (#4004)
• Change default font weight to 400 to fix bold/strong text issues (#4050)
• Document: Only auto-generate the excerpt if it's not overridden (#4062)
• Utils: deep_merge_hashes should also merge default_proc (45f69bb)
• Defaults: compare paths in applies_path? as Strings to avoid confusion (7b81f00)

Development Fixes

• Remove loader.rb and "modernize" script/test. (#3574)
• Improve the grammar in the documentation (#3233)
• Update the LICENSE text to match the MIT license exactly (#3253)
• Update rake task site:publish to fix minor bugs. (#3254)
• Switch to shields.io for the README badges. (#3255)
• Use FileList instead of Dir.glob in site:publish rake task (#3261)
• Fix test script to be platform-independent (#3279)
• Instead of symlinking /tmp, create and symlink a local tmp in the tests (#3258)
• Fix some spacing (#3312)
• Fix comment typo in lib/jekyll/frontmatter_defaults.rb (#3322)
• Move all regenerate? checking to Regenerator (#3326)
• Factor out a read_data_file call to keep things clean (#3380)
• Proof the site with CircleCI. (#3427)
• Update LICENSE to 2015. (#3477)
• Upgrade tests to use Minitest (#3492)
• Remove trailing whitespace (#3497)
• Use fixture_site for Document tests (#3511)
• Remove adapters deprecation warning (#3529)
• Minor fixes to url.rb to follow GitHub style guide (#3544)
• Minor changes to resolve deprecation warnings (#3547)
• Convert remaining textile test docu...

v3.0.0.pre.rc1

Major Enhancements

• site.posts is now a Collection instead of an Array (#4055)
• Add --increment flag to enable incremental regen (disabled by default) (#4059)

Minor Enhancements

• Deprecate access to Document#data properties and Collection#docs methods (#4058)
• Make a constant for the regex to find hidden files (#4032)
• Site template: refactor github & twitter icons into includes (#4049)
• Site template: add background to Kramdown Rouge-ified backtick code blocks (#4053)

Bug Fixes

• Change default font weight to 400 to fix bold/strong text issues (#4050)

Development Fixes

• Apply code block figure syntax to blocks in CONTRIBUTING (#4046)

v3.0.0.pre.beta10

Major Enhancements

• Added permalink time variables (#3990)

Minor Enhancements

• Add header to site template _config.yml for clarity & direction (#3997)
• Site template: add timezone offset to post date frontmatter (#4001)

Bug Fixes

• Abort if no subcommand. Fixes confusing message. (#3992)
• Whole-post excerpts should match the post content (#4004)

Development Fixes

• Ignore .bundle dir in SimpleCov (#4033)

Site Enhancements

• Added documentation for Jekyll environment variables (#3989)
• Fix broken configuration documentation page (#3994)
• Add troubleshooting docs for installing on El Capitan (#3999)
• Add Lazy Tweet Embedding to the list of third-party plugins (#4015)
• Add installation instructions for 2 of 3 options for plugins (#4013)
• Add alternative jekyll gem installation instructions (#4018)
• Fix a few typos and formatting problems. (#4022)
• Fix pretty permalink example (#4029)
• Note that _config.yml is not reloaded during regeneration (#4034)

v3.0.0.pre.beta9

Major Enhancements

• Adapt StaticFile for collections, config defaults (#3823)
• Add a Code of Conduct for the Jekyll project (#3925)

Minor Enhancements

• Make the directory for includes configurable (#3782)
• Rename directory configurations to match *_dir convention for consistency (#3782)
• Internal: trigger hooks by owner symbol (#3871)
• Update MIME types from mime-db (#3933)

Bug Fixes

• Fixed an unclear code comment in site template SCSS (#3837)
• Fix reading of binary metadata file (#3845)
• Remove var collision with site template header menu iteration variable (#3838)
• Change non-existent hl_linenos to hl_lines to allow passthrough in safe mode (#3787)
• Add missing flag to disable the watcher (#3820)
• Update CI guide to include more direct explanations of the flow (#3891)
• Set future to false in the default config (#3892)
• filters: where should compare stringified versions of input & comparator (#3935)
• Read build options for jekyll clean command (#3828)
• Fix #3970: Use Gem::Version to compare versions, not >.

Development Fixes

• Update Kramdown. (#3853)
• Updated the scripts shebang for portability (#3858)
• Update JRuby testing to 9K (3ab386f)
• Organize dependencies into dev and test groups. (#3852)
• Contributing.md should refer to script/cucumber (#3894)
• Update contributing documentation to reflect workflow updates (#3895)
• Add script to vendor mime types (#3933)

Site Enhancements

• Detailed instructions for rsync deployment method (#3848)
• Add Jekyll Portfolio Generator to list of plugins (#3883)
• Add site.html_files to variables docs (#3880)
• Add Static Publisher tool to list of deployment methods (#3865)
• Fix a few typos. (#3897)
• Add jekyll-youtube to the list of third-party plugins (#3931)
• Add Views Router plugin (#3950)
• Update install docs (Core dependencies, Windows reqs, etc) (#3769)
• Use Jekyll Feed for jekyllrb.com (#3736)
• Add jekyll-umlauts to plugins.md ($3966)
• Troubleshooting: fix broken link, add other mac-specific info (#3968)
• Add a new site for learning purposes (#3917)

v3.0.0.pre.beta8

Bug Fixes

• Remove occasionally-problematic ensure in LiquidRenderer (#3811)

Site Enhancements

• Update windows.md with Ruby version info (#3818)