# Captions

> 모듈의 모든 그림 및 표 캡션에 장별 번호(Fig. 2.1, Table 2.1)를 한 번의 실행으로 매깁니다.

Source: https://widgets.doorsnext.com/ko/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. **필수:** Captions는 프로젝트에 **Caption**이라는 이름의 아티팩트 유형이 있을 때만 작동합니다. 캡션은 이 유형의 아티팩트로, 각각 해당 그림이나 표 아래에 있습니다. 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를 고르세요.