[222_64] 修改 节编号显示章编号的前缀 功能按钮显示 (#3067)

Author: Yuki-Nagori

TeXmacs/plugins/lang/dic/en_US/zh_CN.scm

@@ -1744,6 +1744,7 @@
 ("preferences for tag" "全局设置")
 ("preferences" "首选项")
 ("Prefix separator" "前缀分隔符")
+("Prepend chapter number prefix for section numbers" "节编号显示章编号的前缀")
 ("presentation mode" "演讲模式")
 ("presentation tag" "外观标记")
 ("presentation tool" "演示菜单")

TeXmacs/progs/text/text-menu.scm

@@ -1052,12 +1052,10 @@
   (with prefix-num-var (section-number-style-var t)
     (if prefix-num-var
         (group "Section prefix")
-        ((check "Short numbering" "v"
-                (== (get-init-env "sectional-short-style") "true"))
-         (init-env "sectional-short-style" "true"))
-        ((check "Long numbering" "v"
-                (!= (get-init-env "sectional-short-style") "true"))
-         (init-env "sectional-short-style" "false"))
+        ((check "Prepend chapter number prefix for section numbers" "v"
+                (== (get-init-env "sectional-short-style") "false"))
+         (init-env "sectional-short-style"
+                  (if (== (get-init-env "sectional-short-style") "true") "false" "true")))
         ---))
   (with sep-var (section-sep-var t)
     (if sep-var

devel/222_64.md

@@ -1,54 +1,167 @@
-# 222_64 章节编号自定义（支持汉字、字母、罗马数字）
+# 222_64 章节编号自定义
 
 ## 如何测试
-- 测试文档：TeXmacs/tests/tmu/222_64.tmu
-    1. 清理缓存
-    2. 插入一个章环境，点击小扳手，看是否有编号样式设置、编号前后符号设置
-    3. 测试选择不同的编号样式，章节标题应相应变化
-    4. 测试目录中的章节编号是否也随之变化
-    5. 测试节、子节、小节是否也可以修改
-    6. 测试不同语言环境（英语、中文等）下是否正常工作
-    7. 测试`sectional-short-style`是否仍然可用（处于`true`时`section`的编号不会受`chapter`影响）
-    8. 测试文档里的每一个环境的小扳手都需要查看！（很重要！）
-
-## 2026/03/31
-### What
-- 将章节菜单的选项部分增加了子菜单
+
+### 功能概述
+本功能为章节环境（chapter/section/subsection/subsubsubsection）提供编号样式、分隔符等自定义选项。
+
+### 测试前准备
+1. 清理缓存
+2. 重新编译
+3. 打开测试文档：`TeXmacs/tests/tmu/222_64.tmu`
+
+---
+
+### 一、编号样式设置测试
+
+#### 1.1 支持编号样式的环境
+- `chapter`
+- `section`
+- `subsection`
+- `subsubsection`
+
+#### 1.2 不支持编号样式的环境（无编号版本）
+- `chapter*`
+- `section*`
+- `subsection*`
+- `subsubsection*`
+
+#### 1.3 编号样式选项验证
+对每个支持的环境，测试以下编号样式：
+- 阿拉伯数字 (Arabic) - 预期显示：1, 2, 3
+- 汉字数字 (Hanzi) - 预期显示：一, 二, 三
+- 大写罗马数字 (Roman) - 预期显示：I, II, III
+- 小写罗马数字 (roman) - 预期显示：i, ii, iii
+- 大写字母 (Alpha) - 预期显示：A, B, C
+- 小写字母 (alpha) - 预期显示：a, b, c
+- 圆圈数字 (circle) - 预期显示：①, ②, ③
+
+**测试步骤：**
+1. 插入对应章节环境
+2. 点击小扳手打开首选项菜单
+3. 选择 "Number style" → 选择不同样式
+4. 观察章节标题编号变化
+5. 观察目录中对应章节编号同步变化
+
+---
+
+### 二、编号分隔符设置测试
+
+#### 2.1 章节编号后分隔符 (section-sep)
+- `.` - 预期显示：1. 标题
+- `、` - 预期显示：一、标题
+- `-` - 预期显示：1- 标题
+- `space` - 预期显示：1 标题
+- `none` - 预期显示：1标题
+
+#### 2.2 章节前缀分隔符 (prefix-sep)
+当 `sectional-short-style` 为 `false` 时测试：
+- `.` - 预期显示：1.1. 标题
+- `、` - 预期显示：一、一、标题
+- `-` - 预期显示：1-1- 标题
+- `space` - 预期显示：1 1 标题
+- `none` - 预期显示：11标题
+
+**测试步骤：**
+1. 插入 section/subsection
+2. 点击小扳手 → "Separator" / "Prefix separator"
+3. 选择不同分隔符，观察变化
+
+---
+
+### 三、章节前缀编号测试 (sectional-short-style)
+
+#### 3.1 功能验证
+- 勾选 (true) - section 显示独立编号：1, 2, 3
+- 不勾选 (false) - section 显示含 chapter 前缀：1.1, 1.2
+
+**测试步骤：**
+1. 确保文档有 chapter 环境
+2. 插入 section 环境
+3. 点击小扳手查看 "Section prefix" 分组
+4. 勾选/取消 "Prepend chapter number prefix for section numbers"
+5. 观察 section 编号变化：
+   - 勾选：显示 "1"（短编号）
+   - 取消：显示 "1.1"（长编号，含 chapter 编号前缀）
+
+#### 3.2 与编号样式组合测试
+- Hanzi chapter + short-style true - section 也是汉字：一、一、
+- Hanzi chapter + short-style false - section 也是汉字：一、一、
+
+---
+
+### 四、菜单 UI 测试
+
+#### 4.1 菜单结构
+- "Number style" 显示为子菜单（→）
+- "Separator" 显示为子菜单（→）
+- "Prefix separator" 显示为子菜单（→）
+
+#### 4.2 不可用选项隐藏
+- 无编号章节（chapter*/section*等）不显示编号相关选项
+- paragraph/subparagraph 不显示编号样式选项
+- 不可用选项不应显示为灰色，应完全隐藏
+
+#### 4.3 翻译验证
+- preferences for tag -> 全局设置
+- rendering options for tag -> 局部设置
+- Prefix separator -> 前缀分隔符
+- Section prefix -> 节前缀
+- separator -> 分隔符
+- Title style -> 标题样式
+- Prepend chapter number prefix for section numbers -> 节编号显示章编号的前缀
+
+---
+
+### 五、目录同步测试
+- 修改编号样式后，目录自动同步更新
+- 修改分隔符后，目录自动同步更新
+- 切换 short-style 后，目录自动同步更新
+
+---
+
+### 六、多语言环境测试
+- 中文 (chinese) - 切换编号样式正常工作
+- 英文 (english) - 切换编号样式正常工作
+- 其他语言 - 切换编号样式正常工作
+
+---
+
+#### 7.1 图注分隔符 (figure-sep)
+- 插入 `big-figure`，测试分隔符选项：`. `、`、空格
+
+#### 7.2 表注分隔符 (table-sep)
+- 插入 `big-table`，测试分隔符选项：`. `、`、空格
+
+#### 7.3 公式前缀分隔符 (equation-prefix-sep)
+- 插入 `equation`，测试前缀分隔符选项
+
+---
+
+### 八、回归测试
+- 章节基本功能正常（插入、删除、编辑）
+- 目录生成正常
+- 交叉引用正常
+- 导出 PDF 后编号显示正确
+- 旧文档兼容（打开之前的文档，编号显示正常）
+
+---
+
+### 2026/03/31
+- 将章节菜单的选项部分改为子菜单形式
 - 添加了翻译
 - 无法使用的按钮从灰色改为隐藏
 
-## 2026/03/26
-### What
-增加编号后的`sectional-sep`的可选项，支持：
-- 句点 .
-- 短横 -
-- 空格  
-- 无
-
-同步增加了图注和题注以及公式中间的符号，支持：
-- 短横 -
-- 句点 .
-
-## 2026/03/26
-### What
-在章节标题的首选项（小扳手）中添加编号样式选项，支持：
-- 阿拉伯数字 (1, 2, 3) - 默认
-- 汉字数字 (一, 二, 三)
-- 大写罗马数字 (I, II, III)
-- 小写罗马数字 (i, ii, iii)
-- 大写字母 (A, B, C)
-- 小写字母 (a, b, c)
-- 圆圈数字 (①, ②, ③)
-
-补充范围：
-- 编号样式可配置范围扩展到 `chapter`、`section`、`subsection`、`subsubsection`
-- 不提供编号样式切换 `paragraph`、`subparagraph`
-- 不适用标签不显示可配置项 `chapter*`、`section*`、`subsection*`、`subsubsection*`
-
-### Why
-原先章节编号只能通过修改宏来更改格式，对普通用户不友好，因此提供一个直观的首选项选项来切换编号样式。
-
-### How
-修改下列文件
-1. `TeXmacs/packages/section/section-base.ts` - 添加 `chapter-number-style` 变量和 `the-chapter` 宏
-2. `TeXmacs/progs/text/text-menu.scm` - 在小扳手菜单中增加编号样式入口，并按标签类型控制显示范围
+### 2026/03/26
+- 增加编号后的 `sectional-sep` 可选项：句点 `.`、短横 `-`、空格、无
+- 同步增加图注和题注以及公式中间的符号选择
+
+### 2026/03/26
+- 在章节标题首选项中添加编号样式选项
+- 支持：阿拉伯数字、汉字数字、罗马数字、字母、圆圈数字
+- 范围扩展到 `chapter`、`section`、`subsection`、`subsubsection`
+- `paragraph`、`subparagraph` 不提供编号样式切换
+- `chapter*`、`section*` 等无编号版本不显示可配置项
+
+### 2026/03/26
+- 初始实现章节编号自定义功能