Nizbridge

UI Developer

Navigation
 » Blog
 » About Me
 » Projects
 » Github
 » Bookmark
 » XML Feed

Jekyll을 활용한 GitHub 블로그 만들기 (Window)

16 Aug 2016 » all, etc

얼마전에 지킬을 설치하면서 제대로 잘 되지를 않아 고생했었는데요,

그래서 간단하게 설치 방법을 적어보고자 합니다.

아래 순서대로 설치를 진행한다면 어렵지 않게 지킬을 세팅하고 블로그를 운영하실 수 있습니다!


ruby

  • 가급적 2.2 버전대로 설치하는게 안정적입니다.
  • 설치 중 Add Ruby executables to your PATH 옵션을 선택하여 설치하도록 합니다.

rubydevkit

  • rubydevkit을 다운받은 후에 임의의 폴더 생성 후 압출을 풀어줍니다. (저는 rubydevkit 이란 폴더르 만들었습니다.)
  • 압축을 푼 폴더에서 console로 ruby dk.rb init 를 실행합니다.
  • 그리고 ruby dk.rb install 를 실행합니다.
  • 이때 만약 아래와 같은 에러 메세지가 나온다면, config.yml 을 수정해줘야 합니다.
Invalid configuration or no Rubies listed. Please fix 'config.yml'
and rerun 'ruby dk.rb install'
  • config.yml 파일을 열면 아래와 같이 되어있을텐데요.
# This configuration file contains the absolute path locations of all
# installed Rubies to be enhanced to work with the DevKit. This config
# file is generated by the 'ruby dk.rb init' step and may be modified
# before running the 'ruby dk.rb install' step. To include any installed
# Rubies that were not automagically discovered, simply add a line below
# the triple hyphens with the absolute path to the Ruby root directory.
#
# Example:
#
# ---
# - C:/ruby19trunk
# - C:/ruby192dev
#
---
  • ruby가 설치된 경로로 수정을 해줍니다. 저는 아래와 같이 수정했습니다.
# This configuration file contains the absolute path locations of all
# installed Rubies to be enhanced to work with the DevKit. This config
# file is generated by the 'ruby dk.rb init' step and may be modified
# before running the 'ruby dk.rb install' step. To include any installed
# Rubies that were not automagically discovered, simply add a line below
# the triple hyphens with the absolute path to the Ruby root directory.
#
# Example:
#
# ---
# - C:/ruby19trunk
# - C:/ruby192dev
#
---
- C:/Ruby21-x64
  • 그리고 다시 ruby dk.rb install 를 실행합니다.

bundler

  • console에서 gem install bundler 를 실행하여 bundler를 설치해줍니다.

python

  • 지킬의 syntax highlighter인 pygments를 설치하기 위해서는 python을 먼저 설치해야 합니다.
  • python은 2.7.x 버전으로 설치해줍니다.
  • 설치후에 console의 모든 경로에서 python을 실행해주기 위해 윈도우 환경 변수를 추가해줍니다.
  • 내컴퓨터>속성>고급시스템 설정>고급>환경변수에서 Path 부분에 아래 경로를 추가합니다.
  • C:\Python27;C:\Python27\Scripts;C:\Python27\Lib\site-packages

pygments

  • console에서 easy_install Pygments를 실행하여 pygments를 설치합니다.

jekyll

  • console에서 gem install jekyll를 실행하여 지킬을 설치합니다.

테마 적용

  • 자신이 사용할 테마를 다운받은 후에 해당 폴더에서 bundle install를 실행하여 필요한 gem들을 설치합니다.
  • 설치가 완료되면 gem update를 실행합니다.

서버 구동

  • 모든 설치가 완료되면 테마폴더에서 bundle exec jekyll serve를 실행합니다.
  • 블로그 접속주소는 ‘localhost:4000’ 입니다.

github에 올리기

  • 로컬에서 블로그가 정상적으로 작동된다면, 이제 github에 올릴차례입니다.
  • 계정명.github.io 로 저장소를 하나 만들어 줍니다.
  • 해당 저장소로 블로그폴더를 push 한 후 http://계정명.github.io로 접속시 정상적으로 블로그가 보인다면 성공!

지킬에 대한 보다 자세한 내용을 jekyllrb-ko.github.io에서 확인가능합니다.