v2.5.1

Bug Fixes

• Fix path sanitation bug related to Windows drive names (#3077)

Notes

Hot on the heels of v2.5.0, this release brings relief to our Windows users. It includes a fix for a 2.5.0 path sanitation change that has been confirmed to work on Windows.

To our Windows users: while we don’t officially support Windows, we don’t wish to impede your normal use of Jekyll at all. Our lack of full support for Windows is due to our lack of a Windows machine for development testing (no one on the core team has a Windows machine upon which to test new release candidates), not due to any malice or willful oversight. If you come to us with an issue, we are more than happy to work through it with you to come to a solution that works for all platforms. Along those lines, we have created a Windows Test Force (WTF) which is a group of Jekyll users dedicated to making sure all future releases work on Windows before they’re released so we don’t have this issue again. A special thanks goes out to the initial WTF team members, XhmikosR, Julian Thilo, Pedro Rogério, and Alfred Xing.

Happy Jekylling!

v2.5.0

Minor Enhancements

• Require gems in :jekyll_plugins Gemfile group unless JEKYLL_NO_BUNDLER_REQUIRE is specified in the environment. (#2865)
• Centralize path sanitation in the Site object (#2882)
• Allow placeholders in permalinks (#3031)
• Allow users to specify the log level via JEKYLL_LOG_LEVEL. (#3067)
• Fancy Indexing with WEBrick (#3018)
• Allow Enumerables to be used with where filter. (#2986)
• Meta descriptions in the site template now use page.excerpt if it's available (#2964)
• Change indentation in head.html of site template to 2 spaces from 4 (#2973)
• Use a $content-width variable instead of a fixed value in the site template CSS (#2972)
• Strip newlines in site template <meta> description. (#2982)
• Add link to atom feed in head of site template files (#2996)
• Performance optimizations (#2994)
• Use Hash#each_key instead of Hash#keys.each to speed up iteration
  over hash keys. (#3017)
• Further minor performance enhancements. (#3022)
• Add 'b' and 's' aliases for build and serve, respectively (#3065)

Bug Fixes

• Fix Rouge's RedCarpet plugin interface integration (#2951)
• Remove --watch from the site template blog post since it defaults
  to watching in in 2.4.0 (#2922)
• Fix code for media query mixin in site template (#2946)
• Allow post URL's to have .htm extensions (#2925)
• Utils.slugify: Don't create new objects when gsubbing (#2997)
• The jsonify filter should deep-convert to Liquid when given an Array. (#3032)
• Apply jsonify filter to Hashes deeply and effectively (#3063)
• Use 127.0.0.1 as default host instead of 0.0.0.0 (#3053)
• In the case that a Gemfile does not exist, ensure Jekyll doesn't fail on requiring the Gemfile group (#3066)

Development Fixes

• Fix a typo in the doc block for Jekyll::URL.escape_path (#3052)
• Add integration test for jekyll new --blank in TestUnit (#2913)
• Add unit test for jekyll new --force logic (#2929)
• Update outdated comment for Convertible#transform (#2957)
• Add Hakiri badge to README. (#2953)
• Add some simple benchmarking tools. (#2993)

Site Enhancements

• NOKOGIRI_USE_SYSTEM_LIBRARIES=true decreases installation time. (#3040)
• Add FormKeep to resources as Jekyll form backend (#3010)
• Fixing a mistake in the name of the new Liquid tag (#2969)
• Update Font Awesome to v4.2.0. (#2898)
• Fix link to #2895 in 2.4.0 release post. (#2899)
• Add Big Footnotes for Kramdown plugin to list of third-party plugins (#2916)
• Remove warning regarding GHP use of singular types for front matter defaults (#2919)
• Fix quote character typo in site documentation for templates (#2917)
• Point Liquid links to Liquid’s Github wiki (#2887)
• Add HTTP Basic Auth (.htaccess) plugin to list of third-party plugins (#2931)
• (Minor) Grammar & _config.yml filename fixes (#2911)
• Added mathml.rb to the list of third-party plugins. (#2937)
• Add --force_polling to the list of configuration options (#2943)
• Escape unicode characters in site CSS (#2906)
• Add note about using the github-pages gem via pages.github.com/versions.json (#2939)
• Update usage documentation to reflect 2.4 auto-enabling of --watch. (#2954)
• Add --skip-initial-build to configuration docs (#2949)
• Fix a minor typo in Templates docs page (#2959)
• Add a ditaa-ditaa plugin under Other section on the Plugins page (#2967)
• Add build/serve -V option to configuration documentation (#2948)
• Add 'Jekyll Twitter Plugin' to list of third-party plugins (#2979)
• Docs: Update normalize.css to v3.0.2. (#2981)
• Fix typo in Continuous Integration documentation (#2984)
• Clarify behavior of :categories in permalinks (#3011)

v2.4.0

Minor Enhancements

• Support a new relative_include tag (#2870)
• Auto-enable watch on 'serve' (#2858)
• Render Liquid in CoffeeScript files (#2830)
• Array Liquid filters: push, pop, unshift, shift (#2895)
• Add :title to collection URL template fillers (#2864)
• Add support for CSV files in the _data directory (#2761)
• Add the name variable to collection permalinks (#2799)
• Add inspect liquid filter. (#2867)
• Add a slugify Liquid filter (#2880)

Bug Fixes

• Use Jekyll.sanitized_path when adding static files to Collections (#2849)
• Fix encoding of main.scss in site template (#2771)
• Fix orientation bugs in default site template (#2862)

Development Fixes

• Update simplecov gem to 0.9 (#2748)
• Remove docs/ dir (#2768)
• add class << self idiom to New command (#2817)
• Allow Travis to 'parallelize' our tests (#2859)
• Fix test for Liquid rendering in Sass (#2856)
• Fixing "vertycal" typo in site template's _base.scss (#2889)

Site Enhancements

• Document the name variable for collection permalinks (#2829)
• Adds info about installing jekyll in current dir (#2839)
• Remove deprecated jekyll-projectlist plugin from list of third-party
  plugins (#2742)
• Remove tag plugins that are built in to Jekyll (#2751)
• Add markdown-writer package for Atom Editor to list of third-party
  plugins (#2763)
• Fix typo in site documentation for collections (#2764)
• Fix minor typo on plugins docs page (#2765)
• Replace markdown with HTML in sass_dir note on assets page (#2791)
• Fixed "bellow" typo in datafiles docs (#2879)
• Fix code/markdown issue in documentation for variables (#2877)
• Remove Good Include third-party plugin from plugins page (#2881)
• Add some more docs on include_relative (#2884)

v2.3.0

Minor Enhancements

• Allow Convertibles to be converted by >= 1 converters (#2704)
• Allow Sass files to be rendered in Liquid, but never place them in layouts. (#2733)
• Add jekyll help command (#2707)
• Use .scss for site_template styles. (#2667)
• Don't require the scope key in front matter defaults (#2659)
• No longer set permalink: pretty in the _config.yml for the site template (#2680)
• Rework site template to utilize Sass (#2687)
• Notify the user when auto-regeneration is disabled. (#2696)
• Allow partial variables in include tag filename argument (#2693)
• Move instances of Time.parse into a Utils method (#2682)
• Ignore subfolders in the _posts folder (#2705) REVERTS (#2633)
• Front Matter default types should always be pluralized (#2732)
• Read in static files into collection.files as StaticFiles (#2737)
• Add sassify and scssify Liquid filters (#2739)
• Replace classifier gem with classifier-reborn (#2721)

Bug Fixes

• Use only the last extname when multiple converters exist (#2722)
• Call #to_liquid before calling #to_json in jsonify filter (#2729)
• Use non padded config in strftime to avoid parse string twice (#2673)
• Replace deprecated Ruby methods with undeprecated ones (#2664)
• Catch errors when parsing Post date front matter value & produce nice error message (#2649)
• Allow static files in Collections (#2615)
• Fixed typo in Deprecator#gracefully_require error message (#2694)
• Remove preemptive loading of the 'classifier' gem. (#2697)
• Use case-insensitive checking for the file extensions when loading config files (#2718)
• When Reading Documents, Respect encoding Option (#2720)
• Refactor based on jekyll-watch clean-up. (#2716)
• Document#to_s should produce just the content of the document (#2731)

Development Fixes

• Only include lib files in the gem (#2671)
• Fix git diff command in proof script (#2672)
• Make default rake task a multitask so tests run in parallel (#2735)

Site Enhancements

• Use Sass and a Docs Collection (#2651)
• Add latest_version.txt file to the site (#2740)
• Be more ambiguous about page.content. But more transparent. (#2522)
• Streamlining front matter wording (instead of front-matter/frontmatter) (#2674)
• Add note that source directory cannot be modified in GitHub Pages (#2669)
• Fix links from #2669 to be actual HTML. Whoops. (#2679)
• Add link to jekyll-slim in list of third-party plugins (#2689)
• Add Barry Clark's Smashing Magazine tutorial to resources page (#2688)
• Reorganize and update default configuration settings (#2456)
• Fixing indentation in the configuration docs about Redcarpet exts (#2717)
• Use null in YAML instead of nil in default config list (#2719)
• Fix typo in Continuous Integration docs (#2708)

v2.2.0

Minor Enhancements

• Throw a warning if the specified layout does not exist (#2620)
• Whitelist Pygments options in safe mode (#2642)

Bug Fixes

• Remove unnecessary Jekyll::Tags::IncludeTag#blank? method (#2625)
• Categories in the path are ignored (#2633)

Development Fixes

• Refactoring Errors & Requires of Third-Party stuff (#2591)
• Add further tests for categories (#2584)
• Proof site with html-proofer on change (#2605)
• Fix up bug in #2605 which caused proofing the site not to function (#2608)
• Use bundle exec in script/proof (#2610)

Site Enhancements

• Update Kramdown urls (#2588)
• Add Jekyll::AutolinkEmail and Jekyll::GitMetadata to the list of
  third-party plugins (#2596)
• Fix a bunch of broken links in the site (#2601)
• Replace dead links with working links (#2611)
• Add jekyll-hook to deployment methods (#2617)
• Added kramdown-with-pygments plugin to the list of third-party plugins (#2623)
• Update outdated "Extras" page and remove duplicate documentation (#2622)
• Add co2 plugin to list of third-party plugins (#2639)
• Attempt to clarify the way Sass imports happen (#2642)

v2.1.1

Bug Fixes

• Patch read vulnerabilities for data & confirm none for layouts (#2563)
• Update Maruku dependency to allow use of the latest version (#2576)
• Remove conditional assignment from document URL to prevent stale urls (#2575)

Site Enhancements

• Add vertical margin to highlight to separate code blocks (#2558)
• Add html_pages to Variables docs (#2567)
• Fixed broken link to Permalinks page (#2572)
• Update link to Windows installation guide (#2578)

v2.1.0

Minor Enhancements

• Bump to the latest Liquid version, 2.6.1 (#2495)
• Add support for JSON files in the _data directory (#2369)
• Allow subclasses to override EXCERPT_ATTRIBUTES_FOR_LIQUID (#2408)
• Add Jekyll.env and jekyll.environment (the Liquid var) (#2417)
• Use _config.yaml or _config.yml (.yml takes precedence) (#2406)
• Override collection url template (#2418)
• Allow subdirectories in _data (#2395)
• Extract Pagination Generator into gem: jekyll-paginate (#2455)
• Utilize date_to_rfc822 filter in site template (#2437)
• Add categories, last build datetime, and generator to site template
  feed (#2438)
• Configurable, replaceable Logger-compliant logger (#2444)
• Extract gist tag into a separate gem (#2469)
• Add collection attribute to Document#to_liquid to access the
  document's collection label. (#2436)
• Upgrade listen to 2.7.6 <= x < 3.0.0 (#2492)
• Allow configuration of different Twitter and GitHub usernames in site template (#2485)
• Bump Pygments to v0.6.0 (#2504)
• Front matter defaults for documents in collections (#2419)
• Include files with a url which ends in / in the site.html_pages list (#2524)
• Make highlight tag use language- prefix in CSS class (#2511)
• Lookup item property via item#to_liquid before #data or #[] in filters (#2493)
• Skip initial build of site on serve with flag (#2477)
• Add support for hl_lines in highlight tag (#2532)
• Spike out --watch flag into a separate gem (#2550)

Bug Fixes

• Liquid sort filter should sort even if one of the values is nil (#2345)
• Remove padding on pre code in the site template CSS (#2383)
• Set log_level earlier to silence info level configuration output (#2393)
• Only list pages which have title in site template (#2411)
• Accept Numeric values for dates, not Number values (#2377)
• Prevent code from overflowing container in site template (#2429)
• Encode URLs in UTF-8 when escaping and unescaping (#2420)
• No Layouts or Liquid for Asset Files (#2431)
• Allow front matter defaults to set post categories (#2373)
• Fix command in subcommand deprecation warning (#2457)
• Keep all parent directories of files/dirs in keep_files (#2458)
• When using RedCarpet and Rouge without Rouge installed, fixed erroneous
  error which stated that redcarpet was missing, not rouge. (#2464)
• Ignore all directories and files that merit it on auto-generation (#2459)
• Before copying file, explicitly remove the old one (#2535)
• Merge file system categories with categories from YAML. (#2531)
• Deep merge front matter defaults (#2490)
• Ensure exclude and include arrays are arrays of strings (#2542)
• Allow collections to have dots in their filenames (#2552)
• Collections shouldn't try to read in directories as files (#2552)
• Be quiet very quickly. (#2520)

Development Fixes

• Test Ruby 2.1.2 instead of 2.1.1 (#2374)
• Add test for sorting UTF-8 characters (#2384)
• Use https for GitHub links in documentation (#2470)
• Remove coverage reporting with Coveralls (#2494)
• Fix a bit of missing TomDoc to Jekyll::Commands::Build#build (#2554)

Site Enhancements

• Set timezone to America/Los_Angeles (#2394)
• Improve JavaScript in anchor_links.html (#2368)
• Remove note on Quickstart page about default markdown converter (#2387)
• Remove broken link in extras.md to a Maruku fork (#2401)
• Update Font Awesome to v4.1.0. (#2410)
• Fix broken link on Installation page to Templates page (#2421)
• Prevent table from extending parent width in permalink style table (#2424)
• Add collections to info about pagination support (#2389)
• Add jekyll_github_sample plugin to list of third-party plugins (#2463)
• Clarify documentation around front matter defaults and add details
  about defaults for collections. (#2439)
• Add Jekyll Project Version Tag to list of third-party plugins (#2468)
• Use https for GitHub links across whole site (#2470)
• Add StickerMule + Jekyll post (#2476)
• Add Jekyll Asset Pipeline Reborn to list of third-party plugins (#2479)
• Add link to jekyll-compress-html to list of third-party plugins (#2514)
• Add Piwigo Gallery to list of third-party plugins (#2526)
• Set show_drafts to false in default configuration listing (#2536)
• Provide an updated link for Windows installation instructions (#2544)
• Remove url from configuration docs (#2547)
• Documentation for Continuous Integration for your Jekyll Site (#2432)

v2.0.3

Bug Fixes

• Properly prefix links in site template with URL or baseurl depending upon
  need. (#2319)
• Update gist tag comments and error message to require username (#2326)
• Fix permalink setting in site template (#2331)
• Don't fail if any of the path objects are nil (#2325)
• Instantiate all descendants for converters and generators, not just
  direct subclasses (#2334)
• Replace all instances of site.name with site.title in site template (#2324)
• Jekyll::Filters#time now accepts UNIX timestamps in string or number form (#2339)
• Use item_property for where filter so it doesn't break on collections (#2359)
• Rescue errors thrown so --watch doesn't fail (#2364)

Site Enhancements

• Add missing "as" to assets docs page (#2337)
• Update docs to reflect new baseurl default (#2341)
• Add links to headers who have an ID. (#2342)
• Use symbol instead of HTML number in upgrading.md (#2351)
• Fix link to front matter defaults docs (#2353)
• Fix for History.markdown in order to fix history page in docs (#2363)

v2.0.2

Bug Fixes

• Correct use of url and baseurl in the site template. (#2317)
• Default baseurl to "" (#2317)

Site Enhancements

• Correct docs for the gist plugin so it always includes the username. (#2314)
• Clarify new (defaults, where filter) features in docs (#2316)

v2.0.1

Bug Fixes

• Require kramdown gem instead of maruku gem