번역 / 교정

고유주소

고유주소는 페이지나 포스트, 컬렉션의 결과물 경로입니다. 이는 소스코드의 디렉토리 구조를 결과물 디렉토리와 다르게 구성할 수 있도록 해줍니다.

머리말

고유주소를 설정하는 가장 간단한 방법은 머리말을 사용하는 것입니다. 머리말에 permalink 변수를 설정해 원하는 결과물 경로를 지정합니다.

예를 들어, 페이지 소스 코드의 경로가 /my_pages/about-me.html 이고 url 을 /about/ 으로 만드려고 합니다. 페이지의 머리말에 다음과 같이 설정합니다:

---
permalink: /about/
---

글로벌

소스 코드의 모든 페이지에 머리말로 고유주소를 설정하는 것은 즐겁지 않습니다. 다행하게도, Jekyll 은 _config.yml 에 글로벌 고유주소 구조를 설정할 수 있게 해줍니다.

글로벌 고유주소를 설정하려면, _config.yml 에 permalink 변수를 사용합니다. Placeholder 를 사용할 수 있습니다. 예를 들면:

permalink: /:categories/:year/:month/:day/:title:output_ext

페이지와 컬렉션 (posts 와 drafts 제외) 은 시간과 카테고리 정보가 없어서 (페이지에서, 위 :title 에 상응하는 것은 :basename 이다), 이러한 내용들은 결과물에서 무시됩니다.

예를 들어, posts 컬렉션의 고유주소 스타일이 /:categories/:year/:month/:day/:title:output_ext 일 때, 페이지와 컬렉션 (posts 와 drafts 제외) 에서는 /:title.html 이 됩니다.

Placeholders

다음은 사용할 수 있는 Placeholder 의 전체 목록입니다:

변수	설명
year	포스트 파일명 날짜의 연도 전체 네 자리. 머리말의 date 를 통해 값을 덮어쓸 수 있다.
short_year	포스트 파일명 날짜의 연도 끝 두 자리. (00..99) 머리말의 date 를 통해 값을 덮어쓸 수 있다.
month	포스트 파일명 날짜의 월. (01..12) 머리말의 date 를 통해 값을 덮어쓸 수 있다.
i_month	포스트 파일명 날짜의 월. 자리수 채우기 없음. 머리말의 date 를 통해 값을 덮어쓸 수 있다.
short_month	세 자리 월 축약형. 예시, “Jan”.
long_month 4.0	전체 월. 예시, “January”.
day	포스트 파일명 날짜의 일. (01..31) 머리말의 date 를 통해 값을 덮어쓸 수 있다.
i_day	포스트 파일명 날짜의 일. 자리수 채우기 없음. 머리말의 date 를 통해 값을 덮어쓸 수 있다.
y_day	포스트 파일명 날짜의 서수일. 자리수 채우기 포함. (001..366)
w_year 4.0	Week year which may differ from the month year for up to three days at the start of January and end of December
week 4.0	Week number of the current year, starting with the first week having a majority of its days in January. (01..53)
w_day 4.0	숫자로 표현된 요일. 월요일부터 시작. (1..7)
short_day 4.0	세 자리 요일 축약형. 예시, “Sun”.
long_day 4.0	요일명. 예시, “Sunday”.
hour	포스트 머리말 date 의 24 시간제, 두 자리 형식 시간값. (00..23)
minute	포스트 머리말 date 의 분값. (00..59)
second	포스트 머리말 date 의 초값. (00..59)
title	파일명에 명시된 문서의 제목. 머리말의 slug 를 통해 값을 덮어쓸 수 있다.
slug	파일명에 명시된 문서 제목의 슬러그화 결과 (숫자와 글자가 아닌 모든 문자를 하이픈으로 변경함). 머리말의 slug 로 값을 덮어쓸 수 있다.
categories	해당 포스트에 지정된 카테고리들. 만약 포스트가 여러 카테고리에 속해있다면, 계층 구조로 URL 이 생성된다 (예시. /category1/category2). 또한, Jekyll 은 URL 을 분석해서 연속된 슬래시를 자동으로 제거하기 때문에, 카테고리가 하나도 없으면, Jekyll 은 이 변수를 무시한다.

기본 제공 형식

편의를 위해 Jekyll 은 포스트에 사용할 수 있는 내장된 스타일을 제공합니다:

고유주소 스타일	URL 템플릿
date	/:categories/:year/:month/:day/:title:output_ext
pretty	/:categories/:year/:month/:day/:title/
ordinal	/:categories/:year/:y_day/:title:output_ext
weekdate 4.0	/:categories/:year/W:week/:short_day/:title:output_ext
none	/:categories/:title:output_ext

permalink: /:categories/:year/:month/:day/:title/ 가 아니라, 그냥 permalink: pretty 라고 입력해도 된다.

머리말에서 고유주소 사용

내장된 고유주소 스타일은 머리말에서는 인식되지 않습니다. 따라서, permalink: pretty 는 작동하지 않을 것입니다.

컬렉션

컬렉션 (posts 와 drafts 포함) 의 경우, _config.yml 에 설정된 컬렉션 환경설정의 글로벌 고유주소를 덮어쓸 수 있는 방법이 있습니다:

collections:
  my_collection:
    output: true
    permalink: /:collection/:name

컬렉션에서 사용할 수 있는 Placeholder 는 다음과 같습니다:

변수	설명
:collection	컬렉션의 레이블.
:path	컬렉션 디렉토리에 따른, 파일명을 포함한 문서의 경로
:name	모든 공백과 비-알파벳 문자를 하이픈으로 교체한 문서의 파일명.
:title	만약 문서의 머리말에 slug 가 있다면, :title 템플릿 변수는 이 값을 사용한다; 만약 존재하지 않으면 :title 는 :name 와 동일하며, 슬러그는 파일명으로부터 생성된다.
:output_ext	결과물 파일의 확장자. (기본적으로 포함되어 있으며 보통 불필요하다.)

페이지

페이지에서는, 글로벌 고유주소를 덮어쓰려면 머리말을 사용해야만 합니다. 그리고 _config.yml 에 머리말 기본값이 설정된 상태에서는 무시됩니다.

페이지에서 사용할 수 있는 Placeholder 는 다음과 같습니다:

변수	설명
:path	사이트 소스 디렉토리에서의 파일명을 제외한 페이지 경로
:basename	페이지의 파일명
:output_ext	결과물 파일의 확장자. (기본적으로 포함되어 있으며 보통 불필요하다.)