티스토리 스킨 제작에 사용되는 다양한 치환자 (Placeholders)에 대해 설명한다. 이 치환자들은 특정 정보를 동적으로 불러와 블로그 스킨에 표시하는 역할을 하며, 주요 치환자 유형과 그 용도는 다음과 같다. 티스토리 스킨을 제작하는데 무조건 적인 필수요소이나, 심플한 페이지를 만들고 싶다면 딱히 모두가 다 필요하지는 않다. 정말 딱 1단형 페이지, 광고를 달기위한 샘플 페이지라면 몇가지 만으로도 제작이 가능하다. 심지어 위와같이 아주 가단한 구조의 스킨이라면, 치환자와 구조를 GPT 에 넣어서 티스토리 기반의 스킨 제작시 충분히 제작이 가능하다.
기본 정보 치환자
블로그 자체에 대한 기본 정보를 표시하는 데 사용됩니다.
예시:
[##_title_##]: 블로그 제목[##_image_##]: 블로그 대표 이미지 URL[##_blog_image_##]: 블로그 대표 이미지를 포함한<img>태그[##_desc_##]: 블로그 설명[##_blogger_##]: 블로그 소유자의 필명[##_blog_link_##]: 블로그 URL[##_rss_url_##]: RSS 피드 주소[##_taglog_link_##]: 태그로그 URL[##_guestbook_link_##]: 방명록 URL
기타 치환자
페이지 제목이나 메뉴 리스트 등을 표시하는 데 사용됩니다.
[##_page_title_##]: 페이지 제목[##_blog_menu_##]: 블로그 메뉴 리스트
페이지 타입 body_id
현재 페이지의 종류에 따라
<body>태그에 추가되는 ID 값을 나타냅니다. 이를 통해 페이지 종류별로 다른 CSS 스타일을 적용할 수 있습니다.예시:
홈화면:
tt-body-index글화면 (퍼머링크 페이지):
tt-body-page카테고리 글 리스트:
tt-body-category보관함 글 리스트:
tt-body-archive태그 리스트:
tt-body-tag검색결과 리스트:
tt-body-search방명록:
tt-body-guestbook지역로그:
tt-body-location
광고 치환자
블로그 홈 또는 목록 페이지의 상단과 하단에 광고 영역을 표시하는 데 사용됩니다.
[##revenue_list_upper##]: 블로그 홈/목록 상단 광고 영역[##revenue_list_lower##]: 블로그 홈/목록 하단 광고 영역
글 치환자 (Article Placeholders)
개별 글의 정보를 표시하는 데 사용되는 핵심 치환자 그룹입니다.
글 정보: 글의 제목, 링크, 카테고리, 작성 날짜/시간, 본문 내용 등을 표시합니다. 날짜/시간은 연도, 월, 일, 시, 분, 초 단위로 분리하여 표시할 수 있습니다. 팀블로그에서는 작성자 이름(
[##_article_rep_author_##])을 표시할 수 있습니다.대표 이미지 썸네일: 글의 대표 이미지가 있는 경우 썸네일 주소나 원본 주소를 표시할 수 있습니다.
댓글 수: 글에 달린 댓글의 개수를 표시합니다 (
[##_article_rep_rp_cnt_##]).관리 기능: 관리 권한이 있는 사용자에게 글 수정, 삭제, 상태 변경, 트랙백 등의 관리 기능 링크나 이벤트를 표시합니다.
태그: 글과 관련된 태그를 반복하여 출력하는 영역입니다 (
[##_tag_label_rep_##]).퍼머링크 / 인덱스: 이 치환자들은 **글화면 (퍼머링크 페이지)**과 **홈화면/목록 페이지 (인덱스 페이지)**에서 다르게 표시될 내용을 구분하는 데 사용됩니다.
퍼머링크 영역: 퍼머링크 페이지일 때만 표시됩니다.
인덱스 영역: 인덱스 페이지일 때만 표시됩니다. 인덱스 페이지에서는 글 내용 전체 대신 **요약(
[##_article_rep_summary_##])**을 표시할 수 있습니다.
카테고리의 다른 글: 현재 글이 속한 카테고리의 다른 글 목록을 보여주는 영역입니다. 대표 이미지 유무에 따라 글 타입(
[##_article_related_rep_type_##])을 구분할 수 있으며, 제목, 링크, 발행 시간, 썸네일 링크 등을 표시합니다.이전 글 / 다음 글: 현재 글의 이전 글과 다음 글 정보를 보여줍니다. 제목, 링크, 작성 시간, 대표 이미지 썸네일 링크 등을 표시하며, 글 타입(
[##_article_prev_type_##],[##_article_next_type_##])도 구분할 수 있습니다.
홈 커버 (Home Cover)
홈 화면을 꾸미기 위해 제공되는 치환자입니다.
커버 그룹 치환자 내부에 개별 커버를 표시하는 치환자가 있습니다.
[##_cover_title_##]: 개별 커버의 타이틀.[##_cover_url_##]: 개별 커버의 URL (URL이 있는 경우에만 치환).커버 컨텐츠 치환자: 커버에 포함된 컨텐츠(글 또는 직접 입력 내용)의 제목, 요약/내용, URL, 이미지, 카테고리, 날짜, 댓글 수 등을 표시합니다. 컨텐츠가 글인 경우와 글이 아닌 경우에 사용 가능한 치환자가 약간 다릅니다.
정의 (index.xml): 홈 커버를 사용하려면 스킨 정보 파일인
index.xml에 커버 아이템을 정의해야 합니다. 각 커버 아이템은 이름(name), 사용자에게 표시할 이름, 설명 등을 가집니다.기본값: 스킨 적용 시 제작자가 추천하는 커버 설정이 적용되도록 기본값을 JSON 형태로 설정할 수 있습니다. 기본값 JSON 구조는
name,title,dataType,data를 포함합니다.dataType: 컨텐츠의 데이터 유형으로, '최신 글' (RECENT) 또는 '직접 입력' (CUSTOM)만 사용할 수 있습니다.RECENT: 카테고리 (
ALL,NOTICE)와 표시될 글 개수(size)를 설정합니다.CUSTOM: 컨텐츠의 제목, 요약, URL, 썸네일 이미지를 직접 설정합니다.
스킨 정보 파일 (index.xml)
스킨에 필요한 정보를 담고 있는 XML 파일입니다. 이 파일이 변경되면 스킨의 모든 설정이 초기화될 수 있습니다.
스킨의 기본 정보 (이름, 버전, 설명, 라이선스), 제작자 정보 (이름, 홈페이지, 이메일), 그리고 스킨의 다양한 설정 기본값을 포함합니다.
설정 기본값 예시: 사이드바의 최근 글/댓글/트랙백 표시 개수, 방명록 페이지당 항목 수, 태그 클라우드 표시 개수/정렬 방식, 댓글/트랙백 영역 기본 상태, 글자 수 제한, 페이지당 글 수, 홈 화면/카테고리 목록 표현 방식, 카테고리 색상/표시 방식, 콘텐츠 영역 가로 사이즈, 홈 커버 기본값 등.
리스트 스타일: 스킨 정보 파일에 리스트 스타일 아이템을 정의하여 카테고리별로 다른 리스트 스타일을 적용할 수 있도록 합니다. 스타일은 이름, 사용될 값, 사용 예시 등을 정의합니다.
옵션 정의: 스킨 설정 항목의 값 유형 (STRING, SELECT, IMAGE, BOOL, COLOR) 및 옵션 선택 시의 정의 (이름, 라벨, 값)를 설정하는 데 사용됩니다.
리스트 치환자 (List Placeholders)
카테고리, 검색, 태그 목록 페이지에서 글 리스트를 표시하는 데 사용됩니다.
리스트 그룹 치환자: 목록 페이지 전체에 대한 정보를 담습니다.
[##_list_conform_##]: 현재 리스트의 대상 (카테고리 이름, 검색어, 태그명).[##_list_count_##]: 글의 총 개수.[##_list_description_##]: 리스트 설명 (카테고리 설명 또는 블로그 설명).[##_list_style_##]: 리스트 스타일 값.[##_list_image_##]: 리스트 대표 이미지 (카테고리 대표 이미지 또는 블로그 대표 이미지).
아이템 반복 그룹: 리스트에 글이 없는 경우 표시될 영역과, 글 목록 아이템이 반복적으로 출력될 영역으로 나뉩니다.
리스트 아이템 치환자: 각 글 목록 아이템의 정보 (고유 주소, 작성 날짜/시간, 제목, 카테고리, 댓글 수, 작성자, 내용 요약, 대표 이미지 정보)를 표시합니다.
[##_list_rep_title_##]는 새 글을 표시하는 이미지 태그를 포함할 수 있으며,[##_list_rep_title_text_##]는 제목 텍스트만 표시합니다.
인기글, 최근 글, 최근 댓글 치환자
인기글: 인기글 목록을 반복 출력합니다. 글 주소, 제목, 댓글 개수, 작성자, 발행 날짜/시간, 대표 이미지, 카테고리 정보 등을 표시합니다.
최근 글: 최근에 올라온 글 목록을 반복 출력합니다. 인기글 치환자와 유사한 정보를 표시합니다.
최근 댓글: 최근에 달린 댓글 목록을 반복 출력합니다. 댓글로 이동할 주소, 댓글 본문 일부, 작성자 이름, 작성 시간 등을 표시합니다.
카테고리 치환자
카테고리 목록을 출력하는 데 사용됩니다. 폴더 형식(
[##_category_##]) 또는 리스트 형식([##_category_list_##])으로 출력할 수 있습니다.
검색 치환자
검색 입력 폼을 출력하는 데 사용됩니다. 검색어 입력 박스의 이름, 검색어 자체, 검색 버튼 클릭 이벤트 등을 표시합니다.
사이드바 구조 치환자
사이드바 영역과 사이드바 내 개별 엘리먼트 그룹을 정의하는 데 사용됩니다. 개별 엘리먼트 그룹의 첫 번째 줄 주석은 사이드바 타이틀로 사용될 수 있습니다.
페이징 치환자
리스트, 글, 방명록 등에서 공통으로 사용되는 페이징 영역을 출력합니다. 이전 페이지 링크, 각 페이지 링크 및 번호, 다음 페이지 링크 등을 표시합니다.