테마 제작 가이드

April 10th, 2008

스프링로그 테마는 크게 다음 요소로 구성되어 스프링노트에 저장됩니다.

 

  • 템플릿
  • CSS 스타일시트
  • 자바스크립트

 

테마 작성 방법

하나의 페이지는 여러 부분(Part)로 구분됩니다. 각 파트가 별도의 파일이라고 간주할 수 있습니다.

 

파트의 제목은 제목1(H1)으로 마크업합니다. 여기에 미리 약속한 이름(ex. Layout)을 써주면 됩니다.

파트의 내용은 코드단락(단락>소스코드)로 입력합니다. 아래는 그 예입니다.

 

  1. <HTML>
  2. {{ expression }}
  3. </HTML>

 

default 템플릿 화면을 참고하세요.

 

템플릿

템플릿은 화면에 그려질 HTML을 담고 있는 파일입니다. Liquid 템플릿 엔진을 사용하고 있으므로, 필요하다면 간단한 로직을 담을 수도 있습니다.

 

Liquid 템플릿 엔진

스프링로그는 Liquid 템플릿 엔진을 사용합니다. 관련 문법을 참조하기 바랍니다.

 

메피스토 테마를 약간의 수정을 통해 스프링로그에 사용할 수 있습니다. 따라서 메피스토의 문서나 테마 갤러리를 보는 것도 도움이 됩니다.

 

테마 제작을 위해 슬러거를 설치하는 것도 좋은 방법입니다.

 

필수 구성 요소

스프링로그의 테마는 다음 요소들을 모두 포함하고 있어야 합니다.

 

  • Layout

    • 페이지 전체 구조입니다 프레임이라고 생각하시면 됩니다.

  • Home

    • 첫 페이지입니다. 글 목록이 나타납니다.

  • Single

    • 하나의 글만을 표시합니다.

  • Search

    • 검색 화면입니다.

  • Tag

    • 태그 검색 화면입니다.

 

CSS 스타일시트

테마 메인 페이지의 하위 페이지로 'stylesheets'라는 이름의 페이지를 만들면 이 안의 내용이 스타일시트로 인식됩니다. 

 

자바스크립트

테마 메인 페이지의 하위 페이지로 'javascripts'라는 이름의 페이지를 만들면 이 안의 내용이 스타일시트로 인식됩니다.

 

이 정도는 지켜주시면 좋아요

  • XHTML 표준을 준수합니다.
  • 블로그 주소 지원 패턴을 지킵니다.
  • 스프링로그를 위한 마크업(ex. {head}, {body} 등)을 최대한 지켜줍니다.

 

FAQ

  • 스프링노트에서 테마를 바꿔도 스프링노트에 반영되지 않습니다. 사기치신건가요?

    • 성능을 위해 일정 기간동안 테마를 캐시하고 있기 때문입니다. 항상 스프링노트에서 테마를 읽어오면 로딩 속도가 느려집니다. 강제로 갱신되길 원하면 URL 맨 뒤에 ?refresh=1 을 붙여주면 됩니다. 테마 변경 중에는 이 옵션을 잊지 마세요.

  • 이미지등 필요한 정적 파일은 어떻게 올리나요?

    • 스프링노트에 업로드하고 절대 경로로 링크를 하시기 바랍니다

  • 테마를 잘못 만들어 스프링로그가 뜨지 않습니다.

    • 현재는 초기화 기능을 제공하지 않고 있습니다. 개발자에게 문의해주세요
  • ....

 

TODO

문서를 계속 보강할 예정입니다.

기본 지원 테마를 점차 늘려갈 예정입니다.

 

곧 제공할 예정인 기능입니다..

 

  • 미리보기 기능
  • 문법 검사
  • 전체 공개(다른 사람이 사용할 수 있도록)

 

Posted by deepblue

Leave a Reply

Website

Email