개발자와 에이전시를 위한 커스텀 템플릿

소유자와 관리자는 Creator Pro부터 “도메인 및 템플릿”에서 자체 템플릿을 만들 수 있습니다. 이 템플릿은 하나의 레이아웃을 여러 페이지에서 재사용하려는 개발자와 에이전시를 위한 HTML 틀입니다. 페이지를 디자인하는 데는 필요하지 않습니다.

#플랜과 권한

템플릿을 만들고 편집하고 삭제하는 것은 소유자와 관리자만 가능합니다. Creator Free에서는 “+ 템플릿” 버튼이 잠겨 있고 “워크스페이스 템플릿은 Creator Pro부터 사용할 수 있습니다.”가 표시됩니다.

#템플릿 만들기

1. “도메인 및 템플릿”을 엽니다
2. “+ 템플릿”을 클릭합니다
3. 항목을 채우고 “만들기”를 클릭합니다

“키 (a-zA-Z0-9_-)”

문자, 숫자, _, -로 된 2~64자입니다. 키는 워크스페이스 안에서 고유하며 나중에 바꿀 수 없습니다.

“이름”

필수이며 최대 120자입니다. 예: “제품 출시”.

“시작 템플릿”

만들 때만 표시됩니다: “빈 템플릿” 또는 기본 제공 템플릿의 사본. 사본은 원본의 구조, 플레이스홀더, 모양을 그대로 가져오므로 가장 빠르게 시작할 수 있습니다.

“상태”

편집할 때만 표시됩니다: “활성” 또는 “사용 중지”.

“HTML 콘텐츠”

필수인 HTML 틀입니다. 최대 60,000바이트이며, 악센트가 있는 문자 등 특수 문자는 1바이트보다 많이 차지합니다. HTML이 더 크면 LinkHarbor가 저장을 거부합니다.

“스키마 (JSON)”와 “기본값 (JSON)”

템플릿에서 조정할 수 있는 값과 그 기본값을 정의합니다. 둘 다 유효한 JSON이어야 하며 기본값은 스키마와 일치해야 합니다. 각각 최대 64 KB이며, 그 안의 개별 텍스트는 최대 5,000자입니다.

#HTML 규칙

HTML에는 페이지 콘텐츠가 들어갈 자리를 나타내는 플레이스홀더가 있어야 합니다.

보안을 위해 LinkHarbor는 저장할 때 HTML을 정리합니다.

• div, section, header, p, a, img, table 같은 일반적인 텍스트 및 레이아웃 요소는 허용됨. script, iframe, noscript는 내용과 함께 제거되고, form, svg, link, meta 같은 다른 요소는 내용을 남기고 제거됨
• onclick 같은 이벤트 속성과 javascript: 링크는 삭제됨
• style 블록은 유지되지만 커스텀 CSS와 마찬가지로 다른 서버에서 아무것도 불러올 수 없음
• CSS 클래스는 lh-로 시작하거나, 기본 제공 템플릿에 있거나, 템플릿의 style 블록에서 .hero { … }처럼 정의된 경우에 유지되며 그 밖의 클래스는 제거됨. ID와 data-, aria- 속성은 유지됨
• 인라인 스타일은 허용되지만 다른 서버를 가리키는 url(), @import, position: fixed가 있는 선언은 제거됨
• style 블록이나 style="" 안의 플레이스홀더에는 #1a2b3c 같은 색상, 24px 같은 크기, 0.5 같은 숫자처럼 유효한 CSS 값만 들어감. ; { } 따옴표나 url()이 있는 값은 비어 있게 됨. 기본값이 색상, 크기, 숫자인 필드는 페이지를 저장할 때 이런 값만 받음
• 이미지는 LinkHarbor 에셋이나 {{avatar_url}} 같은 플레이스홀더로만 사용 가능

저장을 막는 오류는 두 가지입니다. style 블록에 외부 주소가 있으면 “템플릿 CSS는 다른 서버에서 아무것도 불러올 수 없습니다 …”가 표시되고, {{#if}}, {{#unless}}, {{#each}}가 시작한 텍스트, 태그, 속성 안에서 끝나지 않거나 style, href, src 안에 있으면 “템플릿 HTML의 섹션(…)이 허용되지 않거나 올바르게 닫히지 않았습니다.”가 표시됩니다.

2026년 11월 1일 이전에 저장된 템플릿은 당시 저장할 때 스타일과 클래스가 사라졌습니다. 필요하다면 새 사본에서 다시 만드세요.

#페이지에 템플릿 사용

활성 워크스페이스 템플릿은 페이지를 만들 때와 빌더의 “테마” → “템플릿”에 있는 “나만의 템플릿” 그룹에 표시되며, 그 위의 “기본 제공 템플릿”에는 기본 템플릿 17개가 있습니다. 설명에는 “‘도메인 및 템플릿’에서 만든 워크스페이스 템플릿입니다.”라고 표시됩니다. 선택과 변경은 기본 제공 템플릿과 같습니다. 템플릿 선택 및 변경을 참고하세요.

• 템플릿을 바꾸면 페이지 미리보기에 바로 반영되지만, 페이지를 다시 게시해야 실제로 적용됨. 여러 페이지가 이 템플릿을 쓴다면 각 페이지를 다시 게시
• 게시할 때 LinkHarbor는 템플릿 사본을 버전에 저장함. 따라서 나중에 템플릿을 바꾸거나 비활성화해도 공개 중인 페이지는 그대로 유지됨
• API와 AI 어시스턴트에서 워크스페이스 템플릿은 “ws:”와 키를 합친 이름으로 불림. 예: ws:product-launch
• 자체 이미지 슬롯은 API(asset_slots)로 정의하며 템플릿당 최대 32개

#편집, 비활성화, 삭제

목록에는 이름, 키, 상태, 날짜와 함께 “편집”과 “삭제” 버튼이 표시됩니다.

비활성화

편집할 때 “상태”를 “사용 중지”로 설정합니다. 이미 이 템플릿을 쓰는 페이지는 그대로 유지합니다. 이때 빌더에는 예를 들어 “현재: 제품 출시 (비활성화됨)”가 표시됩니다. 더 이상 선택할 수 없으며, 선택하려고 하면 “이 워크스페이스 템플릿은 비활성화되어 있습니다. 페이지에 사용하려면 '도메인 및 템플릿'에서 활성화하세요.”가 표시됩니다.

삭제

삭제한 템플릿은 목록에서 완전히 사라지고 한도에서도 빠지며, 그 키를 새 템플릿에 다시 쓸 수 있습니다. 페이지가 템플릿을 쓰는 동안에는 삭제가 차단됩니다: “이 템플릿은 아직 {count}개 페이지에서 사용 중입니다. 먼저 해당 페이지의 템플릿을 바꾸세요.” {count} 자리에는 페이지 수가 표시됩니다.

비활성화된 템플릿도 플랜 한도에 포함됩니다. 자리가 필요하면 삭제하세요.

#다운그레이드와 업그레이드 시

Creator Free에서는 활성 워크스페이스 템플릿이 모두 비활성화되고, 목록에 “플랜으로 인해 비활성화됨”이 표시됩니다. 게시된 페이지는 커스텀 템플릿을 쓰는 페이지를 포함해 그대로 유지됩니다. 빌더에서는 “현재:” 옆에 “(비활성화됨)”이 표시됩니다. 업그레이드하면 바로 이 템플릿들이 다시 활성화됩니다. 직접 비활성화하거나 삭제한 템플릿은 그 상태로 남습니다.