Jekyll은 무엇일까?

Jekyll은 Ruby로 만들어진 정적 사이트 생성기(Static Site Generator)이고, Ruby의 패키지인 Gem을 사용하여 설치할 수 있습니다.

블로그 자료를 github에 등록할 수 있는 소식을 듣고 로컬에 Jekyll 을 설치해보려고 시도를 했으나, 수없이 실패했던 사유와 회고록을 작성해보려고 합니다. Jekyll 을 설치하기 전에 Ruby가 설치되어 있어야 합니다. 

https://abbo.tistory.com/143

Ruby를 설치해보자

---

1. Install Command Line 

개발자들 중 커맨드 라인을 사용하시거나, XCode를 설치하신 개발자는 이 부분을 패스하셔도 됩니다. 기본적으로 커맨드 라인을 사용하기 위해 설치하는 도구입니다.

$ xcode-select --install

## 이미 기존에 설치되어 있는 사용자의 경우 삭제 방법
$ sudo rm -rf /Library/Developer/CommandLineTools

## 최신의 xcode-select 로 업데이트 할 때
$ updatesoftware xcode-select

 

2. Install Jekyll

위의 CLI 툴이 설치가 되었다면 Gem 명령어를 사용할 수 있습니다. gem 의 명령어는 Ruby에서 제공해주는 패키지 매니저이며 아래 명령어를 통해 bundler와 jekyll 패키지를 설치하려고 합니다. 안되시는 경우 권한의 문제가 있다보니 sudo 를 앞에 붙여서 사용하시면 됩니다.

$ gem install bundler jekyll

 

3. Install rbenv 

rbenv 는 루비의 환경설정을 관리하는 도구이며 Homebrew를 통해 설치가 가능합니다. Homebrew가 아직 설치 안되신 분들은 이 글을 참고해주시면 감사하겠습니다.

https://abbo.tistory.com/124

macOS 터미널 Homebrew 세팅

## Homebrew 에 등록된 소스 파일들을 갱신합니다.
$ brew update

$ brew install rbenv ruby-build

 

4. Jekyll Serve

여기서 상당히 많은 시간이 걸리게 되었는데 Jekyll을 서버로 구동시키는 과정입니다. 명령어는 아래와 같습니다. 

 ➜ ~ jekyll serve              
Configuration file: none
            Source: /Users/jypark
       Destination: /Users/jypark/_site
 Incremental build: disabled. Enable with --incremental
      Generating... 
                    ------------------------------------------------
      Jekyll 4.2.0   Please append `--trace` to the `serve` command 
                     for any additional information or backtrace. 
                    ------------------------------------------------

사유는 Jekyll 프로젝트를 생성을 하지 않았기 때문에 Gemfile 이 생성이 안되었다고 뜨는 것이었습니다.

 ➜ ~ bundle exec jekyll serve
Could not locate Gemfile or .bundle/ directory

 

5. Create new Jekyll project

## 아래 부분 jekyllname에 github 계정을 적어주는 것이 좋습니다.
$ jekyll new #{jekyllname}

 ➜ ~ jekyll new jyp90
Running bundle install in /Users/jypark/jyp90... 


Your user account isn't allowed to install to the system RubyGems.
  You can cancel this installation and run:

      bundle config set --local path 'vendor/bundle'
      bundle install

  to install the gems into ./vendor/bundle/, or you can enter your password
  and install the bundled gems to RubyGems using sudo.

  Password: 
  Bundler: Fetching gem metadata from https://rubygems.org/..........
  Bundler: Resolving dependencies...
  Bundler: Using public_suffix 4.0.6
  Bundler: Using bundler 2.2.16
  Bundler: Using colorator 1.1.0
  Bundler: Using concurrent-ruby 1.1.8
  Bundler: Using eventmachine 1.2.7
  Bundler: Using http_parser.rb 0.6.0
  Bundler: Using ffi 1.15.0
  Bundler: Using forwardable-extended 2.6.0
  Bundler: Using rb-fsevent 0.10.4
  Bundler: Using liquid 4.0.3
  Bundler: Using mercenary 0.4.0
  Bundler: Using rouge 3.26.0
  Bundler: Using safe_yaml 1.0.5
  Bundler: Using unicode-display_width 1.7.0
  Bundler: Using sassc 2.4.0
  Bundler: Using rb-inotify 0.10.1
  Bundler: Using pathutil 0.16.2
  Bundler: Using terminal-table 2.0.0
  Bundler: Using jekyll-sass-converter 2.1.0
  Bundler: Using addressable 2.7.0
  Bundler: Fetching rexml 3.2.5
  Bundler: Using i18n 1.8.10
  Bundler: Using listen 3.5.1
  Bundler: Using jekyll-watch 2.2.1
  Bundler: Using em-websocket 0.5.2
  Bundler: Installing rexml 3.2.5
  Bundler: Using kramdown 2.3.1
  Bundler: Using kramdown-parser-gfm 1.1.0
  Bundler: Using jekyll 4.2.0
  Bundler: Fetching jekyll-feed 0.15.1
  Bundler: Fetching jekyll-seo-tag 2.7.1
  Bundler: Installing jekyll-feed 0.15.1
  Bundler: Installing jekyll-seo-tag 2.7.1
  Bundler: Fetching minima 2.5.1
  Bundler: Installing minima 2.5.1
  Bundler: Bundle complete! 6 Gemfile dependencies, 31 gems now installed.
  Bundler: Use `bundle info [gemname]` to see where a bundled gem is installed.Following files may not be writable, so sudo is needed:
  Bundler: /Library/Ruby/Gems/2.6.0
  Bundler: /Library/Ruby/Gems/2.6.0/build_info
  Bundler: /Library/Ruby/Gems/2.6.0/cache
  Bundler: /Library/Ruby/Gems/2.6.0/doc
  Bundler: /Library/Ruby/Gems/2.6.0/extensions
  Bundler: /Library/Ruby/Gems/2.6.0/gems
  Bundler: /Library/Ruby/Gems/2.6.0/specifications
New jekyll site installed in /Users/jypark/jyp90. 

 

6. Install webrick

이제 새로 생성한 Jekyll을 Web으로 띄울 준비를 하기위한 webrick을 설치합니다.

$ bundle add webrick

 

7. Execute Jekyll

마지막으로 Jekyll 을 실행시키는 방법으로 기본 포트 4000번에 작동됩니다. 

$ cd jyp90
jyp90 $ jekyll serve 
Configuration file: /Users/jypark/jyp90/_config.yml
            Source: /Users/jypark/jyp90
       Destination: /Users/jypark/jyp90/_site
 Incremental build: disabled. Enable with --incremental
      Generating... 
       Jekyll Feed: Generating feed for posts
                    done in 0.275 seconds.
 Auto-regeneration: enabled for '/Users/jypark/jyp90'
    Server address: http://127.0.0.1:4000/
  Server running... press ctrl-c to stop.

 

Result

이제 홈페이지도 출력되었으니 테마도 입히고 차근차근히 글도 올려보아야겠습니다...!!!!!