머리말
Jekyll 은 YAML 머리말 블록을 가진 모든 파일을 특별한 파일로 인식하여 처리합니다. 머리말은 반드시 파일의 맨 첫 부분에 위치해야 하고 시작과 끝을 대시문자 세 개로 감싸서 올바른 YAML 형식으로 작성해야 합니다. 가장 기본적인 형태의 예제가 여기 있습니다:
---
layout: post
title: Blogging Like a Hacker
---
이 대시문자 사이에 사전-정의 변수(설명은 아래를 참고하세요)를 사용할 수 있고, 심지어 자신만의 고유 변수를 정의하는 것도 가능합니다. 해당 파일은 물론 해당 페이지 또는 포스트에 연결된 레이아웃이나 조각파일에서도 Liquid 태그를 사용하여 이 변수들에 접근할 수 있습니다.
UTF-8 문자 인코딩 주의사항
인코딩으로 UTF-8 을 사용중이라면, 절대로 파일에 BOM 헤더
문자가 있으면 안됩니다. 그렇지 않으면 Jekyll 에 아주, 아주 안 좋은
일이 벌어집니다.
Jekyll 을 윈도우즈에서 사용할 때에만 발생하는 문제입니다.
머리말의 변수는 필수가 아닙니다
만약 Liquid 태그와 변수는 사용하고 싶은데 머리말에는 넣을만한 내용이 하나도 없다면, 그냥 비워두세요! 삼중 대시 행 사이에 아무 내용이 없어도, Jekyll 은 해당 파일을 처리합니다. (CSS 나 RSS 피드같은 파일에 유용합니다!)
사전-정의 전역 변수
페이지 또는 포스트의 머리말에 사용할 수 있는 다양한 사전-정의 전역 변수가 있습니다.
| 변수 | 설명 |
|---|---|
|
|
사용할 레이아웃 파일을 지정한다. 레이아웃 파일명에서 확장자를 제외한
나머지 부분만 입력한다. 레이아웃 파일은 반드시
|
|
|
생성된 블로그 포스트 URL 을 사이트 전역 스타일(기본설정:
|
|
|
사이트가 생성되었을 때 특정 포스트가 나타나지 않게 하려면 false 로 설정한다. |
미개시로 표시된 포스트 렌더링하기
미개시 페이지에 대한 미리보기는, `jekyll serve` 또는 `jekyll build` 를 `--unpublished` 스위치와 함께 실행합니다. 또한 Jekyll 에는 블로그 포스트만을 위해 특별히 제작된 초안 기능이 있어 좀 더 편리하게 사용할 수 있습니다.
사용자-정의 변수
자신만의 머리말 변수를 설정하여 Liquid 로 사용할 수도 있습니다. 예를
들어, food 라는 변수를 설정했다면, 이렇게 페이지에서 사용할 수 있습니다:
---
food: Pizza
---
<h1>{{ page.food }}</h1>
포스트의 사전-정의 변수
다음은 포스트에서 사용할 수 있는 특별한 머리말 변수들입니다.
| 변수 | 설명 |
|---|---|
|
|
여기에 지정한 날짜가 포스트 이름에 있는 날짜보다 더 우선순위가 높다.
포스트를 올바르게 정렬하기 위해 사용할 수 있는 기능이다. 날짜 형식은
|
|
|
포스트를 폴더 안에 넣는 대신, 포스트에 하나 또는 여러 개의 카테고리를 지정할 수도 있다. 사이트 생성 작업 중에 이 포스트들은 보통 방식으로 카테고리가 할당된 것과 동일하게 작동한다. 카테고리들(복수형)은 YAML 목록 또는 공백으로 구분된 문자열로 정의한다. |
|
|
카테고리와 비슷하게, 하나 또는 여러 개의 태그를 포스트에 추가할 수 있다. 또한 카테고리처럼, 태그는 YAML 목록 또는 공백으로 구분된 문자열로 정의한다. |
같은 일을 반복하지 마세요
자주 사용하는 머리말 변수를 계속 반복해서 입력하고 싶지 않으면, 해당 변수에 대해 디폴트 값을 정의하고, 필요한 곳에서만 다른 값으로 덮어쓰세요. 사전-정의 변수와 사용자-정의 변수 모두 이 방법을 적용할 수 있습니다.