当前站点为预览构建而非官方文档。如需反馈问题，请前往
#{{ site.preview.pr-number }} 留言。
当前站点为预览构建而非官方文档。如需反馈问题，请前往
#{{ site.preview.pr-number }} 留言。
+ {% include sidebar.html %}
+
+
+ {% unless page.header.overlay_color or page.header.overlay_image %}
+
{{ page.title }}
+ {% endunless %}
+
+ {{ content }}
+
+ {%- assign search_provider = site.search_provider | default: "lunr" -%}
+ {%- case search_provider -%}
+ {%- when "lunr" -%}
+
+
+ {%- when "google" -%}
+
+
+
+ {%- when "algolia" -%}
+
+
+ {%- endcase -%}
+
+
+ {% include sidebar.html %}
+
+
+ {% if page.title %}
+ {% unless page.header.overlay_color or page.header.overlay_image %}
+
+ {% if page.title -%}
+
+ {%- endif %}
+ {% include page__meta.html %}
+
+ {% endunless %}
+
+
+ {% if page.toc %}
+
+ {% endif %}
+ {{ content }}
+ {% if page.link %}{% endif %}
+
+
+
+ {% if site.data.ui-text[locale].meta_label %}
+ {{ site.data.ui-text[locale].meta_label }}
+ {% endif %}
+ {% include page__taxonomy.html %}
+ {% include page__date.html %}
+
+
+ {% if page.share %}{% include social-share.html %}{% endif %}
+
+ {% include post_pagination.html %}
+
+ Comments are configured with provider: {{ site.comments.provider }} ,
+ but are disabled in non-production environments.
+
+ {% endif %}
+ {% endif %}
+
+
+ {% comment %}{% endcomment %}
+ {% if page.id and page.related and site.related_posts.size > 0 %}
+ {% include page__related.html posts=site.related_posts %}
+ {% comment %}{% endcomment %}
+ {% elsif page.id and page.related %}
+ {% include page__related.html posts=site.posts %}
+ {% endif %}
+
当前站点为预览构建而非官方文档。如需反馈问题，请前往
#{{ site.preview.pr-number }} 留言。
{{ i18n_preview.before }}{% if site.preview.feedback and site.preview.feedback.name %}{{ i18n_preview.feedback.before }}{% if site.preview.feedback.url %}
{{ site.preview.feedback.name }} {% else %}{{ site.preview.feedback.name }}{% endif %}{{ i18n_preview.feedback.after }}{% endif %}{{ i18n_preview.after }}
-
本文由 {{ page.author | default: '未署名用户' }} 创建{% if page.contributors %}，并由 {{ page.contributors | join: ' ' }} 编辑{% endif %}。
+{%- assign i18n_text = site.data.plugins.i18n | i18n: locale, "ui-text" %}
+{%- assign i18n_locale = i18n_text.data.locale %}
+{%- if page.origin.locale and page.locale and page.origin.locale != page.locale -%}
+{%- assign i18n_locale_warning = i18n_text.data.locale_warning %}
+
{{ i18n_locale_warning.before }}{{ i18n_locale[page.origin.locale] }}{{ i18n_locale_warning.after }}
+{%- endif %}
+
+
+ {%- assign i18n_info = i18n_text.data.info -%}
+ {{ i18n_info.byline.author.before }}{{ page.author | default: i18n_info.byline.author.default }}{{ i18n_info.byline.author.after }}
+ {%- if page.contributors %}{{ i18n_info.byline.contributors.before }}{{ page.contributors | join: ' ' }}{{ i18n_info.byline.contributors.after }}{% endif -%}
+ {%- assign translations = page.default.translations | where_exp: "item", "item.locale != page.locale" -%}
+ {%- assign translations_size = translations | size -%}
+ {%- assign fallbacks = page.default.fallbacks | where_exp: "item", "item.locale != page.locale" -%}
+ {%- assign fallbacks_size = fallbacks | size -%}
+ {%- assign size = translations_size | plus: fallbacks_size -%}
+ {%- if size > 0 -%}
+ {{ i18n_info.i18n.before }}
+ {%- if translations_size > 0 -%}
+ {%- assign i18n_translations = i18n_info.i18n.translations -%}
+ {%- capture i18n_translations_links %}{% for item in translations %}
{{ i18n_locale[item.locale] }} {% assign i18n_item_text = site.data.plugins.i18n | i18n: item.locale, "ui-text" %}{{ i18n_item_text.data.locale[item.locale] }} {% endfor %}{% endcapture -%}
+ {{ i18n_translations.before }}{{ i18n_translations_links | strip }}{{ i18n_translations.after }}
+ {%- endif -%}
+ {%- if translations_size > 0 and fallbacks_size > 0 -%}
+ {{ i18n_info.i18n.between }}
+ {%- endif -%}
+ {%- if fallbacks_size > 0 -%}
+ {%- assign i18n_fallbacks = i18n_info.i18n.fallbacks -%}
+ {%- capture i18n_fallbacks_links %}{% for item in fallbacks %}
{{ i18n_locale[item.locale] }} {% assign i18n_item_text = site.data.plugins.i18n | i18n: item.locale, "ui-text" %}{{ i18n_item_text.data.locale[item.locale] }} {% endfor %}{% endcapture -%}
+ {{ i18n_fallbacks.before }}{{ i18n_fallbacks_links | strip }}{{ i18n_fallbacks.after }}
+ {%- endif -%}
+ {{ i18n_info.i18n.after }}
+ {%- endif -%}
+ {{ i18n_info.end }}
+ {%- comment %}{% endcomment -%}
{{ content }}
diff --git a/_plugins/i18n.rb b/_plugins/i18n.rb
new file mode 100644
index 00000000..e9c3c635
--- /dev/null
+++ b/_plugins/i18n.rb
@@ -0,0 +1,101 @@
+module Jekyll
+ class DataReader
+ def sanitize_filename(name)
+ name.gsub(%r![^\w\s.-]+|(?<=^|\b\s)\s+(?=$|\s?\b)!, "")
+ .gsub(%r!\s+!, "_")
+ end
+ end
+end
+
+module I18nFilter
+ def i18n(hash, locale, key)
+ return nil unless hash.is_a?(Hash) && locale.is_a?(String) && key.is_a?(String)
+ return nil unless hash.key?(key)
+
+ locale_key = "#{key}.#{locale}"
+ return { "locale" => locale, "data" => hash[locale_key] } if hash.key? locale_key
+
+ site = @context.registers[:site]
+ default_locale = site.config["locale"].is_a?(String) ? site.config["locale"] : "en"
+ { "locale" => default_locale, "data" => hash[key] }
+ end
+end
+
+Liquid::Template.register_filter(I18nFilter)
+
+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.empty?
+
+ plugins = site.data["plugins"]
+ return unless plugins.is_a?(Hash)
+
+ i18n_data = plugins["i18n"]
+ fallback_data = i18n_data.is_a?(Hash) ? i18n_data["fallback"] : nil
+ return unless fallback_data.is_a?(Hash)
+
+ docs_map = {}
+
+ (site.pages + site.documents).each do |doc|
+ next unless doc.data["i18n"] == true
+ next unless doc.is_a?(Jekyll::Page) or doc.is_a?(Jekyll::Document)
+
+ path_parts = doc.path.split("/")
+ next if path_parts.empty?
+
+ basename = path_parts[-1]
+ basename_parts = basename.split(".")
+
+ doc_locale = (basename_parts.length < 3 || !locales.include?(basename_parts[-2])) ? default_locale : basename_parts[-2]
+ path_parts[-1] = "#{basename_parts[0..-3].join(".")}.#{basename_parts[-1]}" unless doc_locale == default_locale
+ default_doc_path = path_parts.join('/')
+ docs_map[default_doc_path] ||= {}
+ docs_map[default_doc_path][doc_locale] = doc
+ end
+
+ docs_map.each_value do |docs|
+ default_doc = docs[default_locale]
+ next unless default_doc
+ default_doc.data["fallbacks"] = {}
+ default_doc.data["translations"] = docs
+
+ locales.each do |locale|
+ if docs[locale]
+ docs[locale].data["locale"] = locale
+ docs[locale].data["origin"] = docs[locale]
+ docs[locale].data["default"] = default_doc
+ unless locale == default_locale
+ docs[locale].data["permalink"] = "/#{locale}#{default_doc.url}"
+ docs[locale].instance_variable_set(:@url, nil)
+ end
+ else
+ fallback_locale = fallback_data[locale]
+ while fallback_locale
+ fallback_doc = docs[fallback_locale]
+ break if fallback_doc
+ fallback_locale = fallback_data[fallback_locale]
+ end
+ fallback_doc ||= default_doc
+
+ 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
+
+ default_doc.data["fallbacks"][locale] = new_doc
+
+ 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["locale"] = locale
+ end
+ end
+ end
+end
From 52ba0d5745d2e87d0d8aef31171e62dd1d6e6ab3 Mon Sep 17 00:00:00 2001
From: neveler <55753029+neveler@users.noreply.github.com>
Date: Fri, 5 Dec 2025 13:53:13 +0800
Subject: [PATCH 03/16] =?UTF-8?q?=E9=A1=B5=E9=9D=A2=E5=AF=BC=E8=88=AA?=
=?UTF-8?q?=E5=A4=9A=E8=AF=AD=E8=A8=80=E6=94=AF=E6=8C=81?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
_data/navigation.yml | 55 -------------------------------
_data/navigation/docs.en.yml | 40 ++++++++++++++++++++++
_data/navigation/docs.yml | 48 +++++++++++++++++++++++++++
_data/navigation/docs.zh-Hant.yml | 48 +++++++++++++++++++++++++++
_data/navigation/main.en.yml | 4 +++
_data/navigation/main.yml | 4 +++
_data/navigation/main.zh-Hant.yml | 4 +++
_includes/masthead.html | 5 +--
_includes/nav_list | 6 ++--
9 files changed, 154 insertions(+), 60 deletions(-)
delete mode 100644 _data/navigation.yml
create mode 100644 _data/navigation/docs.en.yml
create mode 100644 _data/navigation/docs.yml
create mode 100644 _data/navigation/docs.zh-Hant.yml
create mode 100644 _data/navigation/main.en.yml
create mode 100644 _data/navigation/main.yml
create mode 100644 _data/navigation/main.zh-Hant.yml
diff --git a/_data/navigation.yml b/_data/navigation.yml
deleted file mode 100644
index 495382ba..00000000
--- a/_data/navigation.yml
+++ /dev/null
@@ -1,55 +0,0 @@
-main:
- - title: 常见问题
- url: /faq.html
- - title: 设置
- url: /settings.html
-
-docs:
- - title: 问题集合
- children:
- - title: 常见问题
- url: /faq.html
- - title: 启动器使用相关
- url: /launcher/
- - title: 整合包帮助
- url: /modpack/
- - title: 多人联机帮助
- url: /multiplayer/
- - title: 使用者帮助
- children:
- - title: 版本隔离
- url: /launcher/isolation.html
- description: 本文可以帮助你更好的分离版本间的地图、模组等内容。
- - title: 设置离线皮肤
- url: /launcher/offline-skin.html
- description: 本文将告诉你如何设置一个属于自己的离线皮肤。
- - title: HMCL 的自动安装使用教程
- url: /launcher/auto-installing.html
- description: 本文将告诉你如何用 HMCL 安装 Forge、Fabric、Fabric API、LiteLoader、Optifine 以及 模组 等。
- - title: 安装光影
- url: /launcher/shader.html
- description: 本文将告诉你如何安装光影。
- - title: 设置项详解
- url: /launcher/set-item-details.html
- description: 这篇文章针对 HMCL 的各个设置项进行了详细的解释。
- - title: 开发者帮助
- children:
- - title: 制作 HMCL 格式的数据包
- url: /launcher/datapack.html
- description: 本文将告诉你如何制作 HMCL 能够识别的数据包（Datapacks）。
- - title: 制作整合包
- url: /modpack/serverpack.html
- description: 本文将告诉你如何制作整合包。
- - title: 添加默认 authlib-injector 验证服务器
- url: /launcher/authlib-injector.html
- description: 本文将告诉你如何设置默认的验证服务器。
- - title: 其他
- children:
- - title: 贡献指南
- url: /contribution.html
- - title: HMCL GitHub 地址
- url: https://github.com/HMCL-dev/HMCL
- - title: HMCL 帮助文档 GitHub 地址
- url: https://github.com/HMCL-dev/HMCL-docs
- - title: HMCL 官网
- url: https://hmcl.huangyuhui.net
diff --git a/_data/navigation/docs.en.yml b/_data/navigation/docs.en.yml
new file mode 100644
index 00000000..3079b6f4
--- /dev/null
+++ b/_data/navigation/docs.en.yml
@@ -0,0 +1,40 @@
+- title: Questions
+ children:
+ - title: FAQ
+ url: /en/faq.html
+ - title: Launcher
+ url: /en/launcher/
+ - title: Modpack
+ url: /en/modpack/
+ - title: Multiplayer
+ url: /en/multiplayer/
+- title: User Guide
+ children:
+ - title: Isolation
+ url: /en/launcher/isolation.html
+ - title: Offline Skin
+ url: /en/launcher/offline-skin.html
+ - title: Automatic Installing
+ url: /en/launcher/auto-installing.html
+ - title: Shader
+ url: /en/launcher/shader.html
+ - title: Set Item Details
+ url: /en/launcher/set-item-details.html
+- title: Developer Guide
+ children:
+ - title: Datapack
+ url: /en/launcher/datapack.html
+ - title: Serverpack
+ url: /en/modpack/serverpack.html
+ - title: Authlib Injector
+ url: /en/launcher/authlib-injector.html
+- title: Other
+ children:
+ - title: Contribution Guide
+ url: /en/contribution.html
+ - title: Official Website
+ url: https://hmcl.huangyuhui.net
+ - title: Project Repository
+ url: https://github.com/HMCL-dev/HMCL
+ - title: Documentation Repository
+ url: https://github.com/HMCL-dev/HMCL-docs
diff --git a/_data/navigation/docs.yml b/_data/navigation/docs.yml
new file mode 100644
index 00000000..b930e909
--- /dev/null
+++ b/_data/navigation/docs.yml
@@ -0,0 +1,48 @@
+- title: 问题集合
+ children:
+ - title: 常见问题
+ url: /faq.html
+ - title: 启动器使用相关
+ url: /launcher/
+ - title: 整合包帮助
+ url: /modpack/
+ - title: 多人联机帮助
+ url: /multiplayer/
+- title: 使用者帮助
+ children:
+ - title: 版本隔离
+ url: /launcher/isolation.html
+ description: 本文可以帮助你更好的分离版本间的地图、模组等内容。
+ - title: 设置离线皮肤
+ url: /launcher/offline-skin.html
+ description: 本文将告诉你如何设置一个属于自己的离线皮肤。
+ - title: HMCL 的自动安装使用教程
+ url: /launcher/auto-installing.html
+ description: 本文将告诉你如何用 HMCL 安装 Forge、Fabric、Fabric API、LiteLoader、Optifine 以及 模组 等。
+ - title: 安装光影
+ url: /launcher/shader.html
+ description: 本文将告诉你如何安装光影。
+ - title: 设置项详解
+ url: /launcher/set-item-details.html
+ description: 这篇文章针对 HMCL 的各个设置项进行了详细的解释。
+- title: 开发者帮助
+ children:
+ - title: 制作 HMCL 格式的数据包
+ url: /launcher/datapack.html
+ description: 本文将告诉你如何制作 HMCL 能够识别的数据包（Datapacks）。
+ - title: 制作整合包
+ url: /modpack/serverpack.html
+ description: 本文将告诉你如何制作整合包。
+ - title: 添加默认 authlib-injector 验证服务器
+ url: /launcher/authlib-injector.html
+ description: 本文将告诉你如何设置默认的验证服务器。
+- title: 其它
+ children:
+ - title: 贡献指南
+ url: /contribution.html
+ - title: 官方网站
+ url: https://hmcl.huangyuhui.net
+ - title: 项目仓库
+ url: https://github.com/HMCL-dev/HMCL
+ - title: 文档仓库
+ url: https://github.com/HMCL-dev/HMCL-docs
diff --git a/_data/navigation/docs.zh-Hant.yml b/_data/navigation/docs.zh-Hant.yml
new file mode 100644
index 00000000..adf1782b
--- /dev/null
+++ b/_data/navigation/docs.zh-Hant.yml
@@ -0,0 +1,48 @@
+- title: 問題集合
+ children:
+ - title: 常見問題
+ url: /zh-Hant/faq.html
+ - title: 啟動器使用相關
+ url: /zh-Hant/launcher/
+ - title: 整合包幫助
+ url: /zh-Hant/modpack/
+ - title: 多人聯機幫助
+ url: /zh-Hant/multiplayer/
+- title: 使用者幫助
+ children:
+ - title: 版本隔離
+ url: /zh-Hant/launcher/isolation.html
+ description: 本文可以幫助你更好的分離版本間的地圖、模組等內容。
+ - title: 設置離線皮膚
+ url: /zh-Hant/launcher/offline-skin.html
+ description: 本文將告訴你如何設置一個屬於自己的離線皮膚。
+ - title: HMCL 的自動安裝使用教程
+ url: /zh-Hant/launcher/auto-installing.html
+ description: 本文將告訴你如何用 HMCL 安裝 Forge、Fabric、Fabric API、LiteLoader、Optifine 以及 模組 等。
+ - title: 安裝光影
+ url: /zh-Hant/launcher/shader.html
+ description: 本文將告訴你如何安裝光影。
+ - title: 設置項詳解
+ url: /zh-Hant/launcher/set-item-details.html
+ description: 這篇文章針對 HMCL 的各個設置項進行了詳細的解釋。
+- title: 開髮者幫助
+ children:
+ - title: 製作 HMCL 格式的數據包
+ url: /zh-Hant/launcher/datapack.html
+ description: 本文將告訴你如何製作 HMCL 能夠識別的數據包（Datapacks）。
+ - title: 製作整合包
+ url: /zh-Hant/modpack/serverpack.html
+ description: 本文將告訴你如何製作整合包。
+ - title: 添加默認 authlib-injector 驗証服務器
+ url: /zh-Hant/launcher/authlib-injector.html
+ description: 本文將告訴你如何設置默認的驗証服務器。
+- title: 其它
+ children:
+ - title: 貢獻指南
+ url: /zh-Hant/contribution.html
+ - title: 官方網站
+ url: https://hmcl.huangyuhui.net
+ - title: 項目倉庫
+ url: https://github.com/HMCL-dev/HMCL
+ - title: 文檔倉庫
+ url: https://github.com/HMCL-dev/HMCL-docs
diff --git a/_data/navigation/main.en.yml b/_data/navigation/main.en.yml
new file mode 100644
index 00000000..37158eaa
--- /dev/null
+++ b/_data/navigation/main.en.yml
@@ -0,0 +1,4 @@
+- title: FAQ
+ url: /en/faq.html
+- title: Settings
+ url: /en/settings.html
diff --git a/_data/navigation/main.yml b/_data/navigation/main.yml
new file mode 100644
index 00000000..db6bedf1
--- /dev/null
+++ b/_data/navigation/main.yml
@@ -0,0 +1,4 @@
+- title: 常见问题
+ url: /faq.html
+- title: 设置
+ url: /settings.html
diff --git a/_data/navigation/main.zh-Hant.yml b/_data/navigation/main.zh-Hant.yml
new file mode 100644
index 00000000..62fd0590
--- /dev/null
+++ b/_data/navigation/main.zh-Hant.yml
@@ -0,0 +1,4 @@
+- title: 常見問題
+ url: /zh-Hant/faq.html
+- title: 設置
+ url: /zh-Hant/settings.html
diff --git a/_includes/masthead.html b/_includes/masthead.html
index 85dc14e0..bf85ca44 100644
--- a/_includes/masthead.html
+++ b/_includes/masthead.html
@@ -13,8 +13,9 @@
{% if site.subtitle %}
{{ site.subtitle | escape_once | strip }} {% endif %}
- {%- for link in site.data.navigation.main -%}
- 
+