본문으로 건너뛰기

Jekyll 시작하기

Quickstart

Jekyll Docs의 Getting Started를 읽고 시도해본 기록.


빠른 시작#


Jekyll은 정적 사이트 생성기.

Markdown, HTML 등 원하는 markup language로 static한 웹사이트를 만들 수 있다.

URL의 모습과 사이트에 데이터를 원하는 대로 표시할 수 있다.


선수 조건#

Installation


Instructions#

  1. 루비 개발 환경 설치하기

  2. Jekyll과 bundler gems 설치하기

    gem install jekyll bundler
  3. 새 Jekyll site 생성하기  ./myblog

    jekyll new myblog
  4. 생성한 Jekyll site 디렉토리로 이동

    cd myblog
  5. 사이트를 빌드하고 로컬 서버로 접속 가능하게 만들기

    bundle exec jekyll serve
  6. http://localhost:4000 주소로 접속하기


Ruby101#


Jekyll은 Ruby로 작성되었다.


Gems#

gem은 Ruby 프로젝트에 포함시킬 수 있는 코드이다.

gem은 Ruby 프로젝트의 기능을 패키지하고 다른 프로젝트나 다른 사람들과 공유할 수있도록 해준다.

gem은 다음과 같은 기능을 수행할 수 있다.

  • Ruby 객체를 JSON으로 변환

  • Pagination (쪽수 매기기) ?

  • Github 같은 API와의 상호작용

  • Jekyll 자체 역시 gem이고, jekyll-feed, jekyll-seo-tag, jekyll-archives와 같은 Jekyll 플러그인들 또한 gem이다.


Gemfile#

Gemfile은 사이트에 필요한 gems의 리스트를 기록해놓은 파일이다. 단순한 Jekyll site라면

source "https://rubygems.org"
gem "jekyll"
group :jekyll_plugins do  gem "jekyll-feed"  gem "jekyll-seo-tag"end

Bundler#

아직 이해하지 못했다.

Bundler installs the gems in your Gemfile. It’s not a requirement for you to use a Gemfile and bundler however it’s highly recommended as it ensures you’re running the same version of Jekyll and Jekyll plugins across different environments.

gem install bundler installs Bundler. You only need to install it once — not every time you create a new Jekyll project. Here are some additional details:

If you’re using a Gemfile you would first run bundle install to install the gems, then bundle exec jekyll serve to build your site. This guarantees you’re using the gem versions set in the Gemfile. If you’re not using a Gemfile you can just run jekyll serve.

For more information about how to use Bundler in your Jekyll project, this tutorial should provide answers to the most common questions and explain how to get up and running quickly.

Using Jekyll with Bundler


Jekyll 커뮤니티#


Jekyll 프로젝트에 Contribute 할 수 있는 방법과 문서 모음, Jekyller들과 대화할 수있는 커뮤니티 모음들이다.

Community