From cb48bb8ee54afaedf0974e5ec7c9dd8f7bdaa89b Mon Sep 17 00:00:00 2001 From: Ashwin Maroli Date: Mon, 25 May 2020 21:12:09 +0530 Subject: [PATCH 01/11] Draft release post for v4.1 --- .../2020-05-25-jekyll-4-1-0-released.markdown | 41 +++++++++++++++++++ 1 file changed, 41 insertions(+) create mode 100644 docs/_posts/2020-05-25-jekyll-4-1-0-released.markdown diff --git a/docs/_posts/2020-05-25-jekyll-4-1-0-released.markdown b/docs/_posts/2020-05-25-jekyll-4-1-0-released.markdown new file mode 100644 index 00000000000..89fe635e231 --- /dev/null +++ b/docs/_posts/2020-05-25-jekyll-4-1-0-released.markdown @@ -0,0 +1,41 @@ +--- +title: 'Jekyll 4.1.0 Released' +date: 2020-05-25 19:25:30 +0530 +author: ashmaroli +version: 4.1.0 +category: release +--- + +Hello Jekyllers! + +It's time for yet another release that includes enhancements, optimizations and bug-fixes. Highlights of this release +are: + +* Jekyll now supports rendering excerpts for *pages* in addition to documents and posts. +* One may now use `:slugified_categories` in their permalink configurations to generate a more apt URL (categories are +downcased and non-alphanumeric characters replaced by dashes) for their for posts and documents. +* When you build a site with the `--profle` switch, Jekyll will now additionally output a small table showing the amount +of time taken during various stages of the *build process*. +* Jekyll's development server now supports certificates based on Elliptic-curve cryptography. +* The `where_exp` filter got enhanced. Earlier, one could just use either `and` or `or` once per expression. Now, one +may use those binary operators multiple times in the filter's expression. +* Jekyll has a new set of filters based on *its flavor* of the `where` and `where_exp` filters. Named `find` and +`find_exp` filters respectively, they work similar to their ancestors except that they return **the first object** that +satisfies the given conditions. +* Jekyll's `number_of_words` filter can now take [an optional argument][filters-docs] to better count words of text +containing Chinese, Japanese or Korean characters. +* The logic for *slugifying* a given string has been enhanced to support more Unicode characters. +* If you face issues from Jekyll importing a config file bundled within a theme, you can now disable the import entirely +by setting `ignore_theme_config: true` in your site's configuration file. +* If you face issues from Jekyll's disk-caching feature, you can now disable the mechanism without opting to build in +`safe` mode, by either setting `disable_disk_cache: true` in your configuration file or by passing the CLI switch +`--disable-disk-cache` to `jekyll build` or `jekyll serve` commands. + +For the interest of plugin authors: +* `Jekyll::Page` now uses a Liquid Drop to expose attributes for Liquid templates. However, its subclasses will continue +using the legacy `ATTRIBUTES_FOR_LIQUID` hash by default. More details in the [associated documentation][page-drop-docs] +* Excerpts won't be generated for `Jekyll::Page` subclasses automatically unless such instances have an `excerpt` key in +their `data` hash. + +[filters-docs]: {{ 'docs/liquid/filters/' | relative_url }} +[page-drop-docs]: {{ 'docs/pages/#for-plugin-developers' | relative_url }} From ba1fe40679b24649e2624c1ec7d6f3e32afdfa0e Mon Sep 17 00:00:00 2001 From: Ashwin Maroli Date: Wed, 27 May 2020 12:40:10 +0530 Subject: [PATCH 02/11] Note: newly generated theme gemspec and config.yml --- docs/_posts/2020-05-25-jekyll-4-1-0-released.markdown | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/docs/_posts/2020-05-25-jekyll-4-1-0-released.markdown b/docs/_posts/2020-05-25-jekyll-4-1-0-released.markdown index 89fe635e231..8fa89341a8c 100644 --- a/docs/_posts/2020-05-25-jekyll-4-1-0-released.markdown +++ b/docs/_posts/2020-05-25-jekyll-4-1-0-released.markdown @@ -39,3 +39,8 @@ their `data` hash. [filters-docs]: {{ 'docs/liquid/filters/' | relative_url }} [page-drop-docs]: {{ 'docs/pages/#for-plugin-developers' | relative_url }} + +For the interest of plugin authors: +* From `v4.1.0` onwards, a newly generated theme workspace (via `jekyll new-theme ...`) will have the gemspec configured +to bundle a `_config.yml` at the root of the workspace. If you don't wish to include the configuration file in the +released gem, please remove `|_config\.yml` from the regular expression in the gemspec. From 3aa594ac19de0995275da8d3662db93030209e0a Mon Sep 17 00:00:00 2001 From: Ashwin Maroli Date: Wed, 27 May 2020 12:57:30 +0530 Subject: [PATCH 03/11] Reorganize History document --- History.markdown | 76 ++++++++++++++++++++++++------------------------ 1 file changed, 38 insertions(+), 38 deletions(-) diff --git a/History.markdown b/History.markdown index aedb8ec6005..b871560bb3a 100644 --- a/History.markdown +++ b/History.markdown @@ -2,48 +2,57 @@ ### Bug Fixes - * Memoize absolute_url and relative_url filters (#7793) - * Fix documentation comment for Jekyll::Converters::Identity (#7883) - * Optimize Jekyll::Filters#item_property (#7696) - * Allow multiple binary operators in where_exp filter (#8047) + * Memoize `absolute_url` and `relative_url` filters (#7793) + * Fix documentation comment for `Jekyll::Converters::Identity` (#7883) + * Optimize `Jekyll::Filters#item_property` (#7696) + * Allow multiple binary operators in `where_exp` filter (#8047) * Fix documents custom-ordering logic (#8028) * Use `layout.path` when rendering the Liquid layout (#8069) * Reduce array allocations from `StaticFile#path` (#8083) * Simplify `Jekyll::Renderer#validate_layout` (#8064) - * Add static file's basename to its url_placeholder (#7908) + * Add static file's basename to its `url_placeholder` (#7908) * Clear cached Liquid template scope before render (#7967) - * Add slugified_categories URL placeholder (#8094) - * Cache URLFilter results of string inputs per site (#7990) - * Use platforms instead of install_if (#8140) + * Cache `URLFilter` results of string inputs per site (#7990) + * Use `platforms` instead of `install_if` in Gemfile (#8140) * Config include trailing slash (#8113) - * Allow extensionless document in a strict site (#7950) * Improve path normalization in liquid_renderer (#8075) * Switch slugify regex to support more Unicode character groups (#8167) * Check if entry is a directory once per enumerator (#8177) * Filter out exclusively excluded entries sooner (#7482) + * Return `relative_url` if site.url is an empty string (#7988) + * Configure kramdown toc_levels as array by default (#8015) + * Reduce `Pathname` objects from front matter defaults (#8067) + * Simplify `Jekyll::Hooks.trigger` logic (#8044) + * Quicker categories for documents without superdirs (#7987) + * Reduce `Jekyll::Renderer` instances during a build (#7570) + * Escape regex characters in paths to match (#8138) + * Provide invokables for common drop query keys (#8165) + * Optimize path sanitization of default front matter (#8154) + * Initialize static files' data hash only if needed (#8188) + * Initialize include-files as Jekyll objects (#8158) ### Minor Enhancements * serve: add support for ECC certificates (#7768) - * Update item_property to recognize integers (#7878) - * Include _config.yml in a new theme's gemspec (#7865) + * Update `item_property` to recognize integers (#7878) + * Include `_config.yml` in a new theme's gemspec (#7865) * Add an option to easily disable disk-cache (#7928) * Optimize markdown parsing with Kramdown by reusing the options and parser objects (#8013) - * Add PageDrop to provide Liquid templates with data (#7992) + * Add `PageDrop` to provide Liquid templates with data (#7992) * Optimize `Kramdown::JekyllDocument#to_html` calls (#8041) - * Reduce Jekyll::Renderer instances during a build (#7570) * Configure default language for syntax-highlighting (#8035) * Remove dev dependencies from new theme-gem gemspec (#8042) * Allow disabling import of theme configuration (#8131) - * Allow excerpts to be generated for Page objects (#7642) - * Profile various stages of a site's build process (#6760) + * Allow excerpts to be generated for `Page` objects (#7642) + * Profile various stages of a site's build process (#6760) * Add find filters to optimize where-first chains (#8171) - * Make number_of_words respect CJK characters (#7813) - * Initialize static files' data hash only if needed (#8188) + * Make `number_of_words` filter respect CJK characters (#7813) + * Allow extensionless document in a strict site (#7950) + * Add `:slugified_categories` URL placeholder (#8094) ### Documentation - * Add dropped 'title: Staff' to the code (#7805) + * Add dropped 'title: Staff' to the code (#7805) * Clarify docs for static files in collection (#7812) * Rephrase the CircleCI v2 section (#7815) * Update old GitHub wiki URL with new one (#7823) @@ -52,7 +61,7 @@ * Doc: minor fix, should be greater or equal to min version (#7856) * Update third-party.md - Fix broken link (#7857) * clarify _config.yml/collections type (#7873) - * Replace `` with html tag (#7879) + * Replace backticks with HTML tags in data file (#7879) * add new theme source (#7875) * fixed grammatical error (it's --> its) (#7887) * Docs: Clarify organizing pages into subfolders (#7896) @@ -61,23 +70,23 @@ * docs: add options for watch and force polling (#7918) * add install instructions for ArchLinux and openSUSE (#7920) * Improve index page of Jekyll documentation (#7926) - * Include path in jekyll new commands (Usage docs) (#7931) + * Include path in `jekyll new` commands (Usage docs) (#7931) * Change `affect` to `effect` in the collections docs (#7937) * Changed deprecated command in themes documentation (#7941) - * Adds some documentation for the :clean, :on_obsolete hook (#7954) + * Adds some documentation for the `:clean`, `:on_obsolete` hook (#7954) * docs: fix broken link (#7955) - * Corrected typo (#7975) + * Corrected typo (#7975) * docs: remove watch option in config (#7940) * Correct a sentence in the documentation (#7978) * Fix YAML representation of `group_by` result (#7979) - * Move --baseurl to build command options (#7985) + * Move `--baseurl` to build command options (#7985) * Correct documentation of filters (#7989) * Document sorting two documents by their `date` (#7870) - * Fix English grammar error. (#7994) + * Fix English grammar error (#7994) * Update 03-front-matter.md (#7996) * Add Kentico Kontent CMS integration to resources (#8000) * Update 07-assets.md (#7413) - * Fix file references in Step by Step Tutorial's Assets step (#8007) + * Fix file references in Step by Step Tutorial's Assets step (#8007) * docs: improve highlighting of code blocks (#8017) * remove leading slash from Sass file location (#8021) * [Docs] Fix asset link ref in step-by-step tutorial (#8026) @@ -103,7 +112,7 @@ * docs: update your-first-plugin.md (#8147) * Fix typo in documentation on GitHub Actions (#8162) * Ease discovery of CLI commands (in their entirety) (#8178) - * Remove sudo from Travis CI tutorial (#8187) + * Remove `sudo` from Travis CI tutorial (#8187) * Add Gitlab Pages to 3rd party list (#8191) * docs: add 21yunbox for deployment (#8193) * Improve documentation on tags and categories (#8196) @@ -112,32 +121,23 @@ * Ci/GitHub actions (#7822) * Rubocop version upgrade (#7846) - * Split action steps to avoid using `&&` on Windows (#7885) + * Split action steps to avoid using `&&` on Windows (#7885) * Upgrade rake to use version 13 (#7910) * Update dependency constraint to allow RuboCop v0.76 (#7893) * Use bash executable consistently (#7909) * Test with JRuby 9.2.9.0 (#7779) * Bump RuboCop to v0.79.x (#7970) * Remove post-install message from gemspec (#7974) - * Return relative_url if site.url is an empty string (#7988) * Attain Ruby 3.0 compatibility (#7948) * Test where filter handling numeric property values (#7821) * chore(deps): rubocop 0.80.0 (#8012) * Update unit tests for Kramdown-based converter (#8014) * Add Visual Studio Code Development Container (#8016) - * Configure kramdown toc_levels as array by default (#8015) - * Simplify Jekyll::Hooks.trigger logic (#8044) - * chore: simplify require for Jekyll::VERSION (#8057) + * chore: simplify require for `Jekyll::VERSION` (#8057) * Remove version-constraint relaxation for i18n gem (#8055) - * Mirror `spec.homepage` as `metadata["homepage_uri"]` (#8056) - * Reduce Pathname objects from front matter defaults (#8067) - * Quicker categories for documents without superdirs (#7987) + * Mirror `spec.homepage` as `metadata["homepage_uri"]` (#8056) * Bump Ruby versions on Travis builds (#8088) - * Escape regex characters in paths to match (#8138) * chore(ci): cache dependencies (#8168) - * Provide invokables for common drop query keys (#8165) - * Optimize path sanitization of default front matter (#8154) - * Initialize include-files as Jekyll objects (#8158) ### Site Enhancements From 3695a82a1935e83e6470eef07dd25c79bc0ad729 Mon Sep 17 00:00:00 2001 From: Frank Taillandier Date: Wed, 27 May 2020 10:14:06 +0200 Subject: [PATCH 04/11] docs: 4.1 contributors --- docs/_posts/2020-05-25-jekyll-4-1-0-released.markdown | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/docs/_posts/2020-05-25-jekyll-4-1-0-released.markdown b/docs/_posts/2020-05-25-jekyll-4-1-0-released.markdown index 8fa89341a8c..df7c0f8dc00 100644 --- a/docs/_posts/2020-05-25-jekyll-4-1-0-released.markdown +++ b/docs/_posts/2020-05-25-jekyll-4-1-0-released.markdown @@ -44,3 +44,10 @@ For the interest of plugin authors: * From `v4.1.0` onwards, a newly generated theme workspace (via `jekyll new-theme ...`) will have the gemspec configured to bundle a `_config.yml` at the root of the workspace. If you don't wish to include the configuration file in the released gem, please remove `|_config\.yml` from the regular expression in the gemspec. + +## Thanks you 🙇 + +We are thankful to our community for all the contributions that helped shape this release. +Special thanks to the 78 contributors who made this release possible and took the time to submit a pull request (in alphabetical order): + +Aaron Adams, Aaron K Redshaw, Alexandre Zanni, Anindita Basu, Arthur Zey, Artyom Tokachev, Ashwin Maroli, Atlas Cove, Ben Stolovitz, Billy Kong, Christian Oliff, codenitpicker, csquare, Damien St Pierre, Daniel Leidert, David Zhang, ddocs, dgolant, dkalev, Dmitry Egorov, dotnetCarpenter, Edward Thomson, Eric Knibbe, Frank Taillandier, Gabriel Rubens, Gareth Mcshane, Grzegorz Kaczorek, guanicoe, Harry Wood, HTeuMeuLeu, iBug, İsmail Arılık, Itay Shakury, Ivan Gromov, Ivan Raszl, J·Y, James Buckley, Jason Taylor, JC, jeffreytse, Johan Wigert, jonas-krummenacher, Justin Jia, Kayce Basques, Kieran Barker, Leo, Liam Bigelow, lizharris, Lizzy Kate, Luis Puente, Mark Bennett, Matt Penna, Matt Rogers, matt swanson, Max Chadwick, michaelcurrin, Mike Kasberg, Mike Neumegen, Muhammed Salih, Nikhil Benesch, Paramdeo Singh, Patrik Eriksson, Phil Nash, Philip Eriksson, R.P. Pedraza, Radoslav Karlík, Riccardo Porreca, sharath Kumar, Simone Arpe, Takashi Udagawa, Tobias Klüpfel, Toby Glei, vhermecz, Viktor Szakats, Ward Sandler, wzy, XhmikosR, Zlatan Vasović. From 225bb4bb9bbef489e32be3583c27be0ec71a7522 Mon Sep 17 00:00:00 2001 From: Ashwin Maroli Date: Wed, 27 May 2020 14:17:27 +0530 Subject: [PATCH 05/11] Fix remaining rendering bugs in History entries --- History.markdown | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/History.markdown b/History.markdown index b871560bb3a..e96158d77e5 100644 --- a/History.markdown +++ b/History.markdown @@ -129,7 +129,7 @@ * Bump RuboCop to v0.79.x (#7970) * Remove post-install message from gemspec (#7974) * Attain Ruby 3.0 compatibility (#7948) - * Test where filter handling numeric property values (#7821) + * Test `where` filter handling numeric property values (#7821) * chore(deps): rubocop 0.80.0 (#8012) * Update unit tests for Kramdown-based converter (#8014) * Add Visual Studio Code Development Container (#8016) @@ -142,10 +142,10 @@ ### Site Enhancements * Optimize rendering of the documentation site (#8020) - * Utilize relative_url filter in documentation site (#8089) + * Utilize `relative_url` filter in documentation site (#8089) * Render tutorial metadata in documentation site (#8092) * Improve syntax-highlighting in documentation site (#8079) - * Site: Filter through just the docs collection (#8170) + * Site: Filter through just the *docs* collection (#8170) ## 4.0.1 / 2020-05-08 From 13c43cbbf8fe83d7c901e6494d9e22aeab10f474 Mon Sep 17 00:00:00 2001 From: Ashwin Maroli Date: Wed, 27 May 2020 14:26:32 +0530 Subject: [PATCH 06/11] Improve formatting of release post --- .../2020-05-25-jekyll-4-1-0-released.markdown | 22 +++++++++++++------ 1 file changed, 15 insertions(+), 7 deletions(-) diff --git a/docs/_posts/2020-05-25-jekyll-4-1-0-released.markdown b/docs/_posts/2020-05-25-jekyll-4-1-0-released.markdown index df7c0f8dc00..5276921b44d 100644 --- a/docs/_posts/2020-05-25-jekyll-4-1-0-released.markdown +++ b/docs/_posts/2020-05-25-jekyll-4-1-0-released.markdown @@ -37,17 +37,25 @@ using the legacy `ATTRIBUTES_FOR_LIQUID` hash by default. More details in the [a * Excerpts won't be generated for `Jekyll::Page` subclasses automatically unless such instances have an `excerpt` key in their `data` hash. -[filters-docs]: {{ 'docs/liquid/filters/' | relative_url }} -[page-drop-docs]: {{ 'docs/pages/#for-plugin-developers' | relative_url }} - For the interest of plugin authors: * From `v4.1.0` onwards, a newly generated theme workspace (via `jekyll new-theme ...`) will have the gemspec configured to bundle a `_config.yml` at the root of the workspace. If you don't wish to include the configuration file in the released gem, please remove `|_config\.yml` from the regular expression in the gemspec. -## Thanks you 🙇 +[filters-docs]: {{ 'docs/liquid/filters/' | relative_url }} +[page-drop-docs]: {{ 'docs/pages/#for-plugin-developers' | relative_url }} We are thankful to our community for all the contributions that helped shape this release. -Special thanks to the 78 contributors who made this release possible and took the time to submit a pull request (in alphabetical order): - -Aaron Adams, Aaron K Redshaw, Alexandre Zanni, Anindita Basu, Arthur Zey, Artyom Tokachev, Ashwin Maroli, Atlas Cove, Ben Stolovitz, Billy Kong, Christian Oliff, codenitpicker, csquare, Damien St Pierre, Daniel Leidert, David Zhang, ddocs, dgolant, dkalev, Dmitry Egorov, dotnetCarpenter, Edward Thomson, Eric Knibbe, Frank Taillandier, Gabriel Rubens, Gareth Mcshane, Grzegorz Kaczorek, guanicoe, Harry Wood, HTeuMeuLeu, iBug, İsmail Arılık, Itay Shakury, Ivan Gromov, Ivan Raszl, J·Y, James Buckley, Jason Taylor, JC, jeffreytse, Johan Wigert, jonas-krummenacher, Justin Jia, Kayce Basques, Kieran Barker, Leo, Liam Bigelow, lizharris, Lizzy Kate, Luis Puente, Mark Bennett, Matt Penna, Matt Rogers, matt swanson, Max Chadwick, michaelcurrin, Mike Kasberg, Mike Neumegen, Muhammed Salih, Nikhil Benesch, Paramdeo Singh, Patrik Eriksson, Phil Nash, Philip Eriksson, R.P. Pedraza, Radoslav Karlík, Riccardo Porreca, sharath Kumar, Simone Arpe, Takashi Udagawa, Tobias Klüpfel, Toby Glei, vhermecz, Viktor Szakats, Ward Sandler, wzy, XhmikosR, Zlatan Vasović. +Special thanks to the following 78 contributors (in alphabetical order) who made this release possible and took the time +to submit a pull request: + +Aaron Adams, Aaron K Redshaw, Alexandre Zanni, Anindita Basu, Arthur Zey, Artyom Tokachev, Ashwin Maroli, Atlas Cove, +Ben Stolovitz, Billy Kong, Christian Oliff, codenitpicker, csquare, Damien St Pierre, Daniel Leidert, David Zhang, +ddocs, dgolant, dkalev, Dmitry Egorov, dotnetCarpenter, Edward Thomson, Eric Knibbe, Frank Taillandier, Gabriel Rubens, +Gareth Mcshane, Grzegorz Kaczorek, guanicoe, Harry Wood, HTeuMeuLeu, iBug, İsmail Arılık, Itay Shakury, Ivan Gromov, +Ivan Raszl, J·Y, James Buckley, Jason Taylor, JC, jeffreytse, Johan Wigert, jonas-krummenacher, Justin Jia, +Kayce Basques, Kieran Barker, Leo, Liam Bigelow, lizharris, Lizzy Kate, Luis Puente, Mark Bennett, Matt Penna, +Matt Rogers, matt swanson, Max Chadwick, michaelcurrin, Mike Kasberg, Mike Neumegen, Muhammed Salih, Nikhil Benesch, +Paramdeo Singh, Patrik Eriksson, Phil Nash, Philip Eriksson, R.P. Pedraza, Radoslav Karlík, Riccardo Porreca, +sharath Kumar, Simone Arpe, Takashi Udagawa, Tobias Klüpfel, Toby Glei, vhermecz, Viktor Szakats, Ward Sandler, wzy, +XhmikosR, Zlatan Vasović. From 33ac02b1eb8a48c45419fb4369a404557e93a036 Mon Sep 17 00:00:00 2001 From: Ashwin Maroli Date: Wed, 27 May 2020 14:36:29 +0530 Subject: [PATCH 07/11] Correct typo in release post --- docs/_posts/2020-05-25-jekyll-4-1-0-released.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/_posts/2020-05-25-jekyll-4-1-0-released.markdown b/docs/_posts/2020-05-25-jekyll-4-1-0-released.markdown index 5276921b44d..360ec8501aa 100644 --- a/docs/_posts/2020-05-25-jekyll-4-1-0-released.markdown +++ b/docs/_posts/2020-05-25-jekyll-4-1-0-released.markdown @@ -37,7 +37,7 @@ using the legacy `ATTRIBUTES_FOR_LIQUID` hash by default. More details in the [a * Excerpts won't be generated for `Jekyll::Page` subclasses automatically unless such instances have an `excerpt` key in their `data` hash. -For the interest of plugin authors: +For the interest of gem-based theme authors: * From `v4.1.0` onwards, a newly generated theme workspace (via `jekyll new-theme ...`) will have the gemspec configured to bundle a `_config.yml` at the root of the workspace. If you don't wish to include the configuration file in the released gem, please remove `|_config\.yml` from the regular expression in the gemspec. From 41d897936a95c32e48535ee24cc0c587abacd264 Mon Sep 17 00:00:00 2001 From: Frank Taillandier Date: Wed, 27 May 2020 11:26:10 +0200 Subject: [PATCH 08/11] docs: group changes 1. Liquid changes 2. Configuration changes 3. CLI related changes --- docs/_posts/2020-05-25-jekyll-4-1-0-released.markdown | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/docs/_posts/2020-05-25-jekyll-4-1-0-released.markdown b/docs/_posts/2020-05-25-jekyll-4-1-0-released.markdown index 360ec8501aa..bf958fe4f16 100644 --- a/docs/_posts/2020-05-25-jekyll-4-1-0-released.markdown +++ b/docs/_posts/2020-05-25-jekyll-4-1-0-released.markdown @@ -12,11 +12,6 @@ It's time for yet another release that includes enhancements, optimizations and are: * Jekyll now supports rendering excerpts for *pages* in addition to documents and posts. -* One may now use `:slugified_categories` in their permalink configurations to generate a more apt URL (categories are -downcased and non-alphanumeric characters replaced by dashes) for their for posts and documents. -* When you build a site with the `--profle` switch, Jekyll will now additionally output a small table showing the amount -of time taken during various stages of the *build process*. -* Jekyll's development server now supports certificates based on Elliptic-curve cryptography. * The `where_exp` filter got enhanced. Earlier, one could just use either `and` or `or` once per expression. Now, one may use those binary operators multiple times in the filter's expression. * Jekyll has a new set of filters based on *its flavor* of the `where` and `where_exp` filters. Named `find` and @@ -24,12 +19,17 @@ may use those binary operators multiple times in the filter's expression. satisfies the given conditions. * Jekyll's `number_of_words` filter can now take [an optional argument][filters-docs] to better count words of text containing Chinese, Japanese or Korean characters. +* One may now use `:slugified_categories` in their permalink configurations to generate a more apt URL (categories are +downcased and non-alphanumeric characters replaced by dashes) for their for posts and documents. * The logic for *slugifying* a given string has been enhanced to support more Unicode characters. * If you face issues from Jekyll importing a config file bundled within a theme, you can now disable the import entirely by setting `ignore_theme_config: true` in your site's configuration file. * If you face issues from Jekyll's disk-caching feature, you can now disable the mechanism without opting to build in `safe` mode, by either setting `disable_disk_cache: true` in your configuration file or by passing the CLI switch `--disable-disk-cache` to `jekyll build` or `jekyll serve` commands. +* When you build a site with the `--profile` switch, Jekyll will now additionally output a small table showing the amount +of time taken during various stages of the *build process*. +* Jekyll's development server now supports certificates based on Elliptic-curve cryptography. For the interest of plugin authors: * `Jekyll::Page` now uses a Liquid Drop to expose attributes for Liquid templates. However, its subclasses will continue From 65dd4c9dffc8b202fb6acab242550797d675a19e Mon Sep 17 00:00:00 2001 From: Ashwin Maroli Date: Wed, 27 May 2020 15:06:31 +0530 Subject: [PATCH 09/11] Add headings and link to community forum --- docs/_posts/2020-05-25-jekyll-4-1-0-released.markdown | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/docs/_posts/2020-05-25-jekyll-4-1-0-released.markdown b/docs/_posts/2020-05-25-jekyll-4-1-0-released.markdown index bf958fe4f16..727e4c14a68 100644 --- a/docs/_posts/2020-05-25-jekyll-4-1-0-released.markdown +++ b/docs/_posts/2020-05-25-jekyll-4-1-0-released.markdown @@ -45,6 +45,14 @@ released gem, please remove `|_config\.yml` from the regular expression in the g [filters-docs]: {{ 'docs/liquid/filters/' | relative_url }} [page-drop-docs]: {{ 'docs/pages/#for-plugin-developers' | relative_url }} + +### Have questions? + +Please reach out on our [community forum](https://talk.jekyllrb.com) + + +### Thank you!! :bow: + We are thankful to our community for all the contributions that helped shape this release. Special thanks to the following 78 contributors (in alphabetical order) who made this release possible and took the time to submit a pull request: From 575e0f29486ea912dd21d3654d83eae570887539 Mon Sep 17 00:00:00 2001 From: Ashwin Maroli Date: Wed, 27 May 2020 15:24:27 +0530 Subject: [PATCH 10/11] Update Release Post date and path --- ...eased.markdown => 2020-05-27-jekyll-4-1-0-released.markdown} | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) rename docs/_posts/{2020-05-25-jekyll-4-1-0-released.markdown => 2020-05-27-jekyll-4-1-0-released.markdown} (99%) diff --git a/docs/_posts/2020-05-25-jekyll-4-1-0-released.markdown b/docs/_posts/2020-05-27-jekyll-4-1-0-released.markdown similarity index 99% rename from docs/_posts/2020-05-25-jekyll-4-1-0-released.markdown rename to docs/_posts/2020-05-27-jekyll-4-1-0-released.markdown index 727e4c14a68..ea2bc73c01b 100644 --- a/docs/_posts/2020-05-25-jekyll-4-1-0-released.markdown +++ b/docs/_posts/2020-05-27-jekyll-4-1-0-released.markdown @@ -1,6 +1,6 @@ --- title: 'Jekyll 4.1.0 Released' -date: 2020-05-25 19:25:30 +0530 +date: 2020-05-27 15:20:30 +0530 author: ashmaroli version: 4.1.0 category: release From 682be823143e8cee98726814999334613f2f69b6 Mon Sep 17 00:00:00 2001 From: Ashwin Maroli Date: Wed, 27 May 2020 15:25:02 +0530 Subject: [PATCH 11/11] Set today's date in History docs --- History.markdown | 2 +- docs/_docs/history.md | 155 ++++++++++++++++++++++++++++++++++++++++++ 2 files changed, 156 insertions(+), 1 deletion(-) diff --git a/History.markdown b/History.markdown index e96158d77e5..2fbc14290ac 100644 --- a/History.markdown +++ b/History.markdown @@ -1,4 +1,4 @@ -## HEAD +## 4.1.0 / 2020-05-27 ### Bug Fixes diff --git a/docs/_docs/history.md b/docs/_docs/history.md index b0d047e7438..07c6de460e2 100644 --- a/docs/_docs/history.md +++ b/docs/_docs/history.md @@ -4,6 +4,161 @@ permalink: "/docs/history/" note: This file is autogenerated. Edit /History.markdown instead. --- +## 4.1.0 / 2020-05-27 +{: #v4-1-0} + +### Bug Fixes +{: #bug-fixes-v4-1-0} + +- Memoize `absolute_url` and `relative_url` filters ([#7793]({{ site.repository }}/issues/7793)) +- Fix documentation comment for `Jekyll::Converters::Identity` ([#7883]({{ site.repository }}/issues/7883)) +- Optimize `Jekyll::Filters#item_property` ([#7696]({{ site.repository }}/issues/7696)) +- Allow multiple binary operators in `where_exp` filter ([#8047]({{ site.repository }}/issues/8047)) +- Fix documents custom-ordering logic ([#8028]({{ site.repository }}/issues/8028)) +- Use `layout.path` when rendering the Liquid layout ([#8069]({{ site.repository }}/issues/8069)) +- Reduce array allocations from `StaticFile#path` ([#8083]({{ site.repository }}/issues/8083)) +- Simplify `Jekyll::Renderer#validate_layout` ([#8064]({{ site.repository }}/issues/8064)) +- Add static file's basename to its `url_placeholder` ([#7908]({{ site.repository }}/issues/7908)) +- Clear cached Liquid template scope before render ([#7967]({{ site.repository }}/issues/7967)) +- Cache `URLFilter` results of string inputs per site ([#7990]({{ site.repository }}/issues/7990)) +- Use `platforms` instead of `install_if` in Gemfile ([#8140]({{ site.repository }}/issues/8140)) +- Config include trailing slash ([#8113]({{ site.repository }}/issues/8113)) +- Improve path normalization in liquid_renderer ([#8075]({{ site.repository }}/issues/8075)) +- Switch slugify regex to support more Unicode character groups ([#8167]({{ site.repository }}/issues/8167)) +- Check if entry is a directory once per enumerator ([#8177]({{ site.repository }}/issues/8177)) +- Filter out exclusively excluded entries sooner ([#7482]({{ site.repository }}/issues/7482)) +- Return `relative_url` if site.url is an empty string ([#7988]({{ site.repository }}/issues/7988)) +- Configure kramdown toc_levels as array by default ([#8015]({{ site.repository }}/issues/8015)) +- Reduce `Pathname` objects from front matter defaults ([#8067]({{ site.repository }}/issues/8067)) +- Simplify `Jekyll::Hooks.trigger` logic ([#8044]({{ site.repository }}/issues/8044)) +- Quicker categories for documents without superdirs ([#7987]({{ site.repository }}/issues/7987)) +- Reduce `Jekyll::Renderer` instances during a build ([#7570]({{ site.repository }}/issues/7570)) +- Escape regex characters in paths to match ([#8138]({{ site.repository }}/issues/8138)) +- Provide invokables for common drop query keys ([#8165]({{ site.repository }}/issues/8165)) +- Optimize path sanitization of default front matter ([#8154]({{ site.repository }}/issues/8154)) +- Initialize static files' data hash only if needed ([#8188]({{ site.repository }}/issues/8188)) +- Initialize include-files as Jekyll objects ([#8158]({{ site.repository }}/issues/8158)) + +### Minor Enhancements +{: #minor-enhancements-v4-1-0} + +- serve: add support for ECC certificates ([#7768]({{ site.repository }}/issues/7768)) +- Update `item_property` to recognize integers ([#7878]({{ site.repository }}/issues/7878)) +- Include `_config.yml` in a new theme's gemspec ([#7865]({{ site.repository }}/issues/7865)) +- Add an option to easily disable disk-cache ([#7928]({{ site.repository }}/issues/7928)) +- Optimize markdown parsing with Kramdown by reusing the options and parser objects ([#8013]({{ site.repository }}/issues/8013)) +- Add `PageDrop` to provide Liquid templates with data ([#7992]({{ site.repository }}/issues/7992)) +- Optimize `Kramdown::JekyllDocument#to_html` calls ([#8041]({{ site.repository }}/issues/8041)) +- Configure default language for syntax-highlighting ([#8035]({{ site.repository }}/issues/8035)) +- Remove dev dependencies from new theme-gem gemspec ([#8042]({{ site.repository }}/issues/8042)) +- Allow disabling import of theme configuration ([#8131]({{ site.repository }}/issues/8131)) +- Allow excerpts to be generated for `Page` objects ([#7642]({{ site.repository }}/issues/7642)) +- Profile various stages of a site's build process ([#6760]({{ site.repository }}/issues/6760)) +- Add find filters to optimize where-first chains ([#8171]({{ site.repository }}/issues/8171)) +- Make `number_of_words` filter respect CJK characters ([#7813]({{ site.repository }}/issues/7813)) +- Allow extensionless document in a strict site ([#7950]({{ site.repository }}/issues/7950)) +- Add `:slugified_categories` URL placeholder ([#8094]({{ site.repository }}/issues/8094)) + +### Documentation + +- Add dropped 'title: Staff' to the code ([#7805]({{ site.repository }}/issues/7805)) +- Clarify docs for static files in collection ([#7812]({{ site.repository }}/issues/7812)) +- Rephrase the CircleCI v2 section ([#7815]({{ site.repository }}/issues/7815)) +- Update old GitHub wiki URL with new one ([#7823]({{ site.repository }}/issues/7823)) +- Update JekyllConf page with 2019 talks ([#7826]({{ site.repository }}/issues/7826)) +- link for memberships ([#7825]({{ site.repository }}/issues/7825)) +- Doc: minor fix, should be greater or equal to min version ([#7856]({{ site.repository }}/issues/7856)) +- Update third-party.md - Fix broken link ([#7857]({{ site.repository }}/issues/7857)) +- clarify _config.yml/collections type ([#7873]({{ site.repository }}/issues/7873)) +- Replace backticks with HTML tags in data file ([#7879]({{ site.repository }}/issues/7879)) +- add new theme source ([#7875]({{ site.repository }}/issues/7875)) +- fixed grammatical error (it's --> its) ([#7887]({{ site.repository }}/issues/7887)) +- Docs: Clarify organizing pages into subfolders ([#7896]({{ site.repository }}/issues/7896)) +- Disambiguate the placeholder of permalink ([#7906]({{ site.repository }}/issues/7906)) +- docs: add short serve command for livereload ([#7919]({{ site.repository }}/issues/7919)) +- docs: add options for watch and force polling ([#7918]({{ site.repository }}/issues/7918)) +- add install instructions for ArchLinux and openSUSE ([#7920]({{ site.repository }}/issues/7920)) +- Improve index page of Jekyll documentation ([#7926]({{ site.repository }}/issues/7926)) +- Include path in `jekyll new` commands (Usage docs) ([#7931]({{ site.repository }}/issues/7931)) +- Change `affect` to `effect` in the collections docs ([#7937]({{ site.repository }}/issues/7937)) +- Changed deprecated command in themes documentation ([#7941]({{ site.repository }}/issues/7941)) +- Adds some documentation for the `:clean`, `:on_obsolete` hook ([#7954]({{ site.repository }}/issues/7954)) +- docs: fix broken link ([#7955]({{ site.repository }}/issues/7955)) +- Corrected typo ([#7975]({{ site.repository }}/issues/7975)) +- docs: remove watch option in config ([#7940]({{ site.repository }}/issues/7940)) +- Correct a sentence in the documentation ([#7978]({{ site.repository }}/issues/7978)) +- Fix YAML representation of `group_by` result ([#7979]({{ site.repository }}/issues/7979)) +- Move `--baseurl` to build command options ([#7985]({{ site.repository }}/issues/7985)) +- Correct documentation of filters ([#7989]({{ site.repository }}/issues/7989)) +- Document sorting two documents by their `date` ([#7870]({{ site.repository }}/issues/7870)) +- Fix English grammar error ([#7994]({{ site.repository }}/issues/7994)) +- Update 03-front-matter.md ([#7996]({{ site.repository }}/issues/7996)) +- Add Kentico Kontent CMS integration to resources ([#8000]({{ site.repository }}/issues/8000)) +- Update 07-assets.md ([#7413]({{ site.repository }}/issues/7413)) +- Fix file references in Step by Step Tutorial's Assets step ([#8007]({{ site.repository }}/issues/8007)) +- docs: improve highlighting of code blocks ([#8017]({{ site.repository }}/issues/8017)) +- remove leading slash from Sass file location ([#8021]({{ site.repository }}/issues/8021)) +- [Docs] Fix asset link ref in step-by-step tutorial ([#8026]({{ site.repository }}/issues/8026)) +- Corrected command to modify PATH ([#8029]({{ site.repository }}/issues/8029)) +- Corrected command to modify PATH ([#8030]({{ site.repository }}/issues/8030)) +- Docs: Render full contents of just the latest post ([#8032]({{ site.repository }}/issues/8032)) +- docs: improvements for note boxes ([#8037]({{ site.repository }}/issues/8037)) +- Non-deprecated `vendor/bundle` path configuration ([#8048]({{ site.repository }}/issues/8048)) +- Update 09-collections.md ([#8060]({{ site.repository }}/issues/8060)) +- Remove extra paragraph tags ([#8063]({{ site.repository }}/issues/8063)) +- Add default front matter for tutorials collection ([#8081]({{ site.repository }}/issues/8081)) +- Create CSV to table tutorial ([#8090]({{ site.repository }}/issues/8090)) +- Add version badge for Custom Sorting of Documents ([#8098]({{ site.repository }}/issues/8098)) +- Docs: Fix grammar in `_docs/front-matter.md` ([#8097]({{ site.repository }}/issues/8097)) +- Update variables.md ([#8106]({{ site.repository }}/issues/8106)) +- Add help about Gentoo/Linux ([#8002]({{ site.repository }}/issues/8002)) +- Update documentation on third party site ([#8122]({{ site.repository }}/issues/8122)) +- Added Clear Linux ([#8132]({{ site.repository }}/issues/8132)) +- Added note about OS specific installation instructions. ([#8135]({{ site.repository }}/issues/8135)) +- Fix broken URL in the Resources Page on the Documentation Site ([#8136]({{ site.repository }}/issues/8136)) +- Docs: Deploy Jekyll site with GitHub Actions ([#8119]({{ site.repository }}/issues/8119)) +- Clarify `bundle config` in Bundler tutorial ([#8150]({{ site.repository }}/issues/8150)) +- docs: update your-first-plugin.md ([#8147]({{ site.repository }}/issues/8147)) +- Fix typo in documentation on GitHub Actions ([#8162]({{ site.repository }}/issues/8162)) +- Ease discovery of CLI commands (in their entirety) ([#8178]({{ site.repository }}/issues/8178)) +- Remove `sudo` from Travis CI tutorial ([#8187]({{ site.repository }}/issues/8187)) +- Add Gitlab Pages to 3rd party list ([#8191]({{ site.repository }}/issues/8191)) +- docs: add 21yunbox for deployment ([#8193]({{ site.repository }}/issues/8193)) +- Improve documentation on tags and categories ([#8196]({{ site.repository }}/issues/8196)) + +### Development Fixes +{: #development-fixes-v4-1-0} + +- Ci/GitHub actions ([#7822]({{ site.repository }}/issues/7822)) +- Rubocop version upgrade ([#7846]({{ site.repository }}/issues/7846)) +- Split action steps to avoid using `&&` on Windows ([#7885]({{ site.repository }}/issues/7885)) +- Upgrade rake to use version 13 ([#7910]({{ site.repository }}/issues/7910)) +- Update dependency constraint to allow RuboCop v0.76 ([#7893]({{ site.repository }}/issues/7893)) +- Use bash executable consistently ([#7909]({{ site.repository }}/issues/7909)) +- Test with JRuby 9.2.9.0 ([#7779]({{ site.repository }}/issues/7779)) +- Bump RuboCop to v0.79.x ([#7970]({{ site.repository }}/issues/7970)) +- Remove post-install message from gemspec ([#7974]({{ site.repository }}/issues/7974)) +- Attain Ruby 3.0 compatibility ([#7948]({{ site.repository }}/issues/7948)) +- Test `where` filter handling numeric property values ([#7821]({{ site.repository }}/issues/7821)) +- chore(deps): rubocop 0.80.0 ([#8012]({{ site.repository }}/issues/8012)) +- Update unit tests for Kramdown-based converter ([#8014]({{ site.repository }}/issues/8014)) +- Add Visual Studio Code Development Container ([#8016]({{ site.repository }}/issues/8016)) +- chore: simplify require for `Jekyll::VERSION` ([#8057]({{ site.repository }}/issues/8057)) +- Remove version-constraint relaxation for i18n gem ([#8055]({{ site.repository }}/issues/8055)) +- Mirror `spec.homepage` as `metadata["homepage_uri"]` ([#8056]({{ site.repository }}/issues/8056)) +- Bump Ruby versions on Travis builds ([#8088]({{ site.repository }}/issues/8088)) +- chore(ci): cache dependencies ([#8168]({{ site.repository }}/issues/8168)) + +### Site Enhancements +{: #site-enhancements-v4-1-0} + +- Optimize rendering of the documentation site ([#8020]({{ site.repository }}/issues/8020)) +- Utilize `relative_url` filter in documentation site ([#8089]({{ site.repository }}/issues/8089)) +- Render tutorial metadata in documentation site ([#8092]({{ site.repository }}/issues/8092)) +- Improve syntax-highlighting in documentation site ([#8079]({{ site.repository }}/issues/8079)) +- Site: Filter through just the *docs* collection ([#8170]({{ site.repository }}/issues/8170)) + + ## 4.0.1 / 2020-05-08 {: #v4-0-1}