添加一种新的 frontmatter 格式 (#466)

neveler · web-flow · commit 8898bb599740 · 2026-06-07T17:31:45.000+08:00
diff --git a/_plugins/front_matter_enhancer.rb b/_plugins/front_matter_enhancer.rb
@@ -0,0 +1,13 @@
+module Jekyll
+  class Document
+    YAML_FRONT_MATTER_REGEXP = %r!\A(?:---|/\* @frontmatter)\s*\n(.*?\n?)^((?:---|\*/|\.\.\.)\s*$\n?)!m.freeze
+  end
+
+  module Utils
+    def has_yaml_header?(file)
+      File.open(file, "rb", &:readline).match? %r!\A(---|/\* @frontmatter)\s*\r?\n!
+    rescue EOFError
+      false
+    end
+  end
+end
diff --git a/_plugins/version_sort_filter.rb b/_plugins/version_sort_filter.rb
diff --git a/assets/css/main.scss b/assets/css/main.scss
@@ -1,5 +1,5 @@
----
----
+/* @frontmatter
+*/
 
 @charset "utf-8";
 
diff --git a/assets/css/skins/air.scss b/assets/css/skins/air.scss
@@ -1,5 +1,5 @@
----
----
+/* @frontmatter
+*/
 
 @charset "utf-8";
 
diff --git a/assets/css/skins/aqua.scss b/assets/css/skins/aqua.scss
@@ -1,5 +1,5 @@
----
----
+/* @frontmatter
+*/
 
 @charset "utf-8";
 
diff --git a/assets/css/skins/catppuccin_latte.scss b/assets/css/skins/catppuccin_latte.scss
@@ -1,5 +1,5 @@
----
----
+/* @frontmatter
+*/
 
 @charset "utf-8";
 
diff --git a/assets/css/skins/catppuccin_mocha.scss b/assets/css/skins/catppuccin_mocha.scss
@@ -1,5 +1,5 @@
----
----
+/* @frontmatter
+*/
 
 @charset "utf-8";
 
diff --git a/assets/css/skins/contrast.scss b/assets/css/skins/contrast.scss
@@ -1,5 +1,5 @@
----
----
+/* @frontmatter
+*/
 
 @charset "utf-8";
 
diff --git a/assets/css/skins/dark.scss b/assets/css/skins/dark.scss
@@ -1,5 +1,5 @@
----
----
+/* @frontmatter
+*/
 
 @charset "utf-8";
 
diff --git a/assets/css/skins/default.scss b/assets/css/skins/default.scss
@@ -1,2 +1,2 @@
----
----
+/* @frontmatter
+*/
diff --git a/assets/css/skins/dirt.scss b/assets/css/skins/dirt.scss
@@ -1,5 +1,5 @@
----
----
+/* @frontmatter
+*/
 
 @charset "utf-8";
 
diff --git a/assets/css/skins/mint.scss b/assets/css/skins/mint.scss
@@ -1,5 +1,5 @@
----
----
+/* @frontmatter
+*/
 
 @charset "utf-8";
 
diff --git a/assets/css/skins/neon.scss b/assets/css/skins/neon.scss
@@ -1,5 +1,5 @@
----
----
+/* @frontmatter
+*/
 
 @charset "utf-8";
 
diff --git a/assets/css/skins/plum.scss b/assets/css/skins/plum.scss
@@ -1,5 +1,5 @@
----
----
+/* @frontmatter
+*/
 
 @charset "utf-8";
 
diff --git a/assets/css/skins/sunrise.scss b/assets/css/skins/sunrise.scss
@@ -1,5 +1,5 @@
----
----
+/* @frontmatter
+*/
 
 @charset "utf-8";
 
diff --git a/assets/js/settings.js b/assets/js/settings.js
@@ -1,6 +1,7 @@
----
+/* @frontmatter
 layout: null
----
+*/
+
 (function () {
   const PREFIX = "HMCL_DOCS_SETTINGS_", data = {}, bus = new EventTarget(), configs = /*{%comment%}*/{}/*{%endcomment%}*/ /**{{'/'}}{{ site.data.settings | jsonify }}/**/;
   window.addEventListener("storage", ({ key, newValue }) => key !== null && key.startsWith(PREFIX) && newValue !== data[key] && bus.dispatchEvent(new CustomEvent(key, { detail: (data[key] = newValue) })));
diff --git a/assets/js/theme.js b/assets/js/theme.js
@@ -1,6 +1,7 @@
----
+/* @frontmatter
 layout: null
----
+*/
+
 window.addEventListener("DOMContentLoaded", function () {
   var skinLink = document.getElementById("skin");
   var darkModeQuery = window.matchMedia("(prefers-color-scheme: dark)");

-Original file line number
+Diff line change
@@ @@ -1,5 +1,5 @@ @@
 ----
 ----
 +/* @frontmatter
 +*/
 @charset "utf-8";