@chengzhao-dev/dsh-quarto-book 0.4.2 → 0.5.0

package/skills/designing-theme/assets/theme/palettes/flexoki/highlight-light.theme

@@ -0,0 +1,214 @@
+{
+    "metadata": {
+        "name": "Quarto Book Flexoki Light",
+        "revision": 1,
+        "license": "SPDX-License-Identifier: MIT",
+        "copyright": [
+            "SPDX-FileCopyrightText: Steph Ango (Flexoki, MIT)",
+            "SPDX-FileCopyrightText: 2020 Waqar Ahmed <waqar.17a@gmail.com> (skylighting 结构基础)"
+        ]
+    },
+    "background-color": "#f2f0e5",
+    "editor-colors": {
+        "BackgroundColor": "#f2f0e5",
+        "BracketMatching": "#e6e4d9",
+        "CodeFolding": "#f2f0e5",
+        "CurrentLine": "#f2f0e5",
+        "CurrentLineNumber": "#100f0f",
+        "IconBorder": "#f2f0e5",
+        "IndentationLine": "#e6e4d9",
+        "LineNumbers": "#6f6e69",
+        "MarkBookmark": "#205ea6",
+        "MarkBreakpointActive": "#af3029",
+        "MarkBreakpointDisabled": "#5e409d",
+        "MarkBreakpointReached": "#ad8301",
+        "MarkError": "#af3029",
+        "MarkExecution": "#5e409d",
+        "MarkWarning": "#bc5215",
+        "ModifiedLines": "#af3029",
+        "ReplaceHighlight": "#66800b",
+        "SavedLines": "#66800b",
+        "SearchHighlight": "#d0a215",
+        "Separator": "#dad8ce",
+        "SpellChecking": "#af3029",
+        "TabMarker": "#b7b5ac",
+        "TextSelection": "#e6e4d9",
+        "WordWrapMarker": "#dad8ce"
+    },
+    "text-styles": {
+        "Alert": {
+            "bold": true,
+            "selected-text-color": "#af3029",
+            "text-color": "#af3029"
+        },
+        "Annotation": {
+            "selected-text-color": "#6f6e69",
+            "text-color": "#6f6e69"
+        },
+        "Attribute": {
+            "selected-text-color": "#ad8301",
+            "text-color": "#ad8301"
+        },
+        "BaseN": {
+            "selected-text-color": "#5e409d",
+            "text-color": "#5e409d"
+        },
+        "BuiltIn": {
+            "selected-text-color": "#a02f6f",
+            "text-color": "#a02f6f"
+        },
+        "Char": {
+            "selected-text-color": "#24837b",
+            "text-color": "#24837b"
+        },
+        "Comment": {
+            "selected-text-color": "#575653",
+            "text-color": "#575653"
+        },
+        "CommentVar": {
+            "selected-text-color": "#575653",
+            "text-color": "#575653"
+        },
+        "Constant": {
+            "selected-text-color": "#5e409d",
+            "text-color": "#5e409d"
+        },
+        "ControlFlow": {
+            "selected-text-color": "#66800b",
+            "text-color": "#66800b"
+        },
+        "DataType": {
+            "selected-text-color": "#ad8301",
+            "text-color": "#ad8301"
+        },
+        "DecVal": {
+            "selected-text-color": "#5e409d",
+            "text-color": "#5e409d"
+        },
+        "Documentation": {
+            "selected-text-color": "#575653",
+            "text-color": "#575653"
+        },
+        "Error": {
+            "selected-text-color": "#af3029",
+            "text-color": "#af3029",
+            "underline": true
+        },
+        "Extension": {
+            "bold": true,
+            "selected-text-color": "#af3029",
+            "text-color": "#af3029"
+        },
+        "Float": {
+            "selected-text-color": "#5e409d",
+            "text-color": "#5e409d"
+        },
+        "Function": {
+            "selected-text-color": "#bc5215",
+            "text-color": "#bc5215",
+            "bold": true
+        },
+        "Import": {
+            "selected-text-color": "#af3029",
+            "text-color": "#af3029"
+        },
+        "Information": {
+            "selected-text-color": "#6f6e69",
+            "text-color": "#6f6e69"
+        },
+        "Keyword": {
+            "selected-text-color": "#66800b",
+            "text-color": "#66800b"
+        },
+        "Normal": {
+            "selected-text-color": "#100f0f",
+            "text-color": "#100f0f"
+        },
+        "Operator": {
+            "selected-text-color": "#af3029",
+            "text-color": "#af3029"
+        },
+        "Others": {
+            "selected-text-color": "#5e409d",
+            "text-color": "#5e409d"
+        },
+        "Preprocessor": {
+            "selected-text-color": "#205ea6",
+            "text-color": "#205ea6"
+        },
+        "RegionMarker": {
+            "selected-text-color": "#6f6e69",
+            "text-color": "#6f6e69"
+        },
+        "SpecialChar": {
+            "selected-text-color": "#5e409d",
+            "text-color": "#5e409d"
+        },
+        "SpecialString": {
+            "selected-text-color": "#24837b",
+            "text-color": "#24837b"
+        },
+        "String": {
+            "selected-text-color": "#24837b",
+            "text-color": "#24837b"
+        },
+        "Variable": {
+            "selected-text-color": "#205ea6",
+            "text-color": "#205ea6"
+        },
+        "VerbatimString": {
+            "selected-text-color": "#24837b",
+            "text-color": "#24837b"
+        },
+        "Warning": {
+            "selected-text-color": "#bc5215",
+            "text-color": "#bc5215"
+        }
+    },
+    "custom-styles": {
+        "INI Files": {
+            "Section": {
+                "selected-text-color": "#5e409d",
+                "text-color": "#5e409d"
+            }
+        },
+        "Python": {
+            "Builtin Function": {
+                "selected-text-color": "#a02f6f",
+                "text-color": "#a02f6f"
+            },
+            "Import": {
+                "selected-text-color": "#af3029",
+                "text-color": "#af3029"
+            },
+            "Special Variable": {
+                "selected-text-color": "#205ea6",
+                "text-color": "#205ea6"
+            }
+        },
+        "Rust": {
+            "Attribute": {
+                "selected-text-color": "#ad8301",
+                "text-color": "#ad8301"
+            },
+            "Macro": {
+                "selected-text-color": "#205ea6",
+                "text-color": "#205ea6"
+            },
+            "Self": {
+                "selected-text-color": "#a02f6f",
+                "text-color": "#a02f6f"
+            },
+            "Trait": {
+                "selected-text-color": "#bc5215",
+                "text-color": "#bc5215"
+            }
+        },
+        "XML": {
+            "Element": {
+                "selected-text-color": "#205ea6",
+                "text-color": "#205ea6"
+            }
+        }
+    }
+}

package/skills/designing-theme/assets/theme/palettes/flexoki/meta.md

@@ -0,0 +1,53 @@
+# Palette: flexoki
+
+编译默认色板。亮色用 Flexoki 的纸色页面（`#FFFCF0`）与墨色正文（`#100F0F`），暗色反转为墨色页面（`#100F0F`）与纸色正文（`#CECDC3`）；链接遵循 Flexoki 官方 UI 映射：常态与正文同墨色（亮 `#100F0F` / 暗 `#CECDC3`）并保留下划线，hover 才转 `cy`（亮 `#24837B` / 暗 `#3AA99F`）；`bl` 蓝只留给变量/属性与语法。代码语法色用本目录两份 skylighting 主题 `highlight-light.theme` / `highlight-dark.theme`，按 Flexoki 官方 VS Code 主题的语法映射取色（[kepano/flexoki](https://github.com/kepano/flexoki)），不再用 Quarto 内置高亮。Solarized 作为运行时可选色板放在同级 `solarized/`，只覆盖令牌与语法色，不改编译配置。
+
+一处抬色：亮色注释从官方 `#6F6E69` 抬到 base-700 `#575653`（代码底 `#F2F0E5` 上 4.47:1 → 6.42:1），行号同步用 `#575653`；暗色注释保持官方 `#878580`（`#1C1B1A` 上 4.67:1）。亮色强调色与正文同为 `#100F0F`，靠字重区分，不引入纯黑。官方文档注释档（亮 `#B7B5AC` / 暗 `#575653`）对比不足，未采用。取舍见 `knowledge/reading-surface.md` 的「颜色与对比度的取值依据」。
+
+## 接线
+
+| 项 | 路径 / 值 |
+| --- | --- |
+| tokens | `palettes/flexoki/tokens.css` |
+| SCSS light | `palettes/flexoki/theme-light.scss` |
+| SCSS dark | `palettes/flexoki/theme-dark.scss` |
+| highlight light | `assets/theme/palettes/flexoki/highlight-light.theme` |
+| highlight dark | `assets/theme/palettes/flexoki/highlight-dark.theme` |
+| brand mark | `palettes/flexoki/brand-mark.svg` |
+| favicon light | `palettes/flexoki/favicon-light.svg` |
+| favicon dark | `palettes/flexoki/favicon-dark.svg` |
+
+`_quarto.yml` 的 `theme` 与 `highlight-style` 指向本目录；`css` 里本目录 tokens 必须排在 `palettes/solarized/tokens.css` 之前。
+
+## 书标与标签图标
+
+两套色板共用同一枚「打开的书」：`brand-mark.svg` 是纯黑剪影、中缝镂空，16px 仍可辨认，顶栏用 mask 取 `--navbar-fg`，一份覆盖该色板明暗；`favicon-light.svg` / `favicon-dark.svg` 是圆角方底加同一枚书，底色/书/中缝分别用该色板的纸色、墨色、动作色。Flexoki 亮色 `#FFFCF0`/`#100F0F`/`#24837B`，暗色 `#100F0F`/`#FFFCF0`/`#3AA99F`。
+
+用书项目在 `_quarto.yml` 设 `book.favicon: theme/palettes/flexoki/favicon-light.svg`，并把另外三份 favicon 放进 `resources`。`includes/palette.html` 在 head 内按 `book-palette` 与明暗改 `link[rel=icon]` 的 href，只替换 URL 里的色板名与 `favicon-light|dark`，保留 Quarto 写好的 `./` / `../` 前缀；发布 URL 仍带 `palettes/<name>/`。
+
+## 页面分层
+
+| 表面 | 亮色 | 暗色 |
+| --- | --- | --- |
+| page / navbar | `#FFFCF0` | `#100F0F` |
+| surface-raised / code / card | `#F2F0E5` | `#1C1B1A` |
+| 代码标题条 | `#E6E4D9` | `#282726` |
+| 边框 | `#DAD8CE` | `#343331` |
+| 正文 / 次要文字 | `#100F0F` / `#6F6E69` | `#CECDC3` / `#9F9D96` |
+| 链接常态 / hover | `#100F0F` / `#24837B` | `#CECDC3` / `#3AA99F` |
+
+Callout 是编辑注：2px 左条、`-bg: transparent`、无圆角；note 用中性 base-600 / base-400，warning 用官方 orange（亮 `#BC5215` / 暗 `#DA702C`），不把黄当警告。
+
+暗色次要文字保留 Flexoki base-400 `#9F9D96`：它在墨色底上 7.05:1，介于 base-300 `#B7B5AC` 与 base-500 `#878580` 之间，比正文 `#CECDC3` 低一档，不抢正文但仍高于 4.5:1。
+
+## 切换
+
+Flexoki 是编译默认：`_quarto.yml` 的 `theme`、`highlight-style` 都指向本目录。读者切到 Solarized 只改 `html[data-palette="solarized"]`，由 `palettes/solarized/tokens.css` 与 `syntax.css` 覆盖；选择器与首屏恢复在 `includes/palette.html`。
+
+## 来源
+
+- [Flexoki](https://stephango.com/flexoki)（Steph Ango，MIT）
+- [kepano/flexoki](https://github.com/kepano/flexoki)（色值与 VS Code 语法映射）
+- Flexoki 官方 VS Code 主题 `Flexoki Light` / `Flexoki Dark`
+
+本目录 9 个文件随主题资产走；项目副本只同步到 `_quarto.yml` 实际引用的那份。

package/skills/designing-theme/assets/theme/palettes/flexoki/theme-dark.scss

@@ -0,0 +1,43 @@
+/*-- scss:defaults --*/
+
+$font-family-sans-serif: "LXGW Bright Medium", system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", "PingFang SC", "Hiragino Sans GB", "Microsoft YaHei", "Noto Sans CJK SC", "Source Han Sans SC", "Apple Color Emoji", "Segoe UI Emoji", sans-serif !default;
+
+$font-family-monospace: "LXGW Bright Code", ui-monospace, SFMono-Regular, "SF Mono", Menlo, Consolas, "Liberation Mono", "Courier New", "PingFang SC", "Microsoft YaHei", "Noto Sans CJK SC", "Source Han Sans SC", monospace !default;
+
+$web-font-path: false !default;
+
+$font-size-root: 16px !default;
+$line-height-base: 1.75 !default;
+$font-size-base: 1rem !default;
+
+// Flexoki Dark：墨色页面 + accent-400；链接同正文色，cy 只作 hover / 动作色
+$primary: #3AA99F !default;
+
+$body-color: #CECDC3 !default;
+$link-color: #CECDC3 !default;
+
+$code-bg: #1C1B1A !default;
+$code-color: #CECDC3 !default;
+
+$body-secondary: #9F9D96 !default;
+
+$navbar-fg: #CECDC3 !default;
+
+$callout-color-note: #9F9D96 !default;
+$callout-color-tip: #879A39 !default;
+$callout-color-warning: #DA702C !default;
+$callout-color-important: #8B7EC8 !default;
+$callout-color-caution: #D14D41 !default;
+$callout-color-danger: #D14D41 !default;
+
+$border-color: rgba(206, 205, 195, 0.1) !default;
+
+// 面包屑用页面底色：清除 darkly 默认灰底与内边距，明暗布局一致
+$breadcrumb-bg: transparent !default;
+$breadcrumb-padding-y: 0 !default;
+$breadcrumb-padding-x: 0 !default;
+$breadcrumb-margin-bottom: 0 !default;
+
+$table-bg: transparent !default;
+
+/*-- scss:rules --*/

package/skills/designing-theme/assets/theme/palettes/flexoki/theme-light.scss

@@ -0,0 +1,40 @@
+/*-- scss:defaults --*/
+
+$font-family-sans-serif: "LXGW Bright Medium", system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", "PingFang SC", "Hiragino Sans GB", "Microsoft YaHei", "Noto Sans CJK SC", "Source Han Sans SC", "Apple Color Emoji", "Segoe UI Emoji", sans-serif !default;
+
+$font-family-monospace: "LXGW Bright Code", ui-monospace, SFMono-Regular, "SF Mono", Menlo, Consolas, "Liberation Mono", "Courier New", "PingFang SC", "Microsoft YaHei", "Noto Sans CJK SC", "Source Han Sans SC", monospace !default;
+
+$web-font-path: false !default;
+
+$font-size-root: 16px !default;
+$line-height-base: 1.75 !default;
+$font-size-base: 1rem !default;
+
+// Flexoki Light：纸色页面 + 低饱和功能色；链接同墨色，cy 只作 hover / 动作色
+$primary: #24837B !default;
+
+$body-color: #100F0F !default;
+$link-color: #100F0F !default;
+$code-bg: #F2F0E5 !default;
+$code-color: #100F0F !default;
+$border-color: #DAD8CE !default;
+
+// 面包屑用页面底色：清除 darkly 默认灰底与内边距，明暗布局一致
+$breadcrumb-bg: transparent !default;
+$breadcrumb-padding-y: 0 !default;
+$breadcrumb-padding-x: 0 !default;
+$breadcrumb-margin-bottom: 0 !default;
+
+
+$navbar-bg: #FFFCF0 !default;
+$navbar-fg: #100F0F !default;
+
+// Callout 语义色（与 palettes/flexoki/tokens.css --callout-*-border 亮色一致；驱动编译期图标 data URI）
+$callout-color-note: #6F6E69 !default;
+$callout-color-tip: #66800B !default;
+$callout-color-warning: #BC5215 !default;
+$callout-color-important: #5E409D !default;
+$callout-color-caution: #AF3029 !default;
+$callout-color-danger: #AF3029 !default;
+
+/*-- scss:rules --*/

package/skills/designing-theme/assets/theme/palettes/flexoki/tokens.css

@@ -0,0 +1,156 @@
+/* ============================================================
+   Palette: flexoki · Flexoki Light / Dark 色值
+   结构尺度见 css/tokens.css；本文件只提供语义颜色。
+   官方页面色：亮纸 #FFFCF0、暗底 #100F0F。
+   链接按官方映射取 cy（亮 accent-600 #24837B、暗 accent-400 #3AA99F），
+   常态与正文同墨色，hover 才转为 cy；bl 只留给变量/属性。
+   ============================================================ */
+
+body {
+  /* Flexoki Light 页面令牌 */
+  --body-color: #100F0F;
+  /* 正文强调（strong）：与正文同一墨色，靠字重区分；Flexoki 的墨色本就不是纯黑。 */
+  --emphasis-color: #100F0F;
+  /* Flexoki Light 代码块色板；语义 token 由 Pandoc/Quarto 提供。 */
+  --code-bg: #F2F0E5;
+  --code-border: #DAD8CE;
+  --code-fg: #100F0F;
+  --code-title-bg: #E6E4D9;
+  --code-title-fg: #575653;
+  --line-num-color: #575653;
+  --inline-code-bg: rgba(16, 15, 15, 0.06);
+  --inline-code-fg: #100F0F;
+  --text-secondary: #6F6E69;
+  /* 链接常态=墨色（Tufte / 官方站点）；hover 才用 cy。 */
+  --link-color: #100F0F;
+  --link-hover-color: #24837B;
+  --link-underline: rgba(16, 15, 15, 0.38);
+  --text-link: var(--link-color);
+  --text-underline: var(--link-underline);
+  --action-color: #24837B;
+  --table-border: #B7B5AC;
+  /* callout：编辑注，无填充；note 用中性灰，tip/warning/important/caution 用官方语义 accent。 */
+  --callout-note-border: #6F6E69;
+  --callout-note-bg: transparent;
+  --callout-tip-border: #66800B;
+  --callout-tip-bg: transparent;
+  --callout-warning-border: #BC5215;
+  --callout-warning-bg: transparent;
+  --callout-important-border: #5E409D;
+  --callout-important-bg: transparent;
+  --callout-caution-border: #AF3029;
+  --callout-caution-bg: transparent;
+  --copy-btn-bg: #FFFCF0;
+  --copy-btn-border: #DAD8CE;
+  --scrollbar-thumb: #B7B5AC;
+  --selection-bg: rgba(187, 220, 206, 0.30);
+  --mark-bg: rgba(208, 162, 21, 0.28);
+  --sidebar-hover-bg: rgba(16, 15, 15, 0.04);
+  --sidebar-active-bg: rgba(36, 131, 123, 0.10);
+  --sidebar-fg: #6F6E69;
+  --accent: var(--action-color);
+  --navbar-bg: #FFFCF0;
+  --navbar-fg: #100F0F;
+  --navbar-muted: #6F6E69;
+  --navbar-border: #DAD8CE;
+  --navbar-input-bg: #F2F0E5;
+  --navbar-hover-bg: rgba(16, 15, 15, 0.04);
+  --navbar-secondary-bg: rgba(255, 252, 240, 0.88);
+  --dot-accent: #24837B;
+  --card-bg: transparent;
+  --card-border: #DAD8CE;
+  --overlay-scrim: rgba(0, 0, 0, 0.42);
+  /* 右目录当前项与侧栏一致：正文色加色条，不涂链接色 */
+  --toc-active: var(--body-color);
+  --page-bg: #FFFCF0;
+  --surface-raised: #F2F0E5;
+  --sidebar-bg: transparent;
+  --line-num-bg: rgba(16, 15, 15, 0.04);
+  --line-hover-bg: rgba(36, 131, 123, 0.06);
+}
+
+body.quarto-dark {
+  /* Flexoki Dark 页面令牌 */
+  --body-color: #CECDC3;
+  /* 正文强调（strong）：比正文更亮一档的纸白 */
+  --emphasis-color: #FFFCF0;
+  /* Flexoki Dark 代码块色板，与页面明暗模式同步。 */
+  --code-bg: #1C1B1A;
+  --code-border: #343331;
+  --code-fg: #CECDC3;
+  --code-title-bg: #282726;
+  --code-title-fg: #B7B5AC;
+  --line-num-color: #878580;
+  --inline-code-bg: rgba(206, 205, 195, 0.08);
+  --inline-code-fg: #CECDC3;
+  --text-secondary: #9F9D96;
+  /* 链接常态=正文纸色；hover 才用 cy-400。 */
+  --link-color: #CECDC3;
+  --link-hover-color: #3AA99F;
+  --link-underline: rgba(206, 205, 195, 0.35);
+  --text-link: var(--link-color);
+  --text-underline: var(--link-underline);
+  --action-color: #3AA99F;
+  --table-border: #575653;
+  --callout-note-border: #9F9D96;
+  --callout-note-bg: transparent;
+  --callout-tip-border: #879A39;
+  --callout-tip-bg: transparent;
+  --callout-warning-border: #DA702C;
+  --callout-warning-bg: transparent;
+  --callout-important-border: #8B7EC8;
+  --callout-important-bg: transparent;
+  --callout-caution-border: #D14D41;
+  --callout-caution-bg: transparent;
+  /* 复制按钮边框：半透明 --text-secondary——按钮底与代码块底同为 #1C1B1A */
+  --copy-btn-bg: #1C1B1A;
+  --copy-btn-border: rgba(183, 181, 172, 0.4);
+  --scrollbar-thumb: #575653;
+  --selection-bg: rgba(30, 95, 91, 0.30);
+  --mark-bg: rgba(208, 162, 21, 0.28);
+  --sidebar-hover-bg: rgba(206, 205, 195, 0.06);
+  --sidebar-active-bg: rgba(58, 169, 159, 0.16);
+  --sidebar-fg: #9F9D96;
+  --accent: var(--action-color);
+  --navbar-bg: #100F0F;
+  --navbar-fg: #CECDC3;
+  --navbar-muted: #9F9D96;
+  --navbar-border: #343331;
+  --navbar-input-bg: #1C1B1A;
+  --navbar-hover-bg: rgba(206, 205, 195, 0.07);
+  --navbar-secondary-bg: rgba(16, 15, 15, 0.90);
+  --dot-accent: #3AA99F;
+  --card-bg: transparent;
+  --card-border: #343331;
+  --overlay-scrim: rgba(0, 0, 0, 0.62);
+  /* 右目录当前项与侧栏一致：正文色加色条，不涂链接色 */
+  --toc-active: var(--body-color);
+  --page-bg: #100F0F;
+  --surface-raised: #1C1B1A;
+  --sidebar-bg: transparent;
+  --line-num-bg: rgba(206, 205, 195, 0.05);
+  --line-hover-bg: rgba(58, 169, 159, 0.08);
+  color-scheme: dark;
+}
+
+@media (prefers-contrast: more) {
+  body {
+    --body-color: #000000;
+    --emphasis-color: #000000;
+    --link-color: #000000;
+    --code-border: #878580;
+    --card-border: #878580;
+    --navbar-border: #878580;
+  }
+
+  body.quarto-dark {
+    --body-color: #FFFCF0;
+    --code-fg: #FFFCF0;
+    --inline-code-fg: #FFFCF0;
+    --emphasis-color: #FFFCF0;
+    --link-color: #FFFCF0;
+    --code-border: #6F6E69;
+    --card-border: #6F6E69;
+    --navbar-border: #6F6E69;
+  }
+}

package/skills/designing-theme/assets/theme/palettes/hill-light/brand-mark.svg

@@ -0,0 +1,3 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64" role="img" aria-label="书">
+  <path fill="#000000" fill-rule="evenodd" d="M32 18c-6-5-15-7-24-6v36c9-1 18 1 24 6 6-5 15-7 24-6V12c-9-1-18 1-24 6Zm-2 3v29c-5-3-11-4-17-4V16c6 0 12 2 17 5Zm4 0c5-3 11-5 17-5v30c-6 0-12 1-17 4V21Z"/>
+</svg>

package/skills/designing-theme/assets/theme/palettes/hill-light/favicon-dark.svg

@@ -0,0 +1,5 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64" role="img" aria-label="书">
+  <rect width="64" height="64" rx="14" fill="#1B2223"/>
+  <path fill="#D7DDD9" fill-rule="evenodd" d="M32 18c-6-5-15-7-24-6v36c9-1 18 1 24 6 6-5 15-7 24-6V12c-9-1-18 1-24 6Zm-2 3v29c-5-3-11-4-17-4V16c6 0 12 2 17 5Zm4 0c5-3 11-5 17-5v30c-6 0-12 1-17 4V21Z"/>
+  <rect x="30" y="20" width="4" height="32" fill="#8CB9AE"/>
+</svg>

package/skills/designing-theme/assets/theme/palettes/hill-light/favicon-light.svg

@@ -0,0 +1,5 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64" role="img" aria-label="书">
+  <rect width="64" height="64" rx="14" fill="#F2EFE7"/>
+  <path fill="#2B3538" fill-rule="evenodd" d="M32 18c-6-5-15-7-24-6v36c9-1 18 1 24 6 6-5 15-7 24-6V12c-9-1-18 1-24 6Zm-2 3v29c-5-3-11-4-17-4V16c6 0 12 2 17 5Zm4 0c5-3 11-5 17-5v30c-6 0-12 1-17 4V21Z"/>
+  <rect x="30" y="20" width="4" height="32" fill="#2D6A66"/>
+</svg>

package/skills/designing-theme/assets/theme/palettes/hill-light/meta.md

@@ -0,0 +1,78 @@
+# Palette: hill-light（山光）
+
+运行时可选色板。读者在导航栏选「山光」后，`html[data-palette="hill-light"]` 与 `html[data-mode="dawn|noon|dusk|night"]` 同时生效：`tokens.css` 覆盖语义颜色，`syntax.css` 覆盖语法色。色值取自用户自己的仓库 `D:\Github\hill-light\hill-light-theme\css\tokens.css`（单一色值来源），四种时辰沿用原站命名：晓雾 `dawn`、午荫 `noon`、暮烟 `dusk`、夜月 `night`；夜月是唯一暗色时辰，其余三种都在浅纸上。
+
+本插件与山光原站的取舍写在「与 hill-light 的偏离」一节：栏宽、字体、callout 类型色、语法色都没有照搬原站，理由逐条记录。
+
+## 接线
+
+| 项 | 路径 / 值 |
+| --- | --- |
+| tokens | `palettes/hill-light/tokens.css` |
+| syntax 覆盖 | `palettes/hill-light/syntax.css` |
+| brand mark | `palettes/hill-light/brand-mark.svg` |
+| favicon light | `palettes/hill-light/favicon-light.svg`（晓雾/午荫/暮烟共用） |
+| favicon dark | `palettes/hill-light/favicon-dark.svg`（夜月） |
+
+当前 `_quarto.yml` **不**引用本目录的 SCSS 与 highlight 主题，只挂 `tokens.css` + `syntax.css`，原因和 Solarized 不同：Quarto 只能编译一对 light/dark 高亮与一对 Bootstrap 主题，而山光有四种时辰，任何一种都会被编译期固定成两态。所以山光只做运行时层：语法色由 `syntax.css` 按 `html[data-palette="hill-light"][data-mode]` 覆盖 `code span.*`，没有 `.theme` 与 SCSS 素材。
+
+## 四时切换
+
+| 项 | 值 |
+| --- | --- |
+| 属性 | `html[data-palette="hill-light"][data-mode="dawn\|noon\|dusk\|night"]` |
+| 存储键 | `localStorage["book-hill-mode"]` |
+| 默认时辰 | 按本地时间：06–11 晓雾、11–17 午荫、17–20 暮烟，其余夜月 |
+| 明暗 | `data-mode="night"` 同时声明 `color-scheme: dark`，`includes/palette.html` 的 `isDark()` 也以夜月为准 |
+| Quarto 明暗钮 | 山光下隐藏（`css/nav.css`）：山光的明暗由时辰决定，两套开关并存会互相看不出谁生效 |
+| 控件 | 导航栏色板分段控件右侧的四段胶囊；≤575.98px 退成四个圆点 |
+
+切走山光时 `data-mode` 被移除，避免其他色板误吃四时令牌。四种模式的 `body` 令牌用 `html[data-palette="hill-light"][data-mode="…"] body` 选择器，比共享的 `body` / `body.quarto-dark` 令牌（Flexoki 默认）特异性高，因此无论 Quarto 处在明暗哪一态，山光都稳定生效。
+
+## 页面分层
+
+| 表面 | 晓雾 dawn | 午荫 noon | 暮烟 dusk | 夜月 night |
+| --- | --- | --- | --- | --- |
+| page / navbar | `#F2EFE7` | `#FAF6EC` | `#F1E2D0` | `#1B2223` |
+| surface-raised | `#F8F5EE` | `#FFFCF4` | `#F8EBDA` | `#232B2C` |
+| 代码底 / 代码边 | `#E9E5DA` / `#D6D2C6` | `#F0EBDD` / `#D8D3C3` | `#E8D6C1` / `#D8C4AE` | `#283132` / `#3A4644` |
+| 正文 / 次要文字 | `#2B3538` / `#58686B` | `#263230` / `#4F615B` | `#3A2C26` / `#67534A` | `#D7DDD9` / `#A2AEA9` |
+| 动作色 / hover | `#2D6A66` / `#1F4F4C` | `#1D6A55` / `#14503F` | `#35645D` / `#264E49` | `#8CB9AE` / `#A9CFC5` |
+| 表格行线 | `#DCD8CD` | `#E0DACC` | `#DECCB8` | `#313C3A` |
+| 选中底色 | `#CFE0DA` | `#CCE5D8` | `#E4CFB6` | `#35514B` |
+
+链接沿用本插件的「常态墨色 + 动作色下划线」，hover 才转动作色（山光原站是常态动作色）；其余令牌直接映射原站语义。
+
+## 对比度记录
+
+`temp/hill-light-build/gen.py` 生成令牌时逐对校验，四种模式全部 ≥ 目标值：
+
+| 组合 | 晓雾 | 午荫 | 暮烟 | 夜月 |
+| --- | --- | --- | --- | --- |
+| 正文 / 纸 | 10.95 | 12.31 | 10.54 | 11.72 |
+| 次要文字 / 纸 | 5.07 | 6.09 | 5.67 | 7.05 |
+| 图注 / 纸（≥3.0） | 4.63 | 5.24 | 4.75 | 5.07 |
+| 动作色 / 纸 | 5.43 | 6.00 | 5.28 | 7.44 |
+| 代码字 / 代码底 | 10.00 | 11.15 | 9.45 | 9.67 |
+| 代码标题字 / 标题条 | 4.85 | 5.78 | 5.37 | 5.33 |
+| callout 四型 / 纸（最低） | 5.15 | 6.16 | 4.87 | 6.70 |
+| 边框 / 纸（≥1.3） | 1.32 | 1.39 | 1.33 | 1.65 |
+
+callout 五型条色由山光的低饱和色相派生：note 用次要文字灰、tip 青绿、warning 赭黄、important 靛蓝、caution 砖红；四时各一套，全部 ≥4.5:1。
+
+## 与 hill-light 的偏离
+
+| 项 | 山光原站 | 本插件 | 理由 |
+| --- | --- | --- | --- |
+| 栏宽 | `--measure: 680px` | `--content-width: 840px` | 本插件面向 C++ 书籍：代码块、方向表、终端输出在 680px 下折行严重 |
+| 字体 | 思源宋体 / 思源黑体 / JetBrains Mono（系统栈） | 自托管 LXGW Bright Medium / Code | 多数 Windows 用户没有思源宋体，会落到 SimSun；1.25MB 字体的取舍见 `knowledge/reading-surface.md` |
+| callout | 五型同色，只靠图标形状区分 | 五型各一条 2px 色条 | 技术书里「这是注意还是危险」必须一眼可辨；只靠色相区分又违反 WCAG 1.4.1，所以色条 + 图标 + 标题词三重编码 |
+| 语法高亮 | 单色（正文色 + 淡注释） | 四色克制版（关键字/字符串/数字/注释） | 代码是本书主体，单色会让长代码块难扫读；色相仍取山光的低饱和色 |
+| 组件语言 | 3px 强调条、卡片式抬升面 | 2px 强调条、无卡片、发丝线 | 本插件全站统一的设计语言，三套色板共享，不随色板变化 |
+| 链接 | 常态动作色 | 常态墨色 + 动作色下划线 | 同上，三套色板一致 |
+| 行号色 | 直接取次要文字色（`#5F6E6F` / `#725F55` / `#87938E`） | 各压/抬一档（`#556565` / `#68554B` / `#8F9B96`） | 原值在各自代码底上 4.19–4.25:1，行号虽属辅助信息，但它是代码块里最常被读到的小字，够不到 4.5 线就压一档 |
+
+## 来源
+
+- 用户仓库 `D:\Github\hill-light\hill-light-theme`：`css/tokens.css`（四时令牌）、`DESIGN.md`（设计决策）
+- 生成脚本：`temp/hill-light-build/gen.py`（令牌映射 + 语法色派生 + 对比度校验）