jekyll 이란?

Jekyll 은 아주 심플하고 블로그 지향적인 정적 사이트 생성기입니다.

텍스트 마크다운 파일로 컨텐츠를 작성하고, 폴더로 그 파일들을 정리합니다.
다음, Liquid 기능이 추가된 HTML 템플릿을 사용해 사이트의 모양을 만듭니다.
Jekyll 은 자동으로 내용물과 템플릿들을 함께 합쳐서, 어떤 서버에서도 올바르게 작동하는, 완전한 정적 웹사이트를 생성합니다.

Jekyll 은 GitHub Pages 의 내부 엔진이기 때문에, 당신의 프로젝트에 있는 Jekyll 페이지/블로그/웹사이트를 GitHub 서버에 무료로 호스팅 할 수 있습니다.

윈도우즈에서 jekyll 설치

1. 루비 (Ruby) 설치

RubyInstaller 다운로드 페이지에서 Ruby+Devkit 버전을 다운로드 받아 설치하세요.

2. 지킬 (Jekyll) 설치하기

Start Command Prompt with Ruby를 실행합니다. Jekyll 과 Bundler 를 설치합니다

# RubyGems 를 통해 Jekyll 과 Bundler 를 설치한다
gem install bundler jekyll

Jekyll 이 올바르게 설치되었는지 확인합니다

jekyll -v

3. 로컬에서 간단한 테마 만들어 테스트하기

  1. 테스트할 디렉토리를 만들고, 그 디렉토리에 index.html파일을 만듭니다.
  2. 지킬을 실행합니다. 개발서버가 실행됩니다. http://localhost:4000/
jekyll serve


jekyll 한국어 사이트
Jekyll 윈도우에서 지킬 설치 및 블로그 생성하기



루비젬 기반 테마 gem-based -themes 설치하기

Jekyll 3.2 버전부터는 새로 젬 기반 테마(gem-based theme)라는 개념이 도입되었습니다.
이 개념이 나오기 전까지는 Jekyll에서 다른 사람이 만든 테마를 가져다 쓰려면 프로젝트 디렉터리에 테마 파일 전체를 복사해 넣고 수정하는 방식으로 테마를 관리하는 방법 밖에 없었습니다.

젬 기반 테마의 경우, 테마 파일이 루비 젬(gem) 패키지 파일 형태로 배포되기 때문에 이 테마를 가져다 쓸 사람들은 일일이 복사하여 넣을 필요 없이 루비 젬 설치 명령으로 해당 테마 파일을 설치하면 바로 테마가 작동합니다.

기본 사이트 생성(Minima)

새 Jekyll 사이트를 생성하면 (jekyll new <PATH> 명령 사용), Jekyll 은 [Minima] (https://github.com/jekyll/minima) 라고 하는 루비 젬 기반 테마가 적용된 사이트를 생성합니다.

# ./myblog 에 새 Jekyll 사이트를 생성한다
jekyll new myblog
# 생성된 디렉토리로 이동한다
cd myblog
# 미리보기 서버로 사이트를 빌드한다
bundle exec jekyll serve
# => 이제 브라우저로 http://localhost:4000 에 접속한다


Windows에서 Jekyll 실행 시 CP 949 에러대처

Jekyll: GitHub Pages 에 블로그 만들기