콘텐츠로 건너뛰기
주의:: 이 문서는 사용자의 편의를 위해 제공됩니다. 이 문서는 번역 소프트웨어를 사용하여 자동으로 번역되었으며 교정을 거치지 않았을 수 있습니다. 이 문서의 영어 버전이 가장 최신의 정보를 확인할 수 있는 공식 버전으로 간주해야 합니다. 여기에서 액세스할 수 있습니다..

사용자 지정 코딩 템플릿 구축

마지막 업데이트 날짜: 2025년 11월 19일

명시된 경우를 제외하고 다음 구독 중 어느 것에서나 사용할 수 있습니다.

개발자는 HTML + HubL을 사용하여 블로그, 웹사이트 페이지, 랜딩 페이지 및 이메일 템플릿을 처음부터 만들 수 있습니다. 드래그 앤 드롭 템플릿 레이아웃을 HTML로 복제한 다음 코딩된 템플릿으로 사용자 지정할 수도 있습니다.

개발자 문서에서 사용자 지정 에셋 디자인에 대해 자세히 알아보세요.

시작하기 전에

이 기능으로 작업을 시작하기 전에 미리 수행해야 할 단계와 이 기능의 제한 사항 및 사용 시 발생할 수 있는 결과를 완전히 이해해야 합니다.

요구 사항 이해

제한 사항 및 고려 사항 이해

  • 이메일 템플릿을 만들려면 마케팅 허브 프로페셔널 또는 엔터프라이즈 구독이 필요합니다. 콘텐츠 허브 계정은 드래그 앤 드롭 이메일 편집기를 사용하여 이메일을 만들 수 있습니다.
  • 사용자 지정 코딩 템플릿은 미리 정의된 많은 변수를 사용할 수 있습니다. 이러한 변수 중 일부는 이메일 및 페이지를 만드는 데 필수이며, 다른 변수는 선택 사항입니다. 필수 이메일, 웹사이트 및 랜딩 페이지 HubL 변수를 추가하는 방법에 대해 자세히 알아보세요.

새 HTML + HubL 파일 만들기

  1. HubSpot 계정에서 콘텐츠 > 디자인 관리자로 이동합니다.
  2. 파인더 상단에서 파일 드롭다운 메뉴를 클릭하고 새 파일을 선택합니다.

In the design manager, within the finder, a box is placed around the File dropdown menu and the options are displayed. An arrow points to the 'New file' option.

  1. 대화 상자에서 오늘 무엇을 빌드하시겠습니까? 드롭다운 메뉴를 클릭하고 HTML + HubL을 선택합니다.
In the design manager, the new file dialog box is visible. An arrow points to the What would you like to build today dropdown menu, displaying two of the options: HTML + HubL and Drag and drop.
  1. 무엇을 빌드하시나요? 필드에서 옵션을 선택합니다:
    • 템플릿: 웹사이트 페이지, 랜딩 페이지, 블로그 글 또는 이메일에 표시될 콘텐츠의 레이아웃과 구조를 정의합니다.
    • 템플릿 부분: 재사용 가능한 코드 또는 다른 여러 템플릿에 포함될 수 있는 코드 조각입니다.
  2. 템플릿 유형 드롭다운 메뉴를 클릭하고 사용자 정의 코딩된 템플릿의 유형 (페이지, 블로그 글/목록, 이메일 또는 시스템 페이지)을 선택합니다. 템플릿 유형에 대해 자세히 알아보세요.
  3. 파일 이름 필드에 파일 이름을 입력합니다.
  4. 파일 위치를 업데이트하려면 파일 위치 섹션에서 변경을 클릭하고 폴더를 선택합니다 .
  5. 완료했으면 만들기를 클릭합니다.

템플릿에 HTML + HubL 추가하기

새 파일을 구성한 후에는 코드 편집기로 이동하여 사용자 정의 코드를 추가하고 라이브 페이지에 어떻게 표시되는지 미리 볼 수 있습니다.

HTML + HubL 추가

  1. 템플릿의 HTML을 입력합니다. 사용자 정의 코딩 템플릿에 CSSJavaScript 파일을 추가하는 방법에 대해 자세히 알아보세요.
  2. HTML + HubL이 렌더링되는 방식을 표시하려면 왼쪽 상단의 출력 표시 스위치를 켭니다. 오른쪽에 렌더링된 미리보기가 있는 패널이 열립니다.

필요한 HTML + HubL 추가하기

사용자 정의 코딩 템플릿이 작동하려면 특정 HTML 또는 HubL 변수가 필요합니다. 이러한 필수 변수 중 하나라도 누락된 경우 템플릿을 게시하려고 할 때 오류 메시지가 표시될 수 있습니다.

  • 페이지 및 블로그 템플릿에는 다음 변수가 필요합니다:

<!-- Enter above the closing </header> tag -->
{{ standard_header_includes }}

<!-- Enter above the closing </body> tag -->
{{ standard_footer_includes }}

<!-- Enter variables above the closing </body> tag -->
{{ site_settings.company_name }}
{{ site_settings.company_street_address_1 }}
{{ site_settings.company_city }}
{{ site_settings.company_state }}
{{ site_settings.company_zip }}
{{ site_settings.company_country }}

<!-- Choose one unsubscribe variable -->
{{ unsubscribe_link }}
{{ unsubscribe_link_all }}

  • 이메일 템플릿이 특정 이메일 클라이언트에서 미리 보기 텍스트를 표시하려면 다음 코드가 필요합니다:

<!-- Preview text (text which appears right after subject in certain email clients) -->

<div id="preview_text" style="display:none!important">{% text "preview_text" label="Preview Text <span class=help-text>This will be used as the preview text that displays in some email clients</span>", value="", no_wrapper=True %}
</div>

템플릿을 HTML로 복제

템플릿을 처음부터 새로 만드는 것 외에도 블로그, 웹사이트 페이지 및 랜딩 페이지용 드래그 앤 드롭 템플릿을 HTML로 복제할 수도 있습니다.

  1. HubSpot 계정에서 콘텐츠 > 디자인 관리자로 이동합니다.
  2. 파인더에서 복제하려는 템플릿의 이름을 클릭합니다.
  3. 작업 드롭다운 메뉴를 클릭하고 HTML로 복제를 선택합니다. 원본 파일과 동일한 폴더에 HTML 파일이 생성됩니다.

In the design manager, within the finder, a box is placed around the Actions dropdown menu and the options are displayed. An arrow points to the 'Clone to HTML' option.

템플릿 미리보기 및 게시

템플릿을 만든 후에는 라이브 페이지에 템플릿이 어떻게 표시되는지 미리 본 다음 게시할 수 있습니다.

  1. HubSpot 계정에서 콘텐츠 > 디자인 관리자로 이동합니다.
  2. 파인더에서 미리 보거나 게시하려는 템플릿의 이름을 클릭합니다.
  3. 오른쪽 상단에서 미리 보기 드롭다운 메뉴를 클릭하고 옵션을 선택합니다:
    • 표시 옵션이 있는 실시간 미리보기를 선택하면 뷰포트 사전 설정을 선택하여 템플릿이 다른 디바이스에 표시되는 것처럼 미리 볼 수 있습니다.
    • 표시 옵션 없이 미리 보기를 선택하면 템플릿이 브라우저에 표시되는 방식만 미리 볼 수 있습니다.
  4. 완료했으면 변경 사항 게시를 클릭합니다.
  5. 코드 오류가 있는 경우 오류 메시지가 표시됩니다. 코드 편집기 아래의 오류 콘솔에서 이러한 오류에 대한 자세한 정보를 검토하세요:
    • 페이지 상단의 오류 메시지에서 오류 콘솔을 클릭하여 코드 편집기 아래의 콘솔을 엽니다.
    • 또는 코드 편집기 왼쪽 하단으로 이동하여 세부 정보 표시를 클릭합니다.
이 문서가 도움이 되었나요?
이 양식은 문서 피드백에만 사용됩니다. HubSpot으로 도움을 받는 방법 알아보기.