# 구조화 노드: 묘사, 인물, 대사

> 유형 메뉴 열기, 숫자 키 선택, Enter 키의 연속 입력 규칙과 안전한 유형 전환 방식을 설명합니다.

Source: https://loomworld.ai/ko/docs/editor-nodes

## 유형 메뉴 열기

편한 방식에 따라 두 가지 방법 중 하나를 선택할 수 있습니다: 각본의 임의의 행에서 `Tab` 키를 누르거나, 빈 행의 시작 부분에서 `/`를 입력합니다. 현재 행의 위치에서 가로 형태의 유형 칩 메뉴가 떠오릅니다.

메뉴가 열려 있는 동안 해당 행은 의도적으로 읽기 전용 상태가 됩니다. 이는 입력한 숫자가 본문에 입력되지 않고 메뉴 선택으로 정확히 반영되도록 하기 위함입니다. 메뉴를 닫으려면 `Esc`를 누르거나 그대로 타이핑을 이어가십시오.

## 유형 선택: 숫자 키 또는 마우스 클릭

메뉴 순서는 고정되어 있으므로 숫자 키 `1`–`9`가 직관적으로 대응됩니다: 1 묘사, 2 인물, 3 대사, 4 주석, 5 지문, 6 나레이션, 7 트랜지션, 8 시공간, 9 씬.`↑``↓`(또는 `Tab`)로 하이라이트를 이동하고 `Enter`로 확정합니다. 마우스 클릭도 가능하지만, 숫자 키를 사용하면 집필 리듬을 끊지 않고 유지할 수 있습니다.

가장 잘못 사용하기 쉬운 것은 '인물' 노드입니다. 인물 노드는 '다음에 이어지는 대사를 누가 말하는가'만을 선언하는 역할을 합니다. 인물이 걸어 들어와 창밖을 바라보며 아무 말도 하지 않는 상황은 '묘사' 행에 해당합니다. 인물 행을 단순한 등장 표시로 사용하면 등장 통계가 왜곡됩니다.

## Enter 키와 방향키로 이어지는 연속 입력

- 인물 행에서 Enter를 누르면 해당 인물의 대사 행이 자동으로 생성됩니다. 대사 행에서 Enter를 누르면 대사 유형이 유지되므로 여러 줄의 대사를 입력할 때 매번 다시 선택할 필요가 없습니다.
- 그 외의 다른 모든 유형에서 Enter를 누르면 묘사 행으로 돌아갑니다.
- 지문은 대사의 삽입구입니다. 유효한 구조는 '인물 → (임의 개수의 지문) → 1개 이상의 대사'이며, 지문 행 자체가 화자를 직접 생성할 수는 없습니다.
- 주석은 현재 화자의 대사 흐름을 종료합니다. 작가 자신만을 위한 메모이며 대화 구조에 포함되지 않습니다.
- 일반 텍스트 행에서는 첫 행 또는 마지막 행에서 ↑ ↓ 키를 눌러 이전 또는 다음 노드로 이동할 수 있습니다. 씬 및 시공간 노드는 여러 필드로 구성된 다중 필드 노드이므로, Enter를 누르면 필드 사이를 먼저 이동하고 마지막 필드에서 Enter를 눌러야 새 행이 시작됩니다.
- 씬 내부의 빈 행에서 Enter를 누르면 씬 영역에서 벗어납니다. 빈 행에서 Backspace를 누르면 해당 행이 삭제되고 이전 행으로 포커스가 돌아갑니다.

## 각 노드별 입력 가능 필드

행에 특정 유형을 부여하면 입력할 수 있는 필드가 달라집니다. 이를 미리 파악해 두면 시행착오를 줄일 수 있습니다:

- 콘텐츠 블록(묘사, 인물, 대사, 주석, 지문, 나레이션, 트랜지션): 본문 텍스트 자체와 한 줄의 의도 설명 필드로 구성됩니다. 인물 블록은 실제 인물 카드와 연결되며, 본문에서 대괄호로 입력한 소품은 해당 행에 기록됩니다.
- 씬: 장소(장소 자료 보관함에서 선택하거나 새 이름을 입력하여 카드 생성), 시간(자유 텍스트), 짧은 제목, 씬 줄거리 요약 및 번호가 매겨진 비트(Beats)로 구성됩니다. 비트는 향후 산문 확장 시의 근거가 됩니다. 줄거리 요약은 출처가 구분되어 자동 유지보수로 생성된 것은 새로고침할 수 있고, 사용자가 직접 작성한 내용은 덮어쓰지 않습니다.
- 시공간: 장소와 시간, 한 줄 묘사, 그리고 이 장면을 타임라인에 연결하는 극 중 타임라인 인덱스, 라벨 및 메모로 구성됩니다. 시공간의 장소는 해당 씬의 메인 장소 자체이거나 그 하위 장소여야 합니다.
- 장: 제목, 장별 의도 및 색상으로 구성됩니다. 장 번호는 제목에 적는 것이 아니라 현재 순서에 따라 자동으로 파생되므로, 새로 생성한 장의 제목이 비어 있어도 화면에 '제3장'과 같이 표시되는 것이 정상입니다.

씬과 시공간은 다중 필드 노드입니다. Enter 키는 필드 사이를 먼저 이동하며 마지막 필드에서 Enter를 누를 때 비로소 새 행이 생성되므로 마우스 조작 없이 키보드만으로 입력할 수 있습니다.

## 본문 내용을 훼손하지 않는 안전한 유형 전환

유형 변경은 해당 행의 시맨틱 태그만 교체할 뿐, 이미 입력한 텍스트는 전혀 변경되지 않으므로 자유롭게 시험해 볼 수 있습니다. 실제로 변경되는 것은 구조적 소속입니다. 특정 행을 '씬'으로 변경하면 그 뒤에 오는 행들이 해당 씬에 자동으로 귀속되며, 씬 노드를 삭제하면 해당 씬이 구조에서 제거되고 나머지 씬들의 번호가 재정렬됩니다.

실행 취소는 두 가지 경로로 보호됩니다: 전체 애플리케이션 공통 프로젝트 실행 취소 스택(`Cmd`/`Ctrl` + `Z`, 최대 30단계, 1초 이내의 연속 입력은 한 단계로 병합)을 지원하며, 모든 편집 내용은 로컬에 먼저 저장된 후 동기화 큐에 들어가므로 네트워크가 끊겨도 이미 작성한 원고를 잃어버리지 않습니다.

## 제한 사항 및 문제 해결

- 유형 메뉴는 각본 본문 행에서만 유효합니다. 카드 입력란(인물 이름, 장소 설명 등)에서 Tab을 누르면 기본 브라우저 입력 동작으로 작동하며 메뉴가 열리지 않습니다.
- 구버전의 '댓글(comment)', '괄호 지문(parenthetical)', '캡션(caption)' 세 가지 유형은 폐기되었으며 하위 호환성을 두지 않습니다. 현재는 주석, 지문, 나레이션으로 나누어 작성합니다.
- 여러 행을 드래그하여 복사하면 순수 텍스트만 복사되며 노드 유형이나 서식은 포함되지 않습니다. 단일 노드 내에서의 복사는 정확한 선택 영역을 보존합니다.
- 특정 유형이 보이지 않는 경우: 칩 목록이 가로로 스크롤되므로 ← → 키를 누르거나 숫자 키로 바로 선택할 수 있습니다.

9가지 노드의 전체 시맨틱과 화면 레이아웃에 대한 설명은 [각본 에디터 개요](https://loomworld.ai/ko/docs/editor-overview)를 참고하십시오.