@chengzhao-dev/dsh-quarto-book 0.6.6 → 0.6.7

package/README.en.md

@@ -29,7 +29,7 @@ Both skills are discovered from the package's `skills/` directory and loaded on
 2. Open a session in the book repository. `_quarto.yml` needs a standalone `type: book` line, and the book needs at least one `.qmd` or `.md` chapter source; only then do both skill names appear.
 3. Call a skill: `writing-quarto` for prose, `designing-theme` for the theme.
 
-Replace `--profile` with the profile you actually run. The desktop app always runs the `desktop` profile, and that profile is owned by the app, so `dsh --profile desktop` is rejected; install or upgrade with `dsh plugin --profile desktop add <package>`, and use the app's Settings → Plugins → Add plugin only if the app refuses that write. To pin a version, write `npm:@chengzhao-dev/dsh-quarto-book@0.6.6`; to follow a GitHub tag, write `github:chengzhao-dev/dsh-quarto-book#v0.6.6`.
+Replace `--profile` with the profile you actually run. The desktop app always runs the `desktop` profile, and that profile is owned by the app, so `dsh --profile desktop` is rejected; install or upgrade with `dsh plugin --profile desktop add <package>`, and use the app's Settings → Plugins → Add plugin only if the app refuses that write. To pin a version, write `npm:@chengzhao-dev/dsh-quarto-book@0.6.7`; to follow a GitHub tag, write `github:chengzhao-dev/dsh-quarto-book#v0.6.7`.
 
 Upgrading from the old unscoped package `dsh-quarto-book` (removed from npm with 0.3.4, so this only affects profiles that installed it earlier): remove it from the same profile first with `dsh plugin --profile <profile> remove dsh-quarto-book`, then add the scoped package. Keeping both installed registers `writing-quarto` and `designing-theme` twice at the same rank 550.
 

package/README.md

@@ -29,7 +29,7 @@
 2. 在书仓库里打开会话。`_quarto.yml` 要有独立一行的 `type: book`，书根至少有一个 `.qmd` 或 `.md` 章节源文件；两个技能名这时才会出现。
 3. 调用技能：写正文用 `writing-quarto`，改主题用 `designing-theme`。
 
-`--profile` 换成你实际运行的那个 profile。桌面应用固定跑 `desktop` profile，且该 profile 由应用独占管理，`dsh --profile desktop` 直接启动会被拒绝；安装或升级用 `dsh plugin --profile desktop add <包>`，应用拒绝写入时再走「设置 → 插件 → 添加插件」。需要固定版本时写 `npm:@chengzhao-dev/dsh-quarto-book@0.6.6`，跟 GitHub 标签时写 `github:chengzhao-dev/dsh-quarto-book#v0.6.6`。
+`--profile` 换成你实际运行的那个 profile。桌面应用固定跑 `desktop` profile，且该 profile 由应用独占管理，`dsh --profile desktop` 直接启动会被拒绝；安装或升级用 `dsh plugin --profile desktop add <包>`，应用拒绝写入时再走「设置 → 插件 → 添加插件」。需要固定版本时写 `npm:@chengzhao-dev/dsh-quarto-book@0.6.7`，跟 GitHub 标签时写 `github:chengzhao-dev/dsh-quarto-book#v0.6.7`。
 
 从旧的无作用域包 `dsh-quarto-book` 升级（该包已随 0.3.4 从 npm 删除，只影响之前装过它的 profile）：先在同一个 profile 里 `dsh plugin --profile <profile> remove dsh-quarto-book`，再装新包。两个包同时留着会以相同的 rank 550 各注册一遍 `writing-quarto` 和 `designing-theme`。
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@chengzhao-dev/dsh-quarto-book",
-  "version": "0.6.6",
+  "version": "0.6.7",
   "description": "把一份 Quarto Book 写成可读、可查、可发布的中文技术书：九步章节写作、结构/链接/图表检查、统一主题与渲染验收。 · Write, check, and publish a Chinese Quarto Book: nine-step chapter writing, structure/link/figure checks, a consistent theme, and render acceptance.",
   "type": "module",
   "main": "./lib/index.js",

package/skills/designing-theme/assets/theme/css/content.css

@@ -7,33 +7,38 @@
      扫读时表格被读成「另一类内容」。表头小一号但不加大写（中文表头 uppercase 无意义且显僵硬）。 */
   font-size: 1rem;
   border-collapse: collapse;
-  display: block; /* 宽表横向滚动，避免移动端溢出 */
+  /* 表格本体保持表格布局：display: table 才能让 tbl-colwidths 生效，
+     width: 100% 让表与代码块占满同一正文栏。横向滚动交给 .table-responsive。 */
+  display: table;
+  table-layout: fixed;
   width: 100%;
   max-width: 100%;
-  overflow-x: auto;
-  -webkit-overflow-scrolling: touch;
-  /* 列宽随内容分配：不写固定像素，长单元格换行，整表窄屏横向滚动。 */
-  table-layout: auto;
   margin-block: 1.35rem 1.5rem;
   border: none;
   border-radius: 0;
   font-variant-numeric: tabular-nums;
 }
+/* Quarto 的 .responsive 类把宽表包进这层：外层承担横向滚动。表体是 fixed + 100%
+   时不会溢出，滚动条永远不出现；包内因此改回按内容宽度排布，min-width 保证短表
+   仍占满正文栏，内容更宽时才真的滚动。 */
+.table-responsive {
+  width: 100%;
+  overflow-x: auto;
+  -webkit-overflow-scrolling: touch;
+}
+.table-responsive > .table {
+  table-layout: auto;
+  width: max-content;
+  min-width: 100%;
+}
 .table > :not(caption) > * > * {
-  padding: 0.55rem 0.95rem;
+  padding: 0.625rem 1rem;
   /* 多行单元格从顶部起排，同一行里短格子不被拉到垂直居中。 */
   vertical-align: top;
   /* 长 API 名与长句允许在格内折行，避免把整张表撑出内容列。 */
   overflow-wrap: break-word;
   border-bottom: 0;
 }
-/* 首尾列贴边，让表格与正文左缘对齐 */
-.table > :not(caption) > * > :first-child {
-  padding-inline-start: 0;
-}
-.table > :not(caption) > * > :last-child {
-  padding-inline-end: 0;
-}
 .table thead th {
   /* 表头用加粗与一道极浅底色标出层级；不套 .compact-table，列宽仍随内容。 */
   background-color: color-mix(in srgb, var(--table-border) 24%, transparent);
@@ -41,9 +46,9 @@
   /* 表头比表体小 1px（17px → 15px），层级靠字重、字号与底色，不靠更粗的线。 */
   font-size: 0.9375rem;
   line-height: 1.6;
-  text-align: left;
-  padding-top: 0.5rem;
-  padding-bottom: 0.5rem;
+  /* 表头是短标签，水平与垂直都居中；表体长句保持左对齐、顶对齐。 */
+  text-align: center;
+  vertical-align: middle;
   border-top: 1px solid var(--table-border);
   border-bottom: 1px solid var(--table-border);
 }
@@ -52,26 +57,16 @@
 }
 
 /* 短对照表保持全宽左对齐（与正文同宽，不居中收窄）；左对齐便于中文术语扫读。
-   宽表仍由通用 .table 规则负责滚动，不要给多列/长单元格表套本类。 */
+   宽表由 .table 默认规则负责，不要给多列/长单元格表套本类。 */
 .compact-table {
-  overflow-x: auto;
-}
-.compact-table .table {
-  display: table;
   width: 100%;
-  max-width: 100%;
+  overflow-x: auto;
 }
 .compact-table .table th,
 .compact-table .table td {
   text-align: left;
   padding-inline: 1.25rem;
 }
-.compact-table .table > :not(caption) > * > :first-child {
-  padding-inline-start: 0;
-}
-.compact-table .table > :not(caption) > * > :last-child {
-  padding-inline-end: 0;
-}
 
 /* 表题：Pandoc 输出 <caption>，Bootstrap 默认把它放表下（caption-side: bottom），
    这里统一提到表上、左对齐，与图注一样小一号。 */

package/skills/designing-theme/references/theme-system.md

@@ -81,7 +81,7 @@
 - **章节翻页**：一条顶线 + 左右两个文字链接，不用边框卡片；箭头用 `<` / `>`，hover 才转 `--accent`，下一页右对齐。箭头用字符而不用 SVG 是量过的：Bright 的 `<` `>` 墨迹中心在 0.23em，与同行西文同一轴，没有面包屑 `>` 那种偏高，换 SVG 反而要另配基线。
 - **章节线**：标题不画线。全书只有一种横线——通栏 1px `--card-border` 发丝线，只出现在顶栏底边、引用块上下边、表格 booktabs、首页目录每行顶线、翻页顶线、页脚顶线、答案折叠线；`h2::after` 的 2.25rem 短发丝线已删除（连同首页 `.feature-grid` 例外），章节节奏只靠 H2 的 `margin-top: 3.25rem` 与字号台阶。约定改动时同步本节与 `css/base.css`。
 - **引用块**：上下各一条 1px `--card-border` 横线、正文色、无底色、无左右竖条；与 Callout 的 2px 左色条区分开（后者是类型标记，不是分隔线）。
-- **表格**：`display: block` + 块内横向滚动承载宽表；Chrome 的表格修复会把同一块里的 `thead`/`tbody` 包进一个匿名表，所以列宽仍逐列对齐（1280 与 390 实测一致），不需要 JS 量列宽。表题走 `caption-side: top`、左对齐、14px `--text-secondary`；`table-striped` 压平成与普通行同底。
+- **表格**：`display: table` + `table-layout: fixed` 吃 `tbl-colwidths`，`width: 100%` 让表与代码块占满同一正文栏；表头水平与垂直居中，表体左对齐、顶对齐，四边 padding 一致、首列不贴边。`display: block` 不行：外层块占 100%，里面的匿名表按内容收缩，表会变窄。宽表由 Quarto `.responsive` 类包成 `.table-responsive` 外层滚动容器；包内表改回 `table-layout: auto` + `width: max-content`，否则 fixed + 100% 永远不会溢出、滚动条是死的。不需要 JS 量列宽。表题走 `caption-side: top`、左对齐、14px `--text-secondary`；`table-striped` 压平成与普通行同底。
 - **脚注**：区块顶部一条 1px `--card-border`、`margin-top: 3rem`、14px / lh 1.7、`--text-secondary`；回跳箭头随正文链接色。
 - **任务列表**：`input[type=checkbox]` 用 `accent-color: var(--action-color)`，不用系统蓝。
 - **图片**：正文图与坐标图圆角一律 `--radius-sm`（3px），不用 6px 大圆角；图注选择器同时覆盖 `figure figcaption`、`.quarto-float-caption`、`.figure-caption`（`lang: zh` 后 Quarto 生成「图 3.1: …」，`lang` 必须写在 `_quarto.yml`，否则图/表题回落英文 Figure/Table）。

package/skills/writing-quarto/quarto/tables.md

@@ -27,11 +27,13 @@
   | 接口 | 返回 | 边界 |
   | --- | --- | --- |
   | `GetCellType` | 坐标处的 `CellType` | 越界时抛出 `std::out_of_range` |
-  : {tbl-colwidths="[24,30,46]"}
+  : {.responsive tbl-colwidths="[24,30,46]"}
   ```
 
   比例按内容分配：名称与接口列 18–26，返回列 22–32，说明列 34–50，三项合计 100。三列以上时最长列不超过 55，避免其余列被挤成一条线。
-- 不写固定宽度（`{width=...}`、`style="width:..."`）。窄屏下整张表横向滚动，列宽仍随内容分配；`table-layout: auto` 是主题默认值，不要覆盖成 `fixed`。
+- 表格与代码块同宽：主题用 `table-layout: fixed` 吃上面的比例，四边内边距一致，首列不贴边；表头在格内水平、垂直居中，表体左对齐、顶对齐。
+- 宽表在表属性里加 `.responsive`（Quarto 内置类）：Quarto 生成外层 `.table-responsive` 滚动容器，主题在该容器里改回按内容宽度排布，内容超过正文栏时才出现横向滚动。窄表可省。
+- 不写固定宽度（`{width=...}`、`style="width:..."`），也不覆盖 `table-layout`；比例之外的几何由主题负责。
 - 长单元格先改文案：删重复修饰，把条件与结果按「条件 + 结果」排成一句。仍长时允许格内折行，`overflow-wrap: break-word` 已由主题处理。
 
 ## 单元格
@@ -74,6 +76,6 @@
 
 - [ ] 表前有导语、表后有一句结论，两句都不复述格子内容。
 - [ ] 代码块、图、列表与表之间隔了一段正文。
-- [ ] 表头没有手写加粗；列宽是相对比例，最长列不超过 55%。
+- [ ] 表头没有手写加粗；列宽是相对比例，最长列不超过 55%；宽表加了 `.responsive`。
 - [ ] 一格一个事实，没有「名词：说明」和手动空格对齐。
 - [ ] 短表已改回句子或列表。