jekyll-locales 0.3.0rc1 → 0.3.0rc2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9e77ee2e8ebbf1cf1254942a20e6ba6549003510b0a5d40b9fd9ff34a939dde8
-  data.tar.gz: 7316977692b7242ec7fbfa0373590f405f9194ade2e39d61524ae4a720731f79
+  metadata.gz: 4f070d48205919668af087050035f6b31f84ab19a98cc4d05ed76b64ca979631
+  data.tar.gz: be3496f7b5ed7d16e7054f3edc2f0272aec6579e8a2d363d736514e8694c80d7
 SHA512:
-  metadata.gz: ba762364885dbaa5645c3d28b8dccb346bc0c9ffb04d137aa1761147234b7cb04087f9c3795fd2021df7ed96ead359a3ca3ca81be7524468b9f2d5229c64bcbe
-  data.tar.gz: a71d8ef45f36093cdddc064340ce21cc5e5ce0f0c920a80ad51d0b669a12657ad8401431519615f00bc8029c4d694e1de350751f6b4c7f7a9e0f21285f719d79
+  metadata.gz: bf6c153118dc7a27aa5f60c5ca5aa8a4391797118eeccca427a055fa964ea8077c8c14f0bf5f7ef09dedd62b787a0b6be4173eb09c9b78a610a13f881ec3e642
+  data.tar.gz: c853ad53b2621f71031b569a9ea6931c5fe326fa0b7602a51fc3a546d5fc3146532e3e447528f116a50cfcfcb7cc583a8031e6e1b67003d5efc3ec67023805ef

data/README.md

@@ -34,6 +34,7 @@ locales:
 - ahr
 - brasileiro
 redirect: true
+fallback_locale: true
 ```
 
 **The first locale is going to be your default locale**.  If you use
@@ -41,6 +42,19 @@ a redirector.html, it will be the locale it will redirector to.  If you
 don't use a redirector, the default locale will be at the root of the
 site.
 
+#### Fallback locales
+
+If you don't want build errors or missing messages on your theme for
+missing locales, you can setup fallbacks in any of these ways:
+
+```yaml
+fallback_locale: true # defaults to first locale
+fallback_locale: en # defaults to first en
+fallback_locale: # maps locales to existing options
+  fr: en
+  pt: es
+```
+
 ## Posts
 
 Put your posts into directories named after the locales, prefixed by an

data/lib/jekyll/locales/site.rb

@@ -75,6 +75,22 @@ module Jekyll
       default_locale == locale
     end
 
+    # There's always a fallback!
+    #
+    # @return [String]
+    def fallback_locale
+      @fallback_locale ||= {}
+      @fallback_locale[locale] ||=
+        case config['fallback_locale']
+        when TrueClass, FalseClass, NilClass then default_locale
+        when Hash then config['fallback_locale'][locale]
+        when String then config['fallback_locale']
+        else
+          Jekyll.logger.warn 'Locales:', "Configuration `fallback_locale` is #{config['fallback_locale'].class}, it should be boolean, Hash or String"
+          nil
+        end || default_locale
+    end
+
     private
 
     # Redefine #render_docs so it doesn't render the locale collections

data/lib/jekyll/locales/site_drop.rb

@@ -7,7 +7,13 @@ module Jekyll
     # Make i18n available to Liquid as site.i18n
     class SiteDrop
       def i18n
-        @i18n ||= @obj.data[@obj.config['lang']]
+        @i18n ||=
+          if @obj.data.key?(@obj.config['lang'])
+            @obj.data[@obj.config['lang']]
+          else
+            Jekyll.logger.warn 'Locales:', "Using #{@obj.fallback_locale} as fallback of #{@obj.config['lang']}"
+            @obj.data[@obj.fallback_locale]
+          end
       end
     end
   end

data/lib/jekyll/locales/version.rb

@@ -2,6 +2,6 @@
 
 module Jekyll
   module Locales
-    VERSION = '0.3.0rc1'
+    VERSION = '0.3.0rc2'
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: jekyll-locales
 version: !ruby/object:Gem::Version
-  version: 0.3.0rc1
+  version: 0.3.0rc2
 platform: ruby
 authors:
 - f
@@ -35,7 +35,7 @@ cert_chain:
   cpurTQHNJfL/ah+9dYbgDXdG5HAAjRMAsWSvERw95YdN9XzQZCdUk5wUs+A6cNtO
   AZZUMTVYNx8JqUeemxlXBRjsD/s=
   -----END CERTIFICATE-----
-date: 2025-03-19 00:00:00.000000000 Z
+date: 2025-06-27 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler