github.io 만들기 01 - gitpages with jekyll 환경설정

블로그를 워드프레스에서 깃허브로 옮기기로 했다.
깃허브가 가지고 있는 이슈는 뒤로하고 워드프레스만 계속 쓰다가 안주하는 느낌이 강해져서 게으름을 피하기 위해서,
그리고 무엇보다 많이들 쓰니깐 뭔지 해보고 싶어졌다.

다행히 깃허브 페이지 자체를 만드는 것은 너무나 쉽다.
그러나 문제는 jekyll 를 셋팅하는게 꽤 힘들었는데, 가이드 대로 찬찬히 따라오는데 에러가 계속 떴다.
어? 이 에러만 고치면 될 것 같은 느낌 만으로 1주일을 썼다.
그래..원래 웹 개발은 환경셋팅만 1주일 아닌가? 늘 겪던 건데 뭐~라는 마음을 먹었지만,
시작은 언제하나 답답해 죽는 줄 알았다.

다행스럽게도 환경 셋팅이 되었고, 남은 것은 기존 블로그 이관과 jekyll이해하기.
그 전에 셋팅 하면서 고군분투 했던 여러가지 에러들을 정리해 보았다.
먼저 Ruby Gem이 설치되어 어야 한다.
macOS를 라면 당연히 ruby gem 설치는 되지 않는다.

https://jekyllrb.com/docs/installation/
https://jekyllrb.com/docs/installation/macos/

위 링크에 따라 jekyll 설치 가이드에서 보면
mac OS Mojave 10.14 와 ruby 2.3.x 가 있어야 Homebrew를 통해 Ruby가 설치 가능하다고 한다.
설치 하다 보면 중간중간에 풀리지 않는 에러들이 수도 없이 나오는데알고 보니 버전 문제였다.

약간 이런 종류의 해결할 수 없는 에러들떴는데,

Make sure that `gem install ffi -v ‘1.10.0’ –source ‘https://rubygems.org/’`succeeds before bundling.

아무리 구글링을 해도 알 수 없었다.

******정리
1. command line tool 10.0 이상이 필요하다.
2. Xcode – preferences 에서 버전 확인 가능한데 하위버전일 경우 반드시 업데이트 해주어야한다.
3. Xcode 10.0은 mac OS 10.4 Mojave 이상일 경우에만 업데이트가 가능하니 하위 버전일 경우 mac OS부터 업데이트 해줘야하는 큰산..내가 그 경우..
분명 커맨드에서 저 명령어를 쳤을때에는 딱히 오류가 생기지는 않으나 나중에 끝도 없이 에러나온다.
그냥 업데이트 해주고 시작하는게 편하다.
=> 결론 mac OS Mojave 10.14 이상 , Xcode 10.0 이상 의 버전을 준비하고 시작하는게 문제 없다.
******

그리고.. 시작이다.

위에 셋팅이 문제 없이 흘러가다가

gem install bundler jekyll

에서 에러를 만났다.

ERROR: While executing gem … (Gem::FilePermissionError)
You don’t have write permissions for the /Library/Ruby/Gems/2.3.0 directory.
mac OS 엘케피탄 이후의 버전에서 반드시 sudo로 root권한을 주어야 가능

명령어 앞에 sudo 붙여줘서 권한주기
sudogem install bundler

jekyll 설치하기
https://jekyllrb.com/docs/

jekyll serve 구동 시키고 웹 브라우저에서
http://localhost:4000실행시키기

(+추가)

You must use Bundler 2 or greater with this lockfile.
update RubyGems

설치시 이런 메시지가 뜬다면

gem update —system

아래와 같은 메시지가 뜬다면 skip

Latest version already installed. Done.