Snippet 연산자는 게시물 본문 요약글입니다. 게시물 목록의 짧은 글을 볼 수 있을 텐데, Snippet 연산자를 이용한 것입니다.
Snippet 연산자
| 파라미터 | 설명 |
|---|---|
| length |
문자열 최대 길이 설정. 숫자만 입력 가능. 최소 50 ~ 1000자 이내. 기본 값: 50 |
| linebreaks |
줄바꿈 사용할지 결정. true or false 중 하나. 기본 값: true |
| links |
링크를 허용할지 결정. true or false 중 하나. 기본 값: true |
| ellipsis |
요약글 끝에 점(…)을 추가할지 결정. true or false 중 하나. 기본 값: true |
snippet은 최소 50자 이내, 최대 길이는 1000자를 넘지 않으며, HTML 태그 형식(bold, italic, 링크가 걸린 글자 또는 줄바꿈)이 제거된 일반 문자열을 반환합니다.
<b:eval
expr='data:post.body snippet {
length: 150,
links: false,
linebreaks: false,
ellipsis: false }'
/>linebreaks, links, ellipsis는 기본값이 true 입니다. 허용하지 않으려면 false로 설정합니다.
ellipsis는 요약글 끝에 점 세 개가 붙고, 줄바꿈은
<br/> 태그로 변환됩니다.
links는 링크 태그가 있는 경우 허용할지를 결정할 수 있습니다.
아래에서 게시물 요약글을 표현하기 위한 몇 가지 방법에 대해서 알아보겠습니다. 테마 / 템플릿마다 설정 가능한 곳이 조금씩 다를 수 있지만 게시물 본문은 보통 아래 코드 안에서 대부분 설정이 가능합니다.
<b:includable id='post' var='post'>
... ...
</b:includable>예제 1
본문(post.body)을 snippet으로 사용할 경우 HTML 태그 형식을 포함하여 출력합니다. 또한 게시물 본문 최대 길이 1000자 이내로 설정할 수 있습니다.
다음은 본문(post.body) 길이를 150자 이내로 설정한 예시입니다.
<!-- 기본 값 -->
<data:post.body/>
<!-- 특정 값 설정 시 -->
<b:eval expr='data:post.body snippet { length: 150 }'/>예제 2
본문 요약글(post.snippet)을 snippet으로 사용할 경우 HTML 태그 형식(bold체, italic체, 링크가 걸린 글자)이 제거되며, 문자열 길이의 기본 값은 128자입니다.
다음은 본문요약글(post.snippet) 길이를 80자 이내로 설정한 예시입니다.
<!-- 기본 값 -->
<data:post.snippet/>
<!-- 특정 값 설정 시 -->
<b:eval expr='data:post.snippet snippet { length: 80 }'/>예제 3
긴 본문 요약글(post.snippets.long)을 snippet으로 사용할 경우 문자열 길이의 기본 값은 1000자이며, HTML 태그 형식이 제거됩니다.
다음은 긴 본문 요약글(post.longSnippet) 길이를 80자 이내로 설정한 예시입니다.
<!-- 위젯 버전 2 레이아웃 버전 3 -->
<html b:defaultwidgetversion='2' b:layoutsVersion='3' b:templateVersion='1.3.0'>
<!-- 기본 값 -->
<data:post.snippets.long/>
<!-- 특정 값 설정 시 -->
<b:eval expr='data:post.snippets.long snippet { length: 80 }'/>