번역 / 교정

환경설정 옵션

다음 표는 Jekyll 에서 사용할 수 있는 환경설정과 그에 해당하는 옵션 (설정 파일에 사용) 과 플래그 (명령어에 사용) 의 목록입니다.

전역 환경설정

설정	옵션과 플래그
Site Source Jekyll 이 읽어들일 파일의 경로를 변경한다.	source: DIR -s, --source DIR
Site Destination Jekyll 이 생성할 파일의 경로를 변경한다.	destination: DIR -d, --destination DIR
Safe 사용자 플러그인을 비활성화하고 디스크에 캐쉬하며, 심볼릭 링크를 무시한다.	safe: BOOL --safe
Disable Disk Cache 4.1.0 Disable caching of content to disk in order to skip creating a .jekyll-cache or similar directory at the source to avoid interference with virtual environments and third-party directory watchers. Caching to disk is always disabled in safe mode.	disable_disk_cache: BOOL --disable-disk-cache
Exclude 특정 디렉토리나 파일을 변환되지 않도록 제외시킨다. Site Source 를 기준으로 한 상대경로로 정의하며, Site Source 디렉토리 바깥의 다른 경로는 지정할 수 없다.	exclude: [DIR, FILE, ...]
Include 특정 디렉토리나 파일을 변환 작업에 강제로 포함시킨다. 대표적인 예로는 .htaccess 가 있는데, 점으로 시작하는 파일은 제외하는 것이 디폴트 방식이기 때문이다.	include: [DIR, FILE, ...]
Keep files 사이트 생성 전 Site Destination 을 초기화 때, 그대로 보관할 파일을 지정한다. Jekyll 이 아닌 다른 빌드 시스템에서 생성하는 파일이나 데이터에 유용하게 쓰이는 옵션이다. destination 기준의 상대경로로 입력한다.	keep_files: [DIR, FILE, ...]
Time Zone 사이트 생성에 사용할 타임존을 지정한다. 이 옵션은 루비가 날짜와 시간을 생성/수정할 때 사용하는 환경변수인 TZ 를 설정한다. IANA 타임존 데이터베이스의 모든 항목을 사용할 수 있다 (예, America/New_York). 사용할 수 있는 모든 설정값들의 목록은 여기에서 찾을 수 있다. 로컬 장비에서 서비스 될 때, 타임존의 기본값은 자신의 OS 에 의해 설정된다. 하지만 원격 호스트/서버에서 서비스될 때, 타임존 기본값은 서버 환경설정이나 장소에 따라 다르다.	timezone: TIMEZONE
Encoding 파일의 인코딩을 지정한다. 루비 1.9 또는 이후 버전에서만 사용 가능하다). 디폴트값은 2.0.0 버전부터 utf-8 이고, 2.0.0 이전 버전에서는 루비 디폴트값인 ASCII-8BIT 를 사용하는 nil 이었다. 사용할 수 있는 인코딩 목록을 확인하는 명령어는 ruby -e 'puts Encoding::list.join("\n")' 이다.	encoding: ENCODING
Defaults 머리말 변수의 디폴트 값을 설정한다.	아래 내용 참조

Site Destination 폴더는 사이트 빌드 시 초기화됩니다

사이트 빌드 시에 자동으로 <destination> 안의 파일을 지우는 것이 디폴트로 설정되어 있습니다. 사이트에서 생성하지 않는 파일은 모두 사라질 것입니다. 환경설정 옵션 <keep_files> 를 사용해 그대로 옮길 파일들을 지정할 수 있습니다.

빌드 명령어 옵션

설정	옵션과 플래그
Regeneration 파일이 수정되었을 때 사이트를 자동으로 다시 생성한다.	-w, --[no-]watch
Configuration _config.yml 대신 사용할 환경설정 파일을 직접 선택한다. 여러 파일에 동일한 옵션이 설정되어 있으면, 마지막 설정파일의 내용을 사용한다.	--config FILE1[,FILE2,...]
Drafts 초안 기능을 사용한다.	show_drafts: BOOL --drafts
Environment 빌드 시 임의의 환경변수 값을 사용한다.	JEKYLL_ENV=production
Future 현재시간 이후의 포스트나 컬렉션 문서를 게시한다.	future: BOOL --future
Unpublished 미개시로 지정된 포스트를 처리한다.	unpublished: BOOL --unpublished
LSI 관련된 포스트들에 대한 인덱스를 생성한다. classifier-reborn 플러그인이 필요하다.	lsi: BOOL --lsi
Limit Posts 포스트의 수를 제한한다.	limit_posts: NUM --limit_posts NUM
Force polling 감시 기능을 강제로 활성화한다.	force_polling: BOOL --force_polling
Verbose output 결과를 자세하게 출력한다.	-V, --verbose
Silence Output 사이트 빌드 시 발생하는 일반 메시지를 출력하지 않는다	-q, --quiet
Incremental build 실험 기능인 증분 빌드를 활성화한다. 증분 빌드란 변경된 페이지나 포스트만을 다시 빌드하는 기능으로서, 규모가 큰 사이트에서 눈에 띄는 성능 향상을 가져올 수 있다. 하지만 특정한 상황에서는 사이트 생성에 문제가 생길 수도 있다.	incremental: BOOL -I, --incremental
Liquid profiler 병목현상이 발생하는 원인을 찾을 수 있게 도와주는 Liquid 렌더링 프로파일을 생성한다.	profile: BOOL --profile
Strict Front Matter 페이지의 머리말에 YAML 문법 에러가 있으면 빌드를 중단한다.	strict_front_matter: BOOL --strict_front_matter
Base URL 주어진 URL 로 웹사이트를 작동시킨다.	baseurl: URL --baseurl URL

미리보기 명령 옵션

serve 명령은 아래 나열된 옵션 뿐만 아니라 build 명령의 옵션도 사용할 수 있습니다. 먼저 build 작업에 해당 옵션이 사용된 후에 serve 작업이 수행됩니다.

설정	옵션과 플래그
Local Server Port Listen 포트 번호를 설정한다.	port: PORT --port PORT
Local Server Hostname Listen 호스트명을 설정한다.	host: HOSTNAME --host HOSTNAME
Live Reload 컨텐츠가 수정되었을 때 자동으로 브라우저에서 페이지를 다시 불러온다.	livereload: true -l, --livereload
Detach 터미널에서 서버를 분리한다.	detach: BOOL -B, --detach
Skips the initial site build 사이트 빌드를 건너뛰고 서버를 실행한다	--skip-initial-build
X.509 (SSL) Private Key 사이트 코드에 포함되어 있거나 심볼릭 링크되어 있는 SSL 개인 키.	--ssl-key
X.509 (SSL) Certificate 사이트 코드에 포함되어 있거나 심볼릭 링크되어 있는 SSL 공인 인증서.	--ssl-cert

환경설정 파일에 탭 문자를 사용하지 마세요

파싱 에러가 발생하거나 기본 설정값이 사용될 것입니다. 대신 띄어쓰기를 사용하세요.