헬프 센터에 자체 테마 자산 사용하기

Suite Growth 플랜 이상에서 사용 가능 모든 Guide 플랜에서 사용 가능

Quick Look: Guide 관리 > 디자인 사용자 지정 > 테마 선택 > 편집 > 자산

이미지 및 파일과 같은 자산을 아무 헬프 센터 테마에나 업로드할 수 있습니다.

이 문서는 다음 섹션으로 구성되어 있습니다.

테마에 자산 업로드하기

이미지 및 파일과 같은 자산을 헬프 센터에 업로드할 수 있습니다. 자산은 클라우드 전송 네트워크(CDN)의 웹 캐시에 저장됩니다. 웹 캐시을 통해 대역폭 요구 사항 및 서버 로드의 부담을 줄이고 응답 대기 시간을 개선할 수 있습니다.

테마에 허용되는 많은 파일 유형이 있습니다. 테마 자산으로 허용되는 파일 유형을 참조하세요.

테마 자산을 업로드하려면 다음과 같이 하세요.

Guide의 사이드바에서 디자인 사용자 지정 아이콘()을 클릭합니다.
편집하려는 테마에서 사용자 지정을 클릭합니다.
코드 편집을 클릭합니다.
파일 섹션에서 새로 추가를 클릭한 다음 자산을 선택합니다.
파일을 찾아서 선택합니다. 테마 자산 이름은 고유해야 하며 50자를 초과할 수 없습니다. 자산 이름에는 문자, 숫자, 점, 빼기 부호, 더하기 부호, 밑줄 및 대시가 포함될 수 있습니다. 자산 이름은 대소문자를 구분하지 않으므로 asset.jpg와 Asset.jpg라는 이름의 자산을 가질 수 없습니다.

자산 파일은 자산 파일 목록에 추가됩니다.

다음 표에서는 테마 자산으로 허용되는 파일 유형을 보여줍니다. 헬프 센터의 테마에서 사용된 파일 유형만 자산의 파일 유형으로 사용할 수 있습니다.

자산 유형	허용되는 파일 유형
이미지	jpg, jpeg, png, gif, svg, webp, tiff, tif, bmp, ico, webm
글꼴	woff2, woff, eot, otf, ttf, svg
텍스트 파일	js, css, html, json, txt, xml
기타	mp4, swf, wav, ogg, mp3

Microsoft PowerPoint, Microsoft Word 및 PDF와 같은 서식 있는 콘텐츠 파일 유형은 문서 첨부 파일이 될 수 있지만 테마 자산은 될 수 없습니다.

테마의 style.css 파일 또는 기본서식에 업로드된 자산을 참조할 수 있습니다. style.css의 경우 Guide에서 제공하는 자산 경로 변수를 사용합니다. 기본서식의 경우 Curlybars 자산 도우미를 사용합니다.

코드에서 자산 변수 및 도우미를 사용하면 테마 코드를 편집하지 않고도 테마의 자산을 쉽게 바꿀 수 있습니다. 테마에서 자산 바꾸기를 참조하세요.

참고: 테마의 script.js 파일에서는 경로 변수 또는 도우미를 사용할 수 없습니다.

테마 코드에서 업로드된 자산을 사용하려면 다음과 같이 하세요.

style.css

.class-name { 
  background: url($assets-backpack2-jpeg);
}

assets-backpack2-jpeg 값은 자산에 대한 상대적 경로를 포함하는 변수입니다.

.hbs 파일

html 마크업:

<img src="{{asset 'backpack2.jpeg'}}">

스타일 태그:

<style>
  .class-name { 
    background: url("{{asset 'backpack2.jpeg'}}");
  }
</style>

스크립트 태그:

<script>
  var assetsBackpack2 = "{{asset 'backpack2.jpeg'}}";
</script>

자산 도우미를 기본서식의 스크립트 태그에 삽입할 수는 있어도 script.js 파일에서는 사용할 수 없습니다.

테마 코드 편집에 대한 자세한 내용은 헬프 센터 테마 사용자 지정하기를 참조하세요.

위의 테마의 코드에 업로드된 자산 사용하기에 설명된 바와 같이 자산 변수 및 도우미를 사용하면 테마 코드를 편집하지 않고도 테마의 자산을 동적으로 바꿀 수 있습니다. 시스템에서 새 자산 파일을 선택하기만 하면 테마가 업데이트됩니다.

자산을 바꾸려면 다음과 같이 하세요.

Guide의 사이드바에서 디자인 사용자 지정 아이콘()을 클릭합니다.
편집하려는 테마에서 사용자 지정을 클릭합니다.
코드 편집을 클릭합니다.
자산 섹션에서 바꾸려는 자산 파일을 찾습니다.
자산 파일 이름 끝에 있는 옵션 메뉴를 클릭한 다음 바꾸기를 선택합니다.
시스템에서 새 자산을 선택합니다.
일단 업로드되면 자산을 참조하는 모든 변수 또는 도우미에 따라 테마가 동적으로 업데이트됩니다. 이 변경 내용은 즉시 적용됩니다.

게시된 헬프 센터 페이지의 HTML 소스에 있는 자산의 전체 URL을 사용한 경우 자산은 바뀌지 않습니다 자산을 바꾸면 게시된 해당 자산의 URL이 변경되기 때문에 자산에 대한 링크가 깨집니다. 따라서 게시된 자산 URL을 테마, 페이지 기본서식 또는 외부 웹 페이지에서는 사용하지 마세요.

테마에서 더 이상 사용하지 않는 테마 자산을 쉽게 삭제할 수 있습니다.

테마 자산을 삭제하려면 다음과 같이 하세요.