> ## Documentation Index
> Fetch the complete documentation index at: https://make.edicus.io/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# 레이어 이름과 개체 종류

> 레이어 이름으로 개체 종류를 정하는 규칙, 지원하는 레이어 전체, 쌓임 순서와 변환 결과

에디쿠스는 InDesign 개체가 어느 레이어에 있는지로 개체 종류를 정합니다. 같은 텍스트 프레임도 `Text` 레이어에 있으면 사용자가 고칠 수 있는 글자가 되고, `Sticker` 레이어에 있으면 고칠 수 없는 그림이 됩니다.

## 배우는 것

* 레이어 이름을 읽는 규칙
* 지원하는 레이어 이름 전체와 각각의 편집기 동작, 인쇄 결과
* InDesign 개체 종류별 변환 결과와 쌓임 순서

## 이름을 읽는 규칙

레이어 이름은 세 부분으로 읽습니다.

```text theme={null}
종류-구분자@키=값,키=값
```

* **종류**: 첫 `-`나 `@` 앞부분입니다. 대소문자를 구분합니다. `Text`는 되고 `text`나 `TEXT`는 다른 이름으로 취급합니다.
* **구분자**: `-` 뒤의 값입니다. InDesign은 같은 이름의 레이어를 만들 수 없으므로, 같은 종류의 레이어가 여럿 필요하면 `Sticker-1`, `Sticker-2`처럼 구분자를 붙입니다. 구분자가 달라도 종류는 같습니다.
* **어노테이션**: `@` 뒤의 설정입니다. 문법은 [어노테이션](/docs/templates/annotations)에 있습니다.

아래 구분자는 특별한 뜻이 있으니 단순 번호 대신 쓰지 않습니다. 특히 `BG` 레이어와 `-BG` 구분자는 다릅니다.

```text theme={null}
BG            ← Background와 같은 바탕 레이어
Sticker-BG    ← 스티커를 바탕보다 아래 층에 두는 구분자
```

| 구분자 | 동작 |
| - | - |
| `-BG` | 어느 종류든 그 레이어의 개체를 페이지 맨 아래의 별도 층(바탕보다 아래)에 둡니다. 사용자가 선택할 수 없습니다 |
| `-PNG` | `Cell-PNG`에서만 의미가 있습니다. 사진 칸의 기본 이미지를 JPG 대신 PNG로 내보내 투명도를 살립니다 |
| `-CoverCalendar`, `-GridCalendar`, `-MiniCalendar`, `-LineCalendar`, `-ListCalendar`, `-YearCalendar` | 달력 상품의 날짜 영역입니다. [달력 상품](/docs/products/calendar)을 보세요 |

## 기본 레이어

| 레이어 이름 | 들어가는 개체 | 편집기에서 | 렌더링에서 |
| - | - | - | - |
| `Text` | 텍스트 프레임, 패스 위 텍스트 | 사용자가 내용과 서식을 고치는 글상자입니다 | 인쇄됩니다 |
| `Cell` (`PicFrame`도 같음) | 사진을 받을 프레임 | 사용자가 사진을 넣는 사진 칸입니다 | 들어간 사진이 인쇄됩니다 |
| `Sticker` | 그림, 로고, 장식, 고칠 수 없는 글자 | 그림 한 장으로 바뀝니다. 이동과 삭제는 [어노테이션](/docs/templates/annotations)으로 정합니다 | 인쇄됩니다 |
| `Path` | 사각형, 원, 다각형, 선 | 채움과 선 색을 가진 도형입니다 | 인쇄됩니다 |
| `Background` (`BG`도 같음) | 바탕 색이나 바탕 그림 | 페이지 바탕입니다. 배경 탭으로 바꿀 수 있습니다 | 인쇄됩니다. 이름이 `none`, `transparent`면 빠집니다 |
| `Guide` | 목업, 그림자, 안내 그림과 문구 | 맨 위에 표시되며 선택할 수 없습니다 | 인쇄되지 않습니다. `render=true`를 붙이면 인쇄됩니다 |
| `PageInfo` | 영역을 지정하는 사각형과 패스 | 개체 이름에 따라 재단선, 안전선, 클리핑 같은 페이지 속성이 됩니다. 개체 자체는 보이지 않습니다 | 일부 속성이 인쇄 범위에 쓰입니다 |
| `Support` | 작업 메모, 참고 자료 | 변환에서 빠집니다 | 빠집니다 |

`PageInfo`에 넣는 개체 이름은 [예약 개체 이름과 페이지 영역](/docs/templates/reserved-names#pageinfo)에 있습니다. `Support` 레이어는 익스포터가 페이지별 미리보기를 만들 때는 숨겨지지만, Edicus Manager 템플릿 목록의 대표 이미지에는 보이는 상태 그대로 찍힙니다. 올리기 전에 레이어를 숨깁니다. 숨겨도 변환에서 빠지는 것은 같습니다.

## 후가공 레이어

칼선, 화이트, 박처럼 인쇄 이미지와 따로 생산하는 판은 아래 이름의 레이어에 그립니다. 철자와 대소문자를 정확히 맞춥니다. 익스포터는 이 이름의 레이어만 그림으로 캡처합니다.

| 레이어 이름 | 쓰임 |
| - | - |
| `Cut` | 완칼선 |
| `KissCut` | 반칼선 |
| `Crease` | 오시선. `Creese`가 아니라 `Crease`입니다 |
| `Perforation` | 미싱선 |
| `White` | 화이트 인쇄 |
| `Foil`, `DFoil` | 박 |
| `Gold`, `Silver`, `Copper` | 금박, 은박, 동박 |
| `Emboss`, `Epoxy`, `Scodix` | 형압, 에폭시, 스코딕스 |
| `Extra` | 그 밖의 추가 판 |

후가공 레이어의 개체는 편집기에서 맨 위에 표시되고 선택할 수 없습니다. 렌더링에서는 인쇄 이미지와 섞이지 않고 레이어 이름 그대로의 별도 판으로 나갑니다. PDF로 렌더링하면 렌더링 설정에 따라 이 판이 PDF 레이어나 별도 페이지로 나뉩니다.

`@path=true`를 붙이면 그림 대신 벡터 패스로 변환합니다. 칼선처럼 선 자체가 생산 데이터인 판에 씁니다. 편집기에서는 숨기고 인쇄 판에만 넣으려면 `@hidden=true,render=true`를 씁니다. 예시는 [어노테이션](/docs/templates/annotations#후가공)에 있습니다.

<Warning>
  `cut`, `white`처럼 대소문자가 다른 이름도 별도 판으로 나가지만, 익스포터가 그림을 캡처하지 않아 벡터 도형은 채움 색 정보만 남습니다. 칼선과 화이트가 빠지면 레이어 이름의 철자부터 확인합니다. 증상은 [흔한 실수와 증상](#흔한-실수와-증상)에 있습니다.
</Warning>

## 영역 레이어

아래 레이어는 개체 이름 대신 레이어 이름으로 페이지 영역을 지정합니다. `PageInfo` 안에 같은 이름의 개체를 두는 방식과 결과가 같습니다. 개체는 하나만 넣습니다.

| 레이어 이름 | 만드는 것 |
| - | - |
| `ClipPath`, `PageMask`, `HidePath`, `ClipPathUser` | 클리핑 영역과 페이지 모양. [예약 개체 이름과 페이지 영역](/docs/templates/reserved-names#클리핑과-페이지-모양)과 같습니다 |
| `RenderBound`, `GroupBound`, `ClipBound` | 사각 영역. [예약 개체 이름과 페이지 영역](/docs/templates/reserved-names#영역)과 같습니다 |
| `Bound@Fit+Render+ClipPath` | 개체 하나로 여러 영역을 한 번에 지정합니다. 레이어 이름에서는 `@`와 `+`로 잇습니다. `PageInfo` 개체 이름으로 쓸 때는 `Bound=Fit-Render-ClipPath`처럼 `=`와 `-`로 잇습니다. 코드가 두 표기를 따로 읽으므로 섞어 쓰지 않습니다 |
| `MultiRenderBound` | 한 페이지에 렌더 영역을 여러 개 둡니다. 개체마다 별도 출력 영역이 됩니다 |
| `MultiCutMargin`, `MultiInnerMargin` | 재단선과 안전선을 여러 개 둡니다 |
| `MultiClipPath` | 클리핑 영역을 여러 개 둡니다. 각 개체는 중심이 가장 가까운 영역에 잘립니다 |

`PageMask` 레이어는 숨겨 둬도 변환합니다. 다른 레이어는 숨기면 빠집니다.

## 특수 용도 레이어

| 레이어 이름 | 동작 |
| - | - |
| `PageCaption` | 스토리보드의 페이지 이름입니다. [페이지와 상위 페이지(마스터)](/docs/templates/pages)를 보세요 |
| `DataRule` | 데이터 병합 변수의 규칙입니다. [변수와 데이터 병합](/docs/templates/variables)을 보세요 |
| `CalendarBox` | 달력 날짜 칸의 위치입니다. [달력 상품](/docs/products/calendar)을 보세요 |
| `Embed` | 다른 페이지의 축소본을 보여 주는 칸입니다. 개체 이름을 `page-0`처럼 `page-페이지번호`(0부터 셈)로 짓습니다. 다른 이름이면 업로드가 실패합니다. 편집기에서는 읽기 전용입니다 |
| `Select@key=값` | 한 페이지에 렌더 영역과 가이드를 여러 벌 두고 사용자가 하나를 고르게 하는 일부 상품 전용 레이어입니다. `key`마다 레이어를 하나씩 만들고 안에 `RenderBound`, `Guide`라는 이름의 개체만 넣습니다. 편집기 화면 위에 선택 목록이 나타나고, 고른 `key`의 가이드만 보이며 그 `RenderBound`로 렌더링합니다 |
| `Label@lang=ko` | `Select` 선택 목록에 보일 이름표입니다. 개체 이름을 `key값=표시이름`으로 짓고 언어마다 레이어를 만듭니다. `Select`를 쓰면 모든 `key`에 이름표가 있어야 합니다 |
| `DocInfo` | 개체 이름 `DocType=define`을 두면 정의 문서가 됩니다. 이 문서에서 `define=true`를 이름에 붙인 `Guide`나 후가공 레이어의 개체가, 다른 템플릿에서 `inject=개체이름`을 붙인 개체에 그림을 공급합니다. 일부 상품 전용입니다 |
| `Svgart` | 코드가 인식하지만 익스포터가 그림을 캡처하지 않아 InDesign 템플릿에서는 쓰지 않습니다 |

## 목록에 없는 이름

* **InDesign 기본 이름**(`레이어 1`, `Layer 1`처럼 `레이어`나 `Layer`로 시작하는 이름): 개체 종류로 자동 분류합니다. 그룹은 `Sticker`, 텍스트 프레임은 `Text`, 사각형과 원과 다각형은 `Path`가 됩니다. `Path`로 바뀐 프레임 안의 이미지는 버려집니다.
* **그 밖의 이름**: 후가공 레이어처럼 별도 판으로 취급합니다. 선택할 수 없고 인쇄 이미지에는 들어가지 않습니다.

이름이 틀리면 오류 없이 엉뚱하게 변환되므로 역할마다 위 표의 이름을 직접 붙입니다.

## 개체 종류별 변환 결과

| InDesign 개체 | `Text` | `Cell` | `Sticker`, `Guide`, 후가공 | `Path` |
| - | - | - | - | - |
| 텍스트 프레임 | 글상자 | 프레임 모양의 사진 칸. 글자는 버림 | `Sticker`는 그림, `Guide`는 고칠 수 없는 글상자. 후가공 레이어에서는 글자가 변환되지 않으니 윤곽선으로 만들어 넣음 | 프레임 외곽선 도형. 글자는 버림 |
| 이미지가 든 그래픽 프레임 | 버림 | 사진 칸. 이미지는 프레임 이름이 `Image`일 때만 남김 | 그림 | 프레임 도형. 이미지는 버림 |
| 사각형, 원, 다각형 | 버림 | 사진 칸. 사각형이 아니면 그 모양으로 사진을 자름 | 그림 | 도형 |
| 선, 열린 패스 | 버림 | 권장하지 않음 | 그림 | 선 도형 |
| 그룹 | 버림 | [컴포지트 사진 칸](/docs/templates/reserved-names#사진-칸) | 그룹 하나가 그림 하나 | 그룹 안 도형을 합친 도형 하나 |
| 패스 위 텍스트 | 패스 위 글상자 | 권장하지 않음 | 그림 | 권장하지 않음 |

`Sticker`, `Guide`, 후가공 레이어의 그림은 순수 벡터면 SVG로, 이미지가 섞여 있으면 PNG로 올라갑니다. 원형 그레이디언트가 있는 벡터는 기본으로 PNG로 올라가고, 익스포터 메뉴의 **radial gradient**를 켜면 SVG로 올라갑니다([익스포터 설치와 설정](/docs/templates/install-exporter) 참고). 색은 CMYK나 RGB 견본만 씁니다. Lab 색을 쓴 벡터는 내보낼 때 `rgb_color missing` 오류가 납니다. InDesign에 링크로 넣은 일러스트(AI, PDF, EPS 파일)는 벡터로 보여도 PNG로 들어갑니다. 텍스트 프레임 안에 넣은 인라인 그래픽은 따로 변환하지 않습니다.

`Text` 레이어에서는 아래 텍스트 프레임이 빠집니다. 자세한 규칙은 [텍스트 프레임과 폰트](/docs/templates/text)에 있습니다.

* 글자가 하나도 없는 프레임
* 글자 색이 \*\*\[없음]\*\*인 글자가 하나라도 있는 프레임

## 쌓이는 순서

편집기는 InDesign과 같은 순서로 개체를 쌓습니다. 레이어 패널에서 아래 레이어가 아래에 깔리고, 한 레이어 안에서는 InDesign의 앞뒤 순서를 따릅니다. 다만 아래 레이어는 위치가 고정됩니다.

```text theme={null}
(위) 후가공 레이어와 Guide 개체     ← 레이어 순서와 관계없이 항상 맨 위
     Text, Cell, Sticker, Path 등   ← InDesign 레이어 순서대로
     Background                     ← 항상 일반 개체 아래
     -BG 구분자 레이어
(아래) Guide@bottom=true            ← 바탕보다도 아래
```

`Guide@bottom=true`는 흰 바탕에 가려집니다. 바탕이 보이지 않게 하는 방법은 [스마트폰 케이스 예제](/docs/templates/phone-case)에 있습니다.

## 숨김, 잠금, 인쇄 안 함, 상위 페이지

| 상태 | 처리 |
| - | - |
| 숨긴 레이어, 숨긴 개체 | 변환에서 빠집니다. `PageMask` 레이어만 예외입니다 |
| 잠긴 레이어, 잠긴 개체 | 잠금 설정을 읽지 않고 똑같이 변환합니다. 익스포터는 변환 중에 개체의 회전을 잠시 0도로 바꿨다가 되돌리므로, 잠금 때문에 내보내기가 오류로 멈추면 잠금을 풀고 다시 내보냅니다 |
| 인쇄 안 함 레이어 | 이 설정을 판단에 쓰지 않습니다. 빼려면 레이어를 숨기거나 `render=false`를 씁니다 |
| 상위 페이지(마스터) 개체 | 그 상위 페이지를 적용한 페이지마다 변환해 넣습니다. 레이어 규칙은 같습니다. InDesign 2022부터 마스터를 상위 페이지라고 부릅니다. [페이지와 상위 페이지(마스터)](/docs/templates/pages)를 보세요 |

## 흔한 실수와 증상

이름이 틀려도 내보내기와 업로드는 오류 없이 끝납니다. 아래 증상이 보이면 이름부터 확인합니다.

| 실수 | 예 | 증상 |
| - | - | - |
| 레이어 종류의 대소문자나 철자가 틀림 | `text`, `Texts`, `Creese`, `clipPath` | 목록에 없는 이름이라 후가공 판으로 취급합니다. 편집기에서 맨 위에 고정되어 선택되지 않고, 인쇄 이미지에서 빠져 그 이름의 별도 판으로 나갑니다. 익스포터가 그림을 캡처하지 않아 글자와 선만 있는 개체는 사라지고, 채움이 있는 도형은 모양 대신 채움 색 정보만 남습니다 |
| 레이어 이름 앞뒤에 공백 | `Text `, ` Cell` | 공백까지 이름으로 읽어 위와 같은 증상이 납니다 |
| 한글 입력 상태로 친 전각 `＠` | `Cell＠movable=false` | `@`로 읽지 않아 이름 전체가 종류가 됩니다. 위와 같은 증상이 납니다 |
| 전각 `＝`, `：`, `，` | `Cell@movable＝false` | 그 설정만 조용히 무시됩니다. 전각 쉼표로 이은 설정은 둘 다 무시됩니다 |
| 개체 이름 앞뒤에 공백 | `Image `, `none ` | 예약 이름으로 읽지 않습니다. `Image `는 기본 사진이 버려지고, `none `은 사각형의 채움 색이 바탕으로 나옵니다 |
| `none`을 대문자로 씀 | `None`, `NONE` | 바탕을 지우지 않고 사각형의 채움 색이나 바탕 그림이 그대로 나옵니다 |

이름마다 대소문자 규칙이 다릅니다. 표에 적힌 철자 그대로 쓰는 것이 가장 안전합니다.

| 이름 | 대소문자 |
| - | - |
| 레이어 종류(`Text`, `Cell`, `Cut`, `ClipPath` 등) | 구분합니다 |
| 사진 칸 개체 `Image`, `mask`, `frame` | 구분하지 않습니다 |
| 바탕 개체 `none`, `transparent`, `white`, `color` | 소문자만 받습니다 |
| `PageInfo` 개체(`CutMargin`, `RenderBound` 등) | 구분합니다. `ClipPath`와 `HidePath`만 첫 글자 소문자(`clipPath`, `hidePath`)도 받습니다 |
| 어노테이션 키와 값 | 키마다 다릅니다. `movable`, `hidden` 같은 켜고 끄는 개체 속성은 구분하지 않고, `render`, `clip`, `bottom` 같은 표시 키는 구분합니다. 목록은 [어노테이션](/docs/templates/annotations#문법)에 있습니다. 모두 소문자로 쓰면 안전합니다 |

레이어 이름에서 `clipPath`처럼 첫 글자를 소문자로 쓰면 영역이 아니라 후가공 판이 됩니다. 소문자 허용은 `PageInfo` 개체 이름에만 해당합니다.

## 됐는지 확인

<Check>
  Edicus Manager의 **Demo**에서 `Text`의 글자만 고쳐지고 `Guide`가 선택되지 않으면 화면 구성이 의도대로 분류된 것입니다. Demo는 사진을 올릴 수 없으므로, 사진 칸에 사진이 들어가는지와 후가공 판은 [테스트 주문과 렌더링](/docs/templates/test-render)의 Test Order로 확인합니다.
</Check>

## 다음 단계

<Columns cols={2}>
  <Card title="어노테이션" icon="at" href="/docs/templates/annotations">
    레이어와 개체 이름 뒤에 붙여 동작을 바꾸는 설정입니다.
  </Card>

  <Card title="예약 개체 이름과 페이지 영역" icon="tag" href="/docs/templates/reserved-names">
    `Image`, `none`, `PageInfo` 개체처럼 이름으로 동작이 정해지는 개체입니다.
  </Card>
</Columns>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.