# Captions

> 一次运行即可按章节为模块中的每个图题和表题编号，如 Fig. 2.1、Table 2.1。

Source: https://widgets.doorsnext.com/zh/widgets/captions/

- 学科: 内容质量
- 适用于: IBM DOORS Next 模块
- 支持的产品: RM (IBM Engineering Requirements Management DOORS Next (Requirements Management))
- 更改数据
- Keywords: 题注编号, 图编号, 表编号, 带编号的题注, 需求中的图题, 表题, DOORS Next 文档编号
- 版本: 2.6 (发布日期 2026-10-28)
- Vendor: SmarterProcess (https://doorsnext.com, info@smarterprocess.pl)
- 工作流程: 1. 打开模块 → 2. 预览每个编号 → 3. 确认 Number captions → 4. 题注按章节编号 → 5. Excel 变更报告

## 它是什么，为何存在
导出为 Word 或 PDF 的规格说明需要按章节编号的图和表：Fig. 2.1、Fig. 2.2、Table 2.1。在 DOORS Next 中，题注是一个独立的工件，位于它所描述的图片或表格下方，其编号只是普通文本。每添加一张图片、移动一个章节或新增一章，编号就会被打乱，而手动修正意味着要逐个打开题注。

Captions 一次运行即可为模块中的所有题注编号。它读取模块的章节，计算每个图题和表题的编号，先显示出来，然后写入，只替换每个题注开头的旧编号。

## 解决的问题
- 添加、移动或删除章节后，图号和表号不再与章节对应。
- 两张图使用同一编号，或编号出现空缺，直到导出文档后才发现。
- 在评审或发布前，花费数小时逐个打开题注，手动输入编号。
- 同一文档中的题注编号样式不一致（"Figure 3:"、"Fig. 1.2"，或根本没有编号）。

## 优势
- **按章节编号：** Fig. 2.1、Fig. 2.2、Table 2.1，图和表分别计数，并在每一章重新开始。
- **先预览：** 在任何更改之前，预览会列出每个题注的当前编号和新编号。
- **题注文本保持不变：** 只替换旧编号；文字及其粗体或斜体保持原样。
- **可放心重复运行：** 已有正确编号的题注不会被写入，Excel 变更报告会保留每段文本更改前后的内容。

## 使用方法
1. **必需：** 只有当项目中存在名为 **Caption** 的工件类型时，Captions 才能工作。题注是该类型的工件，各自位于其图片或表格下方；Caption Type 属性（Figure 或 Table）是可选的。
2. 打开模块。在 **Settings** 中单击 **Change**，在 **New number at headings up to** 中选择从哪个标题级别开始新的编号（级别 1：1.1、1.2 … 然后 2.1），并在 **Caption text after the number** 中选择 **Keep the text**、**Only the number (remove the text)** 或图片或表格的某个属性，例如 **Name**。单击 **Done**。
3. 在 **Module** 下单击 **Preview**，在 **Captions** 中查看每个题注的当前编号、新编号及其新文本。展开一行并单击 **Show in module**，即可在模块中显示该题注。
4. 单击 **Number**，阅读确认信息后单击 **Number captions**。结果区块显示已编号、新增、原本正确和失败的题注数量，**Log** 可下载变更报告。

## 须知
- 请在变更集中运行 Captions，如结果不符合预期，可放弃该变更集。
- 第一章之前的题注使用章节 0（Fig. 0.1）。没有 Caption Type 的题注会以不带文字的形式编号，并使用单独的计数。
- Caption Type 属性是可选的：没有该属性时，Captions 根据旧编号中的词（Fig.、Table）或题注旁边的图或表来区分图和表。没有题注的图或表会在其正下方添加新的题注；可在 Settings 中关闭此功能。
- 默认情况下，题注会居中，其工件名称会被清空，与原来的 Captions 小组件相同；两者都可以在 Settings 中关闭。
- 题注类型、其属性以及编号前的文字（Fig.、Table）可以在小组件设置中更改，例如用于其他语言的题注。
- Captions 还可以替您写入题注文字：在 Settings 中选择图或表的一个属性（例如其 Name），其值会写在编号之后并替换原有文字，如 Fig. 1.2 Battery pack layout；值为空时只保留编号。选择 Only the number 可删除所有题注的文字，选择 Keep the text 则只更改编号。