Prep for v1.8.0 release (#193)

* Sun Oct 29 17:52:29 MDT 2023

* readme updates and sitemap generation. More word prep.

* added raw tags help with rendering

* Mon Mar  4 08:57:59 MST 2024

* updates to subprocess testing, obfusk site additions

* v1.8.0 prep

* posts for v1.8.0

* update lockfile

* commit updated website

Author: untra

Gemfile.lock

@@ -1,32 +1,35 @@
 PATH
   remote: .
   specs:
-    jekyll-polyglot (1.7.0)
+    jekyll-polyglot (1.8.0)
       jekyll (>= 4.0, >= 3.0)
 
 GEM
   remote: https://rubygems.org/
   specs:
-    addressable (2.8.5)
+    addressable (2.8.6)
       public_suffix (>= 2.0.2, < 6.0)
     ast (2.4.2)
     colorator (1.1.0)
-    concurrent-ruby (1.2.2)
-    diff-lcs (1.5.0)
+    concurrent-ruby (1.2.3)
+    diff-lcs (1.5.1)
     em-websocket (0.5.3)
       eventmachine (>= 0.12.9)
       http_parser.rb (~> 0)
     eventmachine (1.2.7)
     ffi (1.16.3)
     ffi (1.16.3-x64-mingw-ucrt)
     forwardable-extended (2.6.0)
-    google-protobuf (3.24.4)
-    google-protobuf (3.24.4-x64-mingw-ucrt)
-    google-protobuf (3.24.4-x86_64-darwin)
+    google-protobuf (4.26.0)
+      rake (>= 13)
+    google-protobuf (4.26.0-x64-mingw-ucrt)
+      rake (>= 13)
+    google-protobuf (4.26.0-x86_64-darwin)
+      rake (>= 13)
     http_parser.rb (0.8.0)
-    i18n (1.14.1)
+    i18n (1.14.4)
       concurrent-ruby (~> 1.0)
-    jekyll (4.3.2)
+    jekyll (4.3.3)
       addressable (~> 2.4)
       colorator (~> 1.0)
       em-websocket (~> 0.5)
@@ -49,77 +52,79 @@ GEM
       sass-embedded (~> 1.54)
     jekyll-watch (2.2.1)
       listen (~> 3.0)
-    json (2.6.3)
+    json (2.7.1)
     kramdown (2.4.0)
       rexml
     kramdown-parser-gfm (1.1.0)
       kramdown (~> 2.0)
+    language_server-protocol (3.17.0.3)
     liquid (4.0.4)
-    listen (3.8.0)
+    listen (3.9.0)
       rb-fsevent (~> 0.10, >= 0.10.3)
       rb-inotify (~> 0.9, >= 0.9.10)
     mercenary (0.4.0)
     mini_portile2 (2.8.5)
-    minitest (5.16.3)
-    nokogiri (1.15.4)
+    minitest (5.22.3)
+    nokogiri (1.16.3)
       mini_portile2 (~> 2.8.2)
       racc (~> 1.4)
-    nokogiri (1.15.4-x64-mingw-ucrt)
+    nokogiri (1.16.3-x64-mingw-ucrt)
       racc (~> 1.4)
-    nokogiri (1.15.4-x86_64-darwin)
+    nokogiri (1.16.3-x86_64-darwin)
       racc (~> 1.4)
-    parallel (1.23.0)
-    parser (3.2.2.4)
+    parallel (1.24.0)
+    parser (3.3.0.5)
       ast (~> 2.4.1)
       racc
     pathutil (0.16.2)
       forwardable-extended (~> 2.6)
-    public_suffix (5.0.3)
-    racc (1.7.1)
+    public_suffix (5.0.4)
+    racc (1.7.3)
     rainbow (3.1.1)
-    rake (13.0.6)
+    rake (13.1.0)
     rb-fsevent (0.11.2)
     rb-inotify (0.10.1)
       ffi (~> 1.0)
-    regexp_parser (2.8.1)
+    regexp_parser (2.9.0)
     rexml (3.2.6)
-    rouge (4.1.3)
-    rspec (3.11.0)
-      rspec-core (~> 3.11.0)
-      rspec-expectations (~> 3.11.0)
-      rspec-mocks (~> 3.11.0)
-    rspec-core (3.11.0)
-      rspec-support (~> 3.11.0)
-    rspec-expectations (3.11.1)
+    rouge (4.2.0)
+    rspec (3.13.0)
+      rspec-core (~> 3.13.0)
+      rspec-expectations (~> 3.13.0)
+      rspec-mocks (~> 3.13.0)
+    rspec-core (3.13.0)
+      rspec-support (~> 3.13.0)
+    rspec-expectations (3.13.0)
       diff-lcs (>= 1.2.0, < 2.0)
-      rspec-support (~> 3.11.0)
-    rspec-mocks (3.11.2)
+      rspec-support (~> 3.13.0)
+    rspec-mocks (3.13.0)
       diff-lcs (>= 1.2.0, < 2.0)
-      rspec-support (~> 3.11.0)
-    rspec-support (3.11.1)
+      rspec-support (~> 3.13.0)
+    rspec-support (3.13.1)
     rspec_junit_formatter (0.6.0)
       rspec-core (>= 2, < 4, != 2.12.0)
-    rubocop (1.36.0)
+    rubocop (1.62.1)
       json (~> 2.3)
+      language_server-protocol (>= 3.17.0)
       parallel (~> 1.10)
-      parser (>= 3.1.2.1)
+      parser (>= 3.3.0.2)
       rainbow (>= 2.2.2, < 4.0)
       regexp_parser (>= 1.8, < 3.0)
       rexml (>= 3.2.5, < 4.0)
-      rubocop-ast (>= 1.20.1, < 2.0)
+      rubocop-ast (>= 1.31.1, < 2.0)
       ruby-progressbar (~> 1.7)
-      unicode-display_width (>= 1.4.0, < 3.0)
-    rubocop-ast (1.29.0)
-      parser (>= 3.2.1.0)
+      unicode-display_width (>= 2.4.0, < 3.0)
+    rubocop-ast (1.31.2)
+      parser (>= 3.3.0.4)
     ruby-progressbar (1.13.0)
     safe_yaml (1.0.5)
-    sass-embedded (1.68.0)
-      google-protobuf (~> 3.23)
+    sass-embedded (1.72.0)
+      google-protobuf (>= 3.25, < 5.0)
       rake (>= 13.0.0)
-    sass-embedded (1.68.0-x64-mingw-ucrt)
-      google-protobuf (~> 3.23)
-    sass-embedded (1.68.0-x86_64-darwin)
-      google-protobuf (~> 3.23)
+    sass-embedded (1.72.0-x64-mingw-ucrt)
+      google-protobuf (>= 3.25, < 5.0)
+    sass-embedded (1.72.0-x86_64-darwin)
+      google-protobuf (>= 3.25, < 5.0)
     terminal-table (3.0.2)
       unicode-display_width (>= 1.1.1, < 3)
     unicode-display_width (2.5.0)

README.md

@@ -69,10 +69,10 @@ In short:
 
 
 ### Translation permalink information in page
-_New in 1.7.1_
+_New in 1.8.0_
 
 Whenever `page_id` frontmatter properties are used to identify translations, permalink information for the available languages is available in `permalink_lang`.
-This is useful in order to generate language menus and even localization meta information without redirections!
+This is useful in order to generate language menus and even localization meta information without redirects!
 
 Sample code for meta link generation:
 ```
@@ -177,8 +177,7 @@ Combine with a [html minifier](https://github.com/digitalsparky/jekyll-minifier)
 ### Exclusive site language generation
 _New in 1.4.0_
 
-If you want to control which languages a document can be generated for, you can specify `lang-exclusive: [ ]` frontmatter.
-If you include this frontmatter in your post, it will only generate for the specified site languages.
+If you want to control which languages a document can be generated for, you can specify `lang-exclusive: [ ]` frontmatter. If you include this frontmatter in your post, it will only generate for the specified site languages.
 
 For Example, the following frontmatter will only generate in the `en` and `fr` site language builds:
 ```
@@ -234,6 +233,16 @@ This plugin makes modifications to existing Jekyll classes and modules, namely `
 
 `Jekyll::Site.process` is the entry point for the Jekyll build process. Take care whatever other plugins you use do not also attempt to overwrite this method. You may have problems.
 
+### (:polyglot, :post_write) hook
+_New in 1.8.0_
+Polyglot issues a `:polyglot, :post_write` hook event once all languages have been built for the site. This hook runs exactly once, after all site languages been processed:
+
+```rb
+Jekyll::Hooks.register :polyglot, :post_write do |site|
+  # do something custom and cool here!
+end
+```
+
 ### Machine-aware site building
 _New in 1.5.0_
 
@@ -244,7 +253,6 @@ _:wave: I need assistance with modern ruby best practices for test maintenance w
 
 Tests are run with `bundle exec rake`. Tests are in the `/spec` directory, and test failure output detail can be examined in the `rspec.xml` file.
 
-
 ## Features
 This plugin stands out from other I18n Jekyll plugins.
 - automatically corrects your relative links, keeping your *french* visitors on your *french* website, even when content has to fallback to the `default_lang`.
@@ -260,19 +268,9 @@ This plugin stands out from other I18n Jekyll plugins.
 ## SEO Recipes
 Jekyll-polyglot has a few spectacular [Search Engine Optimization techniques](https://untra.github.io/polyglot/seo) to ensure your Jekyll blog gets the most out of its multilingual audience. Check them out!
 
-### Other Websites Built with Polyglot
-Feel free to open a PR and list your multilingual blog here you may want to share:
+### Sitemap generation
 
-* [Polyglot project website](https://polyglot.untra.io)
-* [LogRhythm Corporate Website](https://logrhythm.com)
-* [All Over Earth](https://allover.earth/)
-* [Hanare Cafe in Toshijima, Japan](https://hanarecafe.com)
-* [F-Droid](https://f-droid.org)
-* [Ubuntu MATE](https://ubuntu-mate.org)
-* [Leo3418 blog](https://leo3418.github.io/)
-* [Gaphor](https://gaphor.org)
-* [Yi Yunseok's personal blog website](https://Yi-Yunseok.GitHub.io)
-* [A beautiful, simple, clean, and responsive Jekyll theme for academics](https://github.com/george-gca/multi-language-al-folio)
+See the example [sitemap.xml](/site/sitemap.xml) and [robots.txt](/site/robots.txt) for how to automatically generate a multi-language sitemap for your page and turn it in for the SEO i18n credit.
 
 ## Compatibility
 Currently supports Jekyll 3.0 , and Jekyll 4.0
@@ -289,6 +287,34 @@ Please! I need all the support I can get! 🙏
 But for real I would appreciate any code contributions and support. This started as an open-source side-project and has gotten bigger than I'd ever imagine!
 If you have something you'd like to contribute to jekyll-polyglot, please open a PR!
 
+### Contributors
+These are talented and considerate software developers across the world that have lent their support to this project.
+**Thank You! ¡Gracias! Merci! Danke! 감사합니다! תודה רבה! Спасибо! Dankjewel! 谢谢！Obrigado!**
+
+* [@jerturowetz](https://github.com/jerturowetz) 1.7.1
+* [@antoniovazquezblanco](https://github.com/antoniovazquezblanco) [1.7.0](https://polyglot.untra.io/2023/10/29/polyglot-1.7.0/)
+* [@salinatedcoffee](https://github.com/SalinatedCoffee) [ko support](https://polyglot.untra.io/2023/02/27/korean-support/)
+* [@aturret](https://github.com/aturret) [zh-CN support](https://polyglot.untra.io/2023/06/08/polyglot-1.6.0-chinese-support/)
+* [@dougieh](https://github.com/dougieh) [1.5.1](https://polyglot.untra.io/2022/10/01/polyglot-1.5.1/)
+* [@pandermusubi](https://github.com/PanderMusubi) [nl support](https://polyglot.untra.io/2022/01/15/dutch-site-support/)
+* [@obfusk](https://github.com/obfusk) [1.5.0](https://polyglot.untra.io/2021/07/17/polyglot-1.5.0/)
+* [@eighthave](https://github.com/eighthave) [1.5.0](https://polyglot.untra.io/2021/07/17/polyglot-1.5.0/)
+* [@george-gca](https://github.com/george-gca) [Localized Variables](https://polyglot.untra.io/2024/02/29/localized-variables.md)
+
+### Other Websites Built with Polyglot
+Feel free to open a PR and list your multilingual blog here you may want to share:
+
+* [**Polyglot project website**](https://polyglot.untra.io)
+* [LogRhythm Corporate Website](https://logrhythm.com)
+* [All Over Earth](https://allover.earth/)
+* [Hanare Cafe in Toshijima, Japan](https://hanarecafe.com)
+* [F-Droid](https://f-droid.org)
+* [Ubuntu MATE](https://ubuntu-mate.org)
+* [Leo3418 blog](https://leo3418.github.io/)
+* [Gaphor](https://gaphor.org)
+* [Yi Yunseok's personal blog website](https://Yi-Yunseok.GitHub.io)
+* [Tarlogic Cybersecurity](https://www.tarlogic.com/)
+* [A beautiful, simple, clean, and responsive Jekyll theme for academics](https://github.com/george-gca/multi-language-al-folio)
 
 ## 2.0 Roadmap
 * [x] - **site language**: portuguese Brazil `pt-BR`
@@ -300,7 +326,7 @@ If you have something you'd like to contribute to jekyll-polyglot, please open a
 * [x] - **site language**: korean `ko`
 * [x] - **site language**: hebrew `he`
 * [x] - **site language**: chinese China `zh-CN`
-* [ ] - **site language**: chinese Taiwan `zh_TW`
+* [ ] - **site language**: chinese Taiwan `zh-TW`
 * [ ] - get whitelisted as an official github-pages jekyll plugin
 * [x] - update CI provider
 

jekyll-polyglot.gemspec

@@ -1,7 +1,7 @@
 Gem::Specification.new do |s|
   s.name        = 'jekyll-polyglot'
-  s.version     = '1.7.0'
-  s.date        = '2023-10-29'
+  s.version     = '1.8.0'
+  s.date        = '2024-03-17'
   s.summary     = 'I18n plugin for Jekyll Blogs'
   s.description = 'Fast open source i18n plugin for Jekyll blogs.'
   s.authors     = ['Samuel Volin']

lib/jekyll/polyglot/patches/jekyll/site.rb

@@ -43,7 +43,10 @@ def process
             while pids.length >= (lang == all_langs[-1] ? 1 : nproc)
               sleep 0.1
               pids.map do |lang, pid|
-                pids.delete lang if waitpid pid, Process::WNOHANG
+                next unless waitpid pid, Process::WNOHANG
+
+                pids.delete lang
+                raise "Polyglot subprocess #{pid} (#{lang}) failed (#{$?.exitstatus})" unless $?.success?
               end
             end
           end
@@ -60,6 +63,7 @@ def process
           process_language lang
         end
       end
+      Jekyll::Hooks.trigger :polyglot, :post_write
     end
 
     alias site_payload_orig site_payload

make.bat

@@ -1,5 +1,5 @@
 @echo off
-set VERSION="1.7.0"
+set VERSION="1.8.0"
 REM this is running tests
 CALL gem build jekyll-polyglot.gemspec
 CALL gem install jekyll-polyglot-%VERSION%.gem

make.sh

@@ -1,5 +1,5 @@
 #! /bin/sh
-VERSION="1.7.0"
+VERSION="1.8.0"
 # this is running tests
 gem build jekyll-polyglot.gemspec
 gem install jekyll-polyglot-$VERSION.gem

site/_config.yml

@@ -62,7 +62,7 @@ url: https://polyglot.untra.io
 
 paginate: 5
 # Custom vars
-version: 1.7.0
+version: 1.8.0
 # practical values langsep are "|", "•", "·", "-", "–"
 langsep: "•"
 

site/_layouts/content.html

@@ -0,0 +1 @@
+{{content}}

site/_posts/2023-10-29-polyglot-1.7.0.md

@@ -1,6 +1,6 @@
 ---
 layout: post
-title: Polyglot 1.7.0 and `page_id` front-matter for different permalinks by language
+title: Polyglot 1.7.0 and page_id front-matter for different permalinks by language
 lang: en
 ---