优化更新日志 (#360)

_config.yml

@@ -118,6 +118,16 @@ defaults:
       type: downloads
     values:
       toc: false
+  - scope:
+      path: _changelogs/dev
+      type: changelogs
+    values:
+      channel: dev
+  - scope:
+      path: _changelogs/stable
+      type: changelogs
+    values:
+      channel: stable
 
 # liquid:
 #   error_mode: warn
@@ -139,8 +149,6 @@ defaults:
 
 # Theme Settings
 theme: minimal-mistakes-jekyll
-minimal_mistakes_skin: default # "air", "aqua", "contrast", "dark", "dirt", "neon", "mint", "plum", "sunrise"
-minimal_mistakes_skin_dark: dark
 
 # Site Settings
 locale: zh
@@ -309,6 +317,7 @@ compress_html:
     envs: development
 
 head_scripts:
+  - /assets/js/settings.js
   - /assets/js/theme.js
 after_footer_scripts:
   - /assets/js/plugins/jquery.auto-redirect.js

_data/groups.csv

@@ -1,11 +1,11 @@
 name,link,status
 HMCL 用户群 ① (633640264),https://qm.qq.com/q/fvJueufsvC,
-HMCL 用户群 ② (203232161),https://qm.qq.com/q/N7hgdNYfy,已满
-HMCL 用户群 ③ (201034984),https://qm.qq.com/q/7sbMrFm9CE,已满
-HMCL 用户群 ④ (533529045),https://qm.qq.com/q/ACmZa98tGg,
-HMCL 用户群 ⑤ (744304553),https://qm.qq.com/q/MlVArSCMwM,
+HMCL 用户群 ② (203232161),https://qm.qq.com/q/N7hgdNYfy,
+HMCL 用户群 ③ (201034984),https://qm.qq.com/q/7sbMrFm9CE,
+HMCL 用户群 ④ (533529045),https://qm.qq.com/q/ACmZa98tGg,已满
+HMCL 用户群 ⑤ (744304553),https://qm.qq.com/q/MlVArSCMwM,已满
 HMCL 用户群 ⑥ (282845310),https://qm.qq.com/q/S782Skmu0U,
 HMCL 用户群 ⑦ (482624681),https://qm.qq.com/q/WFsZ65F6MY,
 HMCL 用户群 ⑧ (991620626),https://qm.qq.com/q/ECVKkslPqi,
-HMCL 用户群 ⑨ (657677715),https://qm.qq.com/q/DVj9tTrwze,
-HMCL 用户群 ⑩ (775084843),https://qm.qq.com/q/V5F9DswQEu,
+HMCL 用户群 ⑨ (657677715),https://qm.qq.com/q/DVj9tTrwze,已满
+HMCL 用户群 ⑩ (775084843),https://qm.qq.com/q/V5F9DswQEu,已满

_data/navigation.yml

@@ -1,6 +1,8 @@
 main:
   - title: 常见问题
     url: /faq.html
+  - title: 设置
+    url: /settings.html
 
 docs:
   - title: 问题集合

_data/settings.yaml

@@ -0,0 +1,35 @@
+appearance_color:
+  type: radio
+  default: light
+  options:
+    - light
+    - dark
+    - auto
+appearance_skin_light:
+  type: radio
+  default: default
+  options:
+    - default
+    - air
+    - aqua
+    - contrast
+    - dark
+    - dirt
+    - neon
+    - mint
+    - plum
+    - sunrise
+appearance_skin_dark:
+  type: radio
+  default: dark
+  options:
+    - default
+    - air
+    - aqua
+    - contrast
+    - dark
+    - dirt
+    - neon
+    - mint
+    - plum
+    - sunrise

_docs/faq.md

@@ -88,7 +88,7 @@ HMCL 自动安装与使用模组教程： [跳转](/_launcher/auto-installing.md
 
 或者前往模组包报错排查手册中查看： [跳转](/_modpack/error-handbook.md)
 
-如果无法解决错误，尝试 [寻求帮助](help.html)
+如果无法解决错误，尝试 [寻求帮助](/_docs/help.md)
 
 ### 如何选择游戏的 Java 版本
 

_includes/head/custom.html

@@ -1 +1,2 @@
 <link rel="shortcut icon" href="{{ '/favicon.ico' | relative_url }}">
+<link rel="stylesheet" id="skin">

_launcher/isolation.md

@@ -1,40 +1,48 @@
 ---
 title: 全局版本隔离
-date: 2021-10-09 23:18:02 +0800
+date: 2021-10-09T23:18:02+08:00
+last_modified_at: 2025-12-03T14:31:42+08:00
 author: LIPiston
+redirect_from:
+  - /launcher/global-version-isolation.html
 ---
 
-这是一个游戏客户端很多不方便寻找的最佳解决方案<br/>
-**注意：该方法会改变默认的 minecraft 文件结构**
+请注意该方法会改变默认的游戏文件结构。
 
 ## 使用方式
-进入 hmcl 的`设置`
-![](\assets\img\docs\Global-version-isolation\img.webp)
-在全局设置中找到 `版本隔离`
-改为 `各版本独立`
-![](\assets\img\docs\Global-version-isolation\img2.webp)
+
+进入 hmcl 的 `设置`
+
+![](/assets/img/docs/isolation/img1.png)
+
+在全局游戏设置中找到 `版本隔离` 并设置为 `各实例独立`
+
+![](/assets/img/docs/isolation/img2.png)
+
 这时候 minecraft 的文件结构就会有所改变，如下方
-```
+
+```plaintext
 .minecraft
-|*asstes
-|*libraries
-|*versions
-    \1.16.5-optifine
-        |1.16.5-optifine.jar
-        |*saves
-        |*resourcepacks
-        |*logs
-        |*mods
-        |*config
-        ...
+├── asstes
+├── libraries
+└── versions
+    └── 1.16.5-optifine
+        ├── 1.16.5-optifine.jar
+        ├── saves
+        ├── resourcepacks
+        ├── logs
+        ├── mods
+        └── ...
 ```
+
 并非在 .minecraft 文件夹中存储一切的 mod 和 资源包**而是各版本的资源互相独立**
 
 这样你就可以在一个目录下，安装多个客户端
 
 ## 往后的使用
+
 在做完版本隔离的设置后，hmcl 的快速打开各个游戏文件夹的功能就会显得十分好用。
-![](/assets/img/docs/Global-version-isolation/img1.png)
+
+![](/assets/img/docs/isolation/img3.png)
 
 ~~善用该功能也可为你的磁盘剩下不少的空间~~，现在反思过来其实都差不多
-

_layouts/changelog.html

@@ -5,7 +5,7 @@ layout: document
 {{ content }}
 
 {% assign channel = page.channel | default: 'stable' %}
-{% assign changelogs = site.changelogs | where_exp: "item", "item.relative_path contains channel" | reverse %}
+{% assign changelogs = site.changelogs | where: "channel", channel | reverse %}
 {% for item in changelogs %}
   {% assign version = item.slug %}
   <h1 id="{% if forloop.index == 1 %}nowchange{% else %}HMCL-{{ version }}{% endif %}" data-version="{{ version }}">HMCL {{ version }}</h1>

_layouts/settings.html

@@ -0,0 +1,46 @@
+---
+layout: document
+---
+
+{% for group in page.data %}
+
+{% capture notice %}
+
+## {{ group.title }}
+
+{% for pair in group.settings %}
+{% assign name = pair[0] %}
+{% assign value = pair[1] %}
+{% assign setting = site.data.settings[name] %}
+
+{% if setting.type == 'radio' %}
+<div class="notice">
+  <ul class="task-list">
+    <li><strong>{{ value.title }}</strong></li>
+    <li>{{ value.description }}</li>
+    {% for option in setting.options %}
+    <li class="task-list-item">
+      <input type="radio" class="task-list-item-checkbox" name="{{ name }}" value="{{ option }}" id="{{ name }}_{{ option }}"{% if setting.default == option %} checked{% endif %}><label for="{{ name }}_{{ option }}">{{ value.options[option] }}</label>
+    </li>
+    {% endfor %}
+  </ul>
+</div>
+
+<script>
+  settings.onChange("{{ name }}", function (newValue, oldValue) {
+    var list = document.getElementsByName("{{ name }}");
+    for (var i = 0; i < list.length; i++) {
+      list[i].checked = list[i].value === newValue;
+      list[i].onchange = function () {
+        if (this.checked) {
+          settings.set(this.name, this.value);
+        }
+      }
+    }
+  });
+</script>
+{% endif %}
+{% endfor %}
+{% endcapture %}
+{{ notice | markdownify }}
+{% endfor %}

_modpack/error-handbook.md

@@ -7,7 +7,7 @@ author: LIPiston
 ## 文件夹结构
 
 首先我们需要先认识Minecraft的文件夹结构  
-如果你开启了 [版本隔离](launcher/global-version-isolation.html) 那么你的文件夹结构如下  
+如果你开启了 [版本隔离](/_launcher/isolation.md) 那么你的文件夹结构如下  
 ```text
 .minecraft
 |*assets         # 游戏资源文件夹，存放纹理、声音等资源

_sass/minimal-mistakes-plus.scss

@@ -1,16 +1,24 @@
-@import "minimal-mistakes";
-
-blockquote {
-  margin-inline: 0;
-  font-style: normal;
-}
-
-a, span, code, kbd, pre, em, strong, b, i {
-  overflow-wrap: break-word;
-  word-wrap: break-word;
-  word-break: break-word;
-}
-
-.m0 {
-  margin: 0 !important;
-}
+@import "minimal-mistakes";
+
+blockquote {
+  margin-inline: 0;
+  font-style: normal;
+}
+
+* {
+  overflow-wrap: break-word;
+  word-wrap: break-word;
+  word-break: break-word;
+}
+
+.notice ul:first-child {
+  margin-top: 0;
+}
+
+.task-list-item label {
+  display: inline
+}
+
+.m0 {
+  margin: 0 !important;
+}

assets/css/main.scss

@@ -1,8 +1,8 @@
----
----
-
-@charset "utf-8";
-
-$sans-serif: -apple-system, BlinkMacSystemFont, "Roboto", "Segoe UI", "Noto Sans", Helvetica, Arial, sans-serif, "Apple Color Emoji", "Segoe UI Emoji";
-@import "minimal-mistakes/skins/{{ site.minimal_mistakes_skin | default: 'default' }}";
-@import "minimal-mistakes-plus";
+---
+---
+
+@charset "utf-8";
+
+$sans-serif: -apple-system, BlinkMacSystemFont, "Roboto", "Segoe UI", "Noto Sans", Helvetica, Arial, sans-serif, "Apple Color Emoji", "Segoe UI Emoji";
+@import "minimal-mistakes/skins/default";
+@import "minimal-mistakes-plus";

assets/css/skins/air.scss

@@ -0,0 +1,8 @@
+---
+---
+
+@charset "utf-8";
+
+$sans-serif: -apple-system, BlinkMacSystemFont, "Roboto", "Segoe UI", "Noto Sans", Helvetica, Arial, sans-serif, "Apple Color Emoji", "Segoe UI Emoji";
+@import "minimal-mistakes/skins/air";
+@import "minimal-mistakes-plus";

assets/css/skins/aqua.scss

@@ -0,0 +1,8 @@
+---
+---
+
+@charset "utf-8";
+
+$sans-serif: -apple-system, BlinkMacSystemFont, "Roboto", "Segoe UI", "Noto Sans", Helvetica, Arial, sans-serif, "Apple Color Emoji", "Segoe UI Emoji";
+@import "minimal-mistakes/skins/aqua";
+@import "minimal-mistakes-plus";

assets/css/skins/contrast.scss

@@ -0,0 +1,8 @@
+---
+---
+
+@charset "utf-8";
+
+$sans-serif: -apple-system, BlinkMacSystemFont, "Roboto", "Segoe UI", "Noto Sans", Helvetica, Arial, sans-serif, "Apple Color Emoji", "Segoe UI Emoji";
+@import "minimal-mistakes/skins/contrast";
+@import "minimal-mistakes-plus";

assets/css/skins/dark.scss

@@ -1,8 +1,8 @@
----
----
-
-@charset "utf-8";
-
-$sans-serif: -apple-system, BlinkMacSystemFont, "Roboto", "Segoe UI", "Noto Sans", Helvetica, Arial, sans-serif, "Apple Color Emoji", "Segoe UI Emoji";
-@import "minimal-mistakes/skins/{{ site.minimal_mistakes_skin_dark | default: 'dark' }}";
-@import "minimal-mistakes-plus";
+---
+---
+
+@charset "utf-8";
+
+$sans-serif: -apple-system, BlinkMacSystemFont, "Roboto", "Segoe UI", "Noto Sans", Helvetica, Arial, sans-serif, "Apple Color Emoji", "Segoe UI Emoji";
+@import "minimal-mistakes/skins/dark";
+@import "minimal-mistakes-plus";

assets/css/skins/default.scss

@@ -0,0 +1,2 @@
+---
+---

assets/css/skins/dirt.scss

@@ -0,0 +1,8 @@
+---
+---
+
+@charset "utf-8";
+
+$sans-serif: -apple-system, BlinkMacSystemFont, "Roboto", "Segoe UI", "Noto Sans", Helvetica, Arial, sans-serif, "Apple Color Emoji", "Segoe UI Emoji";
+@import "minimal-mistakes/skins/dirt";
+@import "minimal-mistakes-plus";

assets/css/skins/mint.scss

@@ -0,0 +1,8 @@
+---
+---
+
+@charset "utf-8";
+
+$sans-serif: -apple-system, BlinkMacSystemFont, "Roboto", "Segoe UI", "Noto Sans", Helvetica, Arial, sans-serif, "Apple Color Emoji", "Segoe UI Emoji";
+@import "minimal-mistakes/skins/mint";
+@import "minimal-mistakes-plus";

assets/css/skins/neon.scss

@@ -0,0 +1,8 @@
+---
+---
+
+@charset "utf-8";
+
+$sans-serif: -apple-system, BlinkMacSystemFont, "Roboto", "Segoe UI", "Noto Sans", Helvetica, Arial, sans-serif, "Apple Color Emoji", "Segoe UI Emoji";
+@import "minimal-mistakes/skins/neon";
+@import "minimal-mistakes-plus";

assets/css/skins/plum.scss

@@ -0,0 +1,8 @@
+---
+---
+
+@charset "utf-8";
+
+$sans-serif: -apple-system, BlinkMacSystemFont, "Roboto", "Segoe UI", "Noto Sans", Helvetica, Arial, sans-serif, "Apple Color Emoji", "Segoe UI Emoji";
+@import "minimal-mistakes/skins/plum";
+@import "minimal-mistakes-plus";

assets/css/skins/sunrise.scss

@@ -0,0 +1,8 @@
+---
+---
+
+@charset "utf-8";
+
+$sans-serif: -apple-system, BlinkMacSystemFont, "Roboto", "Segoe UI", "Noto Sans", Helvetica, Arial, sans-serif, "Apple Color Emoji", "Segoe UI Emoji";
+@import "minimal-mistakes/skins/sunrise";
+@import "minimal-mistakes-plus";

assets/js/settings.js

@@ -0,0 +1,76 @@
+---
+layout: null
+---
+(function (global) {
+  var PREFIX = "HMCL_DOCS_SETTINGS_";
+  var data = {};
+  var events = {};
+  var config = /*{%comment%}*/{}/*{%endcomment%}*//**{{'/'}}{{ site.data.settings | jsonify }}/**/;
+
+  global.addEventListener("storage", function (event) {
+    if (!event.key) return;
+    if (event.key.indexOf(PREFIX) !== 0) return;
+
+    var handlers = events[event.key];
+    if (!handlers) return;
+
+    var newValue = event.newValue;
+    var oldValue = event.oldValue;
+    if (oldValue === newValue) return;
+
+    data[event.key] = newValue;
+    for (var i = 0; i < handlers.length; i++) {
+      if (typeof handlers[i] === "function") {
+        handlers[i](newValue, oldValue);
+      }
+    }
+  });
+
+  var settings = {
+    set: function (key, value) {
+      if (config[key] === undefined) return;
+      var strKey = (PREFIX + key).toUpperCase();
+      var newValue = value + "";
+      data[strKey] = newValue;
+      localStorage.setItem(strKey, newValue);
+      var handlers = events[strKey];
+      if (!handlers) return;
+
+      for (var i = 0; i < handlers.length; i++) {
+        if (typeof handlers[i] === "function") {
+          handlers[i](newValue);
+        }
+      }
+    },
+
+    get: function (key, defaultValue) {
+      if (config[key] === undefined) return;
+      var strKey = (PREFIX + key).toUpperCase();
+      data.hasOwnProperty(strKey) || (data[strKey] = localStorage.getItem(strKey));
+      if (typeof defaultValue === "string" && data[strKey] === null) {
+        return defaultValue;
+      }
+      return data[strKey];
+    },
+
+    refresh: function (key) {
+      if (config[key] === undefined) return;
+      settings.set(key, settings.get(key, config[key].default));
+    },
+
+    onChange: function (key, handler) {
+      if (config[key] === undefined) return;
+      if (typeof handler !== "function") return;
+      var strKey = (PREFIX + key).toUpperCase();
+      if (config[key].type === "radio") {
+        handler(settings.get(key, config[key].default));
+      }
+      if (!events[strKey]) {
+        events[strKey] = [handler];
+      } else {
+        events[strKey].push(handler);
+      }
+    }
+  };
+  global.settings = settings;
+})(window);

assets/js/theme.js

@@ -1,45 +1,70 @@
----
-layout: null
----
-var darkTheme = document.createElement("link");
-darkTheme.rel = "stylesheet alternate";
-darkTheme.href = "{{ '/assets/css/dark.css' | relative_url }}";
-document.head.appendChild(darkTheme);
-window.addEventListener("DOMContentLoaded", function () {
-    var list = document.querySelector(".masthead .visible-links");
-    if (!list) return;
-    var mediaQuery = window.matchMedia("(prefers-color-scheme: dark)");
-    function handler() {
-        darkTheme.rel = mediaQuery.matches ? "stylesheet" : "stylesheet alternate";
-    }
-    var current = 0;
-    var modes = ["light", "dark", "auto"];
-    var modeNames = ["亮色", "暗色", "自动"];
-    var switcher = document.createElement("a");
-    switcher.className = "masthead__menu-item";
-    switcher.innerText = modeNames[current];
-    switcher.href = "javascript:;";
-    switcher.onclick = function () {
-        themeApply(current + 1);
-    }
-    list.appendChild(switcher);
-    function themeApply(index) {
-        index = (Number(index) || 0) % modes.length;
-        if (index === current) return;
-        if (modes[current] === "auto") mediaQuery.removeEventListener("change", handler);
-        current = index;
-        var mode = modes[current];
-        switcher.innerText = modeNames[current];
-        localStorage.setItem("theme", current);
-        if (mode === "light") darkTheme.rel = "stylesheet alternate";
-        else if (mode === "dark") darkTheme.rel = "stylesheet";
-        else {
-            mediaQuery.addEventListener("change", handler);
-            handler();
-        }
-    }
-    themeApply(localStorage.getItem("theme"));
-    window.addEventListener("storage", function (event) {
-        event.key === "theme" && themeApply(event.newValue);
-    });
-});
+---
+layout: null
+---
+window.addEventListener("DOMContentLoaded", function () {
+  var skinLink = document.getElementById("skin");
+  var darkModeQuery = window.matchMedia("(prefers-color-scheme: dark)");
+  function applyDarkSkin() {
+    skinLink.href = "{{ '/assets/css/skins/' | relative_url }}" + settings.get("appearance_skin_dark", "dark") + ".css";
+  }
+  function applyLightSkin() {
+    skinLink.href = "{{ '/assets/css/skins/' | relative_url }}" + settings.get("appearance_skin_light", "default") + ".css";
+  }
+  function autoSchemeHandler() {
+    if (darkModeQuery.matches) {
+      applyDarkSkin();
+    } else {
+      applyLightSkin();
+    }
+  }
+  var activeModeIndex = 0;
+  var modeKeys = ["light", "dark", "auto"];
+  var modeLabels = ["亮色", "暗色", "自动"];
+
+  var menuList = document.querySelector(".masthead .visible-links");
+  var modeSwitcher = null;
+  if (menuList) {
+    modeSwitcher = document.createElement("a");
+    modeSwitcher.className = "masthead__menu-item";
+    modeSwitcher.textContent = modeLabels[activeModeIndex];
+    modeSwitcher.href = "javascript:;";
+    modeSwitcher.onclick = function () {
+      var nextIndex = (activeModeIndex + 1) % modeKeys.length;
+      settings.set("appearance_color", modeKeys[nextIndex]);
+    }
+    menuList.appendChild(modeSwitcher);
+  }
+  function applyTheme(mode) {
+    var newIndex = modeKeys.indexOf(mode);
+    if (newIndex < 0) newIndex = 0;
+
+    if (modeKeys[activeModeIndex] === "auto") {
+      darkModeQuery.removeEventListener("change", autoSchemeHandler);
+    }
+
+    activeModeIndex = newIndex;
+    var resolvedMode = modeKeys[activeModeIndex];
+
+    if (modeSwitcher) {
+      modeSwitcher.textContent = modeLabels[activeModeIndex];
+    }
+
+    if (resolvedMode === "light") {
+      applyLightSkin();
+    }
+    else if (resolvedMode === "dark") {
+      applyDarkSkin();
+    }
+    else {
+      darkModeQuery.addEventListener("change", autoSchemeHandler);
+      autoSchemeHandler();
+    }
+  }
+  settings.onChange("appearance_color", applyTheme);
+  settings.onChange("appearance_skin_dark", function () {
+    settings.refresh("appearance_color");
+  });
+  settings.onChange("appearance_skin_light", function () {
+    settings.refresh("appearance_color");
+  });
+});

settings.yaml

@@ -0,0 +1,43 @@
+---
+title: 设置
+layout: settings
+permalink: /settings.html
+data:
+  - title: 外观
+    settings:
+      appearance_color:
+        title: 颜色模式
+        description: 用于切换站点主题颜色模式。
+        options:
+          light: 亮色
+          dark: 暗色
+          auto: 自动
+      appearance_skin_light:
+        title: 亮色皮肤
+        description: 亮色模式下应用的皮肤。
+        options:
+          default: 默认
+          air: 天空
+          aqua: 水蓝
+          contrast: 高对比
+          dark: 暗色
+          dirt: 泥土
+          neon: 霓虹
+          mint: 薄荷
+          plum: 梅紫
+          sunrise: 日出
+      appearance_skin_dark:
+        title: 暗色皮肤
+        description: 暗色模式下应用的皮肤。
+        options:
+          default: 默认
+          air: 天空
+          aqua: 水蓝
+          contrast: 高对比
+          dark: 暗色
+          dirt: 泥土
+          neon: 霓虹
+          mint: 薄荷
+          plum: 梅紫
+          sunrise: 日出
+---