# Formula Editor

> LaTeX로 공식을 입력하고 입력하는 대로 확인한 뒤, 다시 열어 변경할 수 있는 그림으로 모듈에 넣습니다.

Source: https://widgets.doorsnext.com/ko/widgets/formula-editor/

- 분야: 콘텐츠 품질
- 사용 위치: IBM DOORS Next 모듈
- 지원 제품: RM (IBM Engineering Requirements Management DOORS Next (Requirements Management))
- 데이터 변경
- Keywords: 수학 공식, LaTeX, 요구사항의 수식, 공식 편집기, MathJax, 공식 그림, DOORS Next 수식
- 버전: 1.8 (릴리스 날짜 2026-10-27)
- Vendor: SmarterProcess (https://doorsnext.com, info@smarterprocess.pl)
- 작업 흐름: 1. 모듈에서 아티팩트 선택 → 2. LaTeX로 공식 입력 → 3. 그림 미리 보기 → 4. Insert 또는 Update 확인 → 5. 공식을 LaTeX와 함께 그림으로 저장 → 6. Excel 변경 보고서

## 개요 및 개발 배경
브레이크, 센서, 제어 루프에 대한 요구사항에는 정지 거리, 공차, 필터 같은 공식이 자주 필요합니다. DOORS Next에는 공식 편집기가 없습니다. 팀은 Word에서 가져온 스크린샷을 붙여 넣는데, 원본 파일 없이는 나중에 아무도 바꿀 수 없습니다. 아니면 공식을 일반 텍스트로 입력하는데, 읽기가 어렵습니다.

Formula Editor를 사용하면 DOORS Next 안에서 LaTeX로 공식을 작성할 수 있습니다. 입력하는 대로 공식을 그리고, 선택한 아티팩트 뒤의 새 아티팩트나 선택한 아티팩트에 그림으로 모듈에 넣습니다. LaTeX는 아티팩트와 함께 저장되므로, 나중에 공식을 선택하면 편집기에서 다시 열립니다.

## 해결하는 문제
- 스크린샷으로 붙여 넣어, 원래의 Word 파일 없이는 아무도 바꿀 수 없는 공식.
- s = v^2/(2*mu*g)처럼 일반 텍스트로 입력되어 검토와 내보내기에서 읽기 어려운 공식.
- 둘 중 하나를 손으로 바꾼 뒤 텍스트와 더 이상 맞지 않는 공식 그림.
- 공식을 새로 만들거나 바꿀 때마다 다른 도구로 전환하고 그림을 다시 복사해 오는 작업.

## 이점
- **입력하는 대로 확인:** 작성하는 동안 미리 보기가 공식을 그리고 그림의 크기를 보여 줍니다.
- **나중에도 변경 가능:** LaTeX가 아티팩트에 보관되므로 공식을 선택하면 다시 열리고, Update가 새 그림을 그립니다.
- **텍스트는 그대로:** 텍스트가 있는 아티팩트에 Update를 하면 공식이 텍스트 뒤에 추가되고 문구는 유지됩니다.
- **다른 웹사이트 불필요:** 공식은 MathJax가 브라우저에서 그리며, 온라인 편집기로 보내지지 않습니다.
- **위치와 함께 표시되는 오류:** 빠진 중괄호나 알 수 없는 명령은 필드 아래에 해당 문자 위치와 함께 표시됩니다.

## 사용 방법
1. 모듈을 열고 아티팩트 하나를 선택합니다.
2. LaTeX로 공식을 입력하거나 필드 아래의 키를 클릭합니다: 분수, 근호, 거듭제곱, 아래 첨자, 합, 적분, 그리스 문자, 플러스마이너스, 행렬. **More symbols**를 누르면 21개가 더 표시됩니다. 미리 보기에 그림과 크기가 표시됩니다.
3. **Insert**를 클릭하면 선택한 아티팩트 뒤의 새 아티팩트에 공식을 추가하고, **Update**를 클릭하면 선택한 아티팩트에 씁니다. 확인 메시지를 읽고 **Insert formula** 또는 **Update formula**를 클릭합니다.
4. 결과 블록에 수행된 작업이 표시되며, **Log**로 변경 보고서를 다운로드할 수 있습니다.
5. 공식을 바꾸려면 모듈에서 그 공식을 선택합니다. 위젯에서 열리면(**Editing 1531 …**) LaTeX를 바꾸고 **Update**를 클릭합니다.

## 참고 사항
- 결과가 원하는 대로가 아니면 버릴 수 있도록 변경 세트 안에서 작업하십시오. 새 아티팩트는 바로 저장됩니다.
- 그림은 DOORS Next 서버에 저장되는 PNG이며, 두 배 크기로 그려지므로 화면과 내보내기에서 선명하게 유지됩니다. **Settings**에는 S, M, L의 세 가지 크기가 있습니다.
- 프로젝트에 **Formula**라는 속성이 있으면 LaTeX가 그 속성에 들어가고, 그림 설명에는 항상 들어갑니다. 따라서 이 속성이 없는 프로젝트에서도 공식을 다시 열 수 있습니다.
- 새 아티팩트는 선택한 아티팩트의 유형을 받습니다. **Settings**에서 Insert에 사용할 프로젝트의 다른 아티팩트 유형을 고를 수 있으며, 위젯은 이를 프로젝트별로 기억합니다. Update는 유형을 유지합니다.
- 공식의 그림이 손으로 교체된 경우 위젯이 이를 알려 주고, Update 확인 메시지에서 그 변경이 사라진다고 경고합니다. 항상 LaTeX가 우선합니다.