레이아웃용 위젯 태그 도움말에 설명된 바와 같이 다양한 태그를 사용하여 템플릿에 특정 데이터를 포함할 수 있습니다. 태그는 <data:name/>
또는 <data:name1.name2/>
의 형식으로 표시되며, name
은 사용하려는 특정 데이터의 이름입니다. 예를 들어 name1.name2
에서 name2
는 name1
이라는 데이터 집합 내의 특정 항목입니다(예: photo.url
).
사용 가능한 모든 데이터의 핵심 목록입니다. 다른 유형의 위젯에는 다른 데이터가 사용되므로 목록은 페이지 요소에 따라 섹션으로 나뉩니다.
어디에나 사용할 수 있는 데이터
이 정보는 전체 페이지에 적용되므로 특정 위젯에만 사용할 수 있는 다른 데이터와는 달리 어디에나 사용할 수 있습니다. 전체 '블로그' 데이터의 일부로 참조해야 합니다(예: <data:blog.title/>
등).
- title: 블로그의 제목입니다.
- pageType: 현재 페이지의 유형이며 '항목', '보관 파일' 또는 '색인' 중 하나입니다.
- url: 현재 페이지의 URL입니다.
- homepageUrl: 블로그의 홈페이지입니다.
- pageTitle: 현재 페이지의 제목입니다. 대부분의 경우 블로그 제목이지만 보관 파일 또는 게시물 페이지에 대한 추가 정보를 포함할 수 있습니다.
- encoding : 블로그에 사용되는 인코딩입니다(예: UTF-8).
- languageDirection: 왼쪽에서 오른쪽 및 오른쪽에서 왼쪽으로 쓰는 언어의 경우 각각 'ltr' 또는 'rtl'입니다.
- feedLinks: 페이지 헤더에 대한 자동 검색 피드 링크입니다.
페이지 헤더
두 가지 데이터만 포함하는 간단한 위젯입니다. <data:title/>
및 <data:description/>
만으로 참조할 수 있습니다.
- title: 블로그의 제목입니다.
- description: 블로그의 설명입니다.
블로그 게시물
이 부분은 블로그의 핵심이며 가장 복잡하므로 블로그 게시물 위젯을 처음부터 작성하기 전에 기본 템플릿 중 하나를 수정할 수 있음을 반드시 고려해야 합니다. 원하는 경우, 이 위젯에서는 다음과 같은 모든 데이터를 사용할 수 있습니다.
- feedLinks: 이 페이지의 피드 목록입니다. 기본 페이지에서는 피드 목록에 기본 블로그 피드가 포함되며, 항목 페이지의 피드 목록에는 댓글 피드도 포함됩니다. 이 목록의 각 항목에는 다음과 같은 항목이 포함됩니다.
- url: 피드 URL입니다.
- name: 피드 이름입니다(예: '게시물' 또는 '댓글').
- feedType: 피드 유형입니다(Atom 또는 RSS).
- mimeType: 피드의 MIME 유형입니다.
- olderPageUrl: 현재 페이지의 게시물보다 오래된 게시물이 있는 경우 해당 게시물의 URL입니다. 페이지 유형에 따라 다르며 일부 페이지에는 이 링크가 없습니다.
- olderPageTitle: 이전 게시물 페이지에 대한 링크 제목입니다.
- newerPageUrl: olderPageUrl의 최신 버전입니다.
- newerPageTitle: olderPageTitle의 최신 버전입니다.
- commentLabel: 댓글 수를 표시하는 데 사용하는 구문입니다(예: '댓글').
- authorLabel: 게시물의 작성자를 표시하는 데 사용하는 구문입니다(예: '작성자').
- timestampLabel: 게시물이 작성된 시기를 표시하는 데 사용하는 구문입니다(예: '게시 날짜').
- postLabelsLabel: 게시물 라벨의 목록을 소개하는 구문입니다(예: '이 게시물의 라벨').
- backlinksLabel: 게시물의 백링크를 설명하는 구문입니다(예: '이 게시물의 링크')
- posts: 이 페이지의 모든 게시물 목록이며 각 게시물에는 다음과 같은 항목이 포함됩니다.
- dateHeader: 이 게시물의 날짜입니다. 목록에서 해당 날짜에 첫 번째로 게시된 경우에만 표시됩니다.
- id: 숫자 게시 ID입니다.
- title: 게시물의 제목입니다.
- body: 게시물의 콘텐츠입니다.
- author: 게시물 작성자의 표시 이름입니다.
- url: 이 게시물의 퍼머링크입니다.
- timestamp: 게시물의 타임스탬프입니다. 'dateHeader'와는 달리 모든 게시물에 표시됩니다.
- labels: 게시물의 라벨 목록이며 각 라벨에는 다음과 같은 항목이 포함됩니다.
- name: 라벨 텍스트입니다.
- url: 이 라벨과 함께 블로그의 모든 게시물을 표시하는 페이지의 URL입니다.
- isLast: 'True' 또는 'False'입니다. 이 라벨이 목록에 표시되는 마지막 라벨인 경우에 포함됩니다(쉼표를 배치하는 데 유용함).
- allowComments: 이 게시물에 댓글이 허용되면 'True'입니다.
- numComments: 이 게시물에 있는 댓글의 수입니다.
- showBacklinks: 이 게시물에 대한 백링크 표시 여부입니다.
- numBacklinks: 이 게시물에 대한 백링크의 수입니다.
- addCommentUrl: 이 게시물에 대한 '댓글 추가' 양식의 URL입니다.
- emailPostUrl: 이 게시물에 대한 '이 게시물을 이메일로 전송' 양식의 URL입니다.
- editUrl: 이 게시물에 대한 수정 양식의 URL입니다.
- feedLinks: 이 게시물과 관련된 피드의 목록입니다. 이 feedLinks에는 게시물 댓글에 대한 피드 등이 포함될 수 있기 때문에 전체 블로그 feedLinks와는 다릅니다. 각 feedLinks에는 다음과 같은 항목이 포함됩니다.
- url: 피드 URL입니다.
- name: 피드 이름입니다(예: '게시물' 또는 '댓글').
- feedType: 피드 유형입니다(Atom 또는 RSS).
- mimeType: 피드의 MIME 유형입니다.
- comments: 이 게시물의 모든 댓글 목록이며(항목 페이지에만 표시됨) 각 comments에는 다음과 같은 항목이 포함됩니다.
- id: 댓글의 숫자 ID입니다.
- body: 댓글의 본문입니다.
- timestamp: 댓글이 작성된 시간입니다.
- author: 댓글 작성자의 표시 이름 또는 '익명'으로 표시됩니다.
- authorUrl: 댓글이 익명이 아닌 경우 댓글 작성자 프로필의 URL입니다.
- deleteUrl: 이 댓글을 삭제할 URL입니다.
- isDeleted: 이 댓글의 삭제 여부가 표시됩니다. 삭제된 댓글의 텍스트는 자리표시자로 대체됩니다.
블로그 보관 파일
여기에 제공된 여러가지 스타일은 '페이지 요소' 탭의 다양한 기본 옵션을 위한 것입니다. 새 버전을 지정하는 경우 '기본'을 스타일로 사용하고 나머지 데이터를 필요에 따라 변경하면 됩니다.
- title: 위젯의 제목입니다.
- style: '메뉴'의 '기본' 또는 '계층 구조' 중 하나입니다.
- data: 각 보관 파일 단위의 목록이며 다음과 같은 항목이 포함됩니다.
- name: 이 보관 파일 간격의 이름입니다(예: '2006년 8월').
- url: 이 보관 파일 간격의 게시물이 포함된 페이지의 링크입니다.
- post-count:이 보관 파일 간격에 있는 게시물 수입니다.
프로필 위젯
작성자가 한 명인 블로그의 경우 프로필 위젯에 다음과 같은 정보가 포함됩니다. 사진
데이터의 다양한 부분에 액세스하려면 <data:photo.url/>
과 같은 표기법을 사용합니다.
- title: 위젯의 제목입니다.
- userUrl: 작성자의 프로필 URL입니다.
- location: 작성자의 프로필 위치입니다.
- aboutme: 프로필의 '내 소개' 정보입니다.
- displayname: 작성자의 표시 이름입니다.
- photo: 사용자의 프로필 사진이며 다음과 같이 구성되어 있습니다.
- url: 사진 URL입니다.
- width: 사진의 너비(픽셀)입니다.
- height: 사진의 높이(픽셀)입니다.
- alt: 사진의 'alt' 텍스트입니다.
팀 블로그에서는, 프로필 위젯에 다음과 같이 더 많은 작성자가 포함되지만 각 작성자에 대한 정보는 간단하게 표시됩니다.
- title: 위젯의 제목입니다.
- authors: 작성자 목록이며 다음과 같은 항목이 포함됩니다.
- displayname: 작성자의 표시 이름입니다.
- userURL: 작성자의 프로필 URL입니다.
작성자가 한 명인 블로그와 작성자가 여러 명인 블로그에 템플릿을 디자인하려면 data:team
변수를 사용하여 두 경우의 차이를 나타내면 됩니다. 예: <b:if cond='data:team=="true"'>(display multiple authors)</b:if>
Text/HTML/자바스크립트 위젯
텍스트 위젯과 HTML/자바스크립트 위젯은 동일한 방식으로 작동하며 동일한 두 가지 데이터가 포함됩니다.
- title: 위젯의 제목입니다.
- content: 위젯의 콘텐츠입니다.
피드 위젯
블로그가 브라우저에서 렌더링 된 후 피드 위젯의 콘텐츠는 Google AJAX API를 사용하여 동적으로 로드되며, CSS만 사용하여 스타일을 지정할 수 있습니다.
- title: 위젯의 제목입니다.
- feedUrl: 피드의 URL입니다.
사진 위젯
사진 위젯에는 단일 이미지 및 해당 이미지와 관련된 모든 데이터가 포함됩니다.
- title: 위젯의 제목입니다.
- sourceUrl: 이미지의 URL입니다.
- width: 이미지의 너비(픽셀)입니다.
- height : 이미지의 높이(픽셀)입니다.
- caption: 이미지 설명입니다.
라벨 위젯
라벨 위젯에는 블로그에 사용되는 모든 라벨의 목록이 포함됩니다.
- title: 위젯 제목입니다.
- labels: 라벨 목록이며 다음과 같은 항목이 포함됩니다.
- name: 라벨의 텍스트입니다.
- count: 이 라벨이 있는 게시물의 수입니다.
- url: 이 라벨이 있는 게시물이 표시되는 페이지에 대한 링크입니다.
목록 위젯
가장 간단한 양식의 목록입니다. 각 항목은 한 가지 텍스트로 되어 있으며 다른 유형의 데이터는 포함되지 않습니다.
- title: 위젯 제목입니다.
- items: 항목 목록입니다.
링크 목록 위젯
각 항목이 텍스트와 링크 두 부분으로 구성되어 있는 고급 목록입니다.
- title: 위젯 제목입니다.
- links: 링크 목록이며 다음과 같은 항목이 포함됩니다.
- name: 링크의 텍스트입니다.
- target: 링크의 URL입니다.
로고 위젯
이보다 더 간편한 것은 없습니다. 여기에 하나의 데이터만 있으면 됩니다.
- fullButton: 선택한 Blogger 버튼의 URL입니다.