GitHub 블로그 Minimal-mistakes 설정하기 :: MAC

깃블로그(Git Pages) 만들려다가 우여곡절을 겪어서.. 기록해둔다.

 

 

1. GitHub 블로그 만들기

Create repository > gitID.github.io 로 Repository name을 지정하여 생성한다.

 

 

2. minimal-mistakes Fork

github.com/mmistakes/minimal-mistakes

다운로드해도 상관없고 포크해도 상관없다. 포크했을 경우 Repository name을 자신의 GitHub Pages url로 변경해주어야한다.

 

 

3. Ruby 설치하기

1 ) Hombrew 설치하기

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

👆🏻 터미널 복붙

 

 

2 ) Ruby 설치하기

처음에 brew install ruby 했더니 gem install jekyll bundler 실행 시 아래와 같은 오류가 발생했다. rbenv로 설치하면 된다해서 삭제 후 재설치하였다.

ERROR:  While executing gem ... (Gem::FilePermissionError)

    You don't have write permissions for the /Library/Ruby/Gems/2.6.0 directory.

 

brew install rbenv ruby-build

rbenv install 2.6.5

rbenv global 2.6.5

👆🏻 순서대로 터미널 복붙

 

vi ~/.zshrc

👆🏻 터미널 복붙

 

 

.zshrc파일에 아래를 붙여넣고 :wq를 입력한다.

export PATH={$Home}/.rbenv/bin:$PATH && \
eval "$(rbenv init -)"

👆🏻 터미널 복붙하고 :wq 입력 & 엔터

 

 

터미널을 재실행 하거나 아래 명령어를 실행한다.

source ~/.zshrc

👆🏻 터미널 복붙

 

 

4. Ruby bundler설치

gem install bundler

👆🏻 터미널 복붙

 

 

 

5. jekyll 설치 & 실행

(github.io repository를 git clone한 상태에서 진행)

bundle install

bundle exec jekyll serve

👆🏻 순서대로 터미널 복붙

 

 

이때 아래 에러가 발생했는데 Gemfile에 gem "kramdown-parser-gfm" 를 추가하니 정상적으로 작동했다.

Dependency Error: Yikes! It looks like you don't have kramdown-parser-gfm or one of its dependencies installed. In order to use Jekyll as currently configured, you'll need to install this gem. The full error message from Ruby is: 'cannot load such file -- kramdown-parser-gfm' If you run into trouble, you can find helpful resources at https://jekyllrb.com/help/! 

  Liquid Exception: kramdown-parser-gfm in /_layouts/archive.html

             ERROR: YOUR SITE COULD NOT BE BUILT:

                    ------------------------------------

                    kramdown-parser-gfm

 

혹은

 

[!] There was an error parsing `Gemfile`: There are no gemspecs at /Users/mizykk/Desktop/mizykk.github.io. Bundler cannot continue.

 

 

참고 :: 나의 Gemfile

source "https://rubygems.org"

gem "jekyll"
gem "minimal-mistakes-jekyll", :github => "mmistakes/minimal-mistakes"
gem "kramdown-parser-gfm"

 

 

6. localhost에서 실행

http://localhost:4000/

 

 

7. _config.yml 수정