尝试通过插件的方式支持多语言

Author: neveler

_config.yml

@@ -113,11 +113,24 @@ defaults:
       hits: true
       toc: true
       toc_sticky: true
+      i18n: true
   - scope:
       path: ""
       type: downloads
     values:
       toc: false
+  - scope:
+      path: assets
+    values:
+      i18n: false
+  - scope:
+      path: 404.md
+    values:
+      i18n: false
+  - scope:
+      path: robots.txt
+    values:
+      i18n: false
 
 # liquid:
 #   error_mode: warn
@@ -144,6 +157,7 @@ minimal_mistakes_skin_dark: dark
 
 # Site Settings
 locale: zh
+locales: [zh, zh-TW, en]
 # rtl:
 title: HMCL 文档
 # title_separator: -

_layouts/document.html

@@ -6,6 +6,10 @@
 <img src="https://hits.zkitefly.eu.org/?tag={{ page.url | absolute_url | url_encode }}" alt="Hits" decoding="async">
 {% endif %}
 
+{% if page.origin_lang and page.lang and page.origin_lang != page.lang %}
+<div class="notice--warning">当前页面语言与实际语言不一致</div>
+{% endif %}
+
 <div class="notice--info">
   <p>本文由 {{ page.author | default: '未署名用户' }} 创建{% if page.contributors %}，并由 {{ page.contributors | join: ' ' }} 编辑{% endif %}。</p>
   {%- if page.note -%}

_plugins/i18n.rb

@@ -0,0 +1,59 @@
+Jekyll::Hooks.register [:site], :pre_render do |site|
+  default_locale = site.config["locale"] || "en"
+  locales = Array(site.config["locales"] || default_locale)
+  locales.unshift(default_locale) unless locales.include?(default_locale)
+  return if locales.length == 0
+
+  doc_map = {}
+
+  (site.pages + site.documents).each do |doc|
+    basename = File.basename(doc.path)
+    doc_locale = basename[/\.(\w+)\.\w+$/, 1]
+    next unless doc.data["i18n"] == true
+
+    if doc_locale && locales.include?(doc_locale)
+      default_doc_path = doc.path.sub(/\.#{Regexp.escape(doc_locale)}(?=\.\w+$)/, "")
+    else
+      doc_locale = default_locale
+      default_doc_path = doc.path
+    end
+    doc_map[default_doc_path] ||= {}
+    doc_map[default_doc_path][doc_locale] = doc
+  end
+
+  generate_fallback_doc = lambda do |fallback_doc, locale|
+    if fallback_doc.is_a?(Jekyll::Page)
+      base, dir, name = fallback_doc.instance_variable_get(:@base), fallback_doc.instance_variable_get(:@dir), fallback_doc.instance_variable_get(:@name)
+      new_doc = Jekyll::PageWithoutAFile.new(fallback_doc.site, base, dir, name)
+      site.pages << new_doc
+    else
+      path, collection = fallback_doc.instance_variable_get(:@path), fallback_doc.collection
+      new_doc = Jekyll::Document.new(path, site: fallback_doc.site, collection: collection)
+      collection.docs << new_doc
+    end
+
+    new_doc.content = fallback_doc.content
+    fallback_doc.data.each { |k, v| new_doc.data[k] = v }
+    new_doc.data["permalink"] = "/#{locale}#{fallback_doc.url}"
+    new_doc.data["lang"] = locale
+  end
+
+  doc_map.each_value do |docs|
+    default_doc = docs[default_locale]
+    next unless default_doc
+
+    locales.each do |locale|
+      if docs[locale]
+        docs[locale].data["lang"] = locale
+        docs[locale].data["origin_lang"] = locale
+        if locale != default_locale
+          docs[locale].data["permalink"] = "/#{locale}#{default_doc.url}"
+          docs[locale].instance_variable_set(:@url, nil)
+        end
+      else
+        fallback_doc = default_doc
+        generate_fallback_doc.call(fallback_doc, locale)
+      end
+    end
+  end
+end