Basic of jekyll

14 Jun 2018 in Linux programing on jekyll

jekyll를 사용하면서 적용한 내용들.

Table contents

Jekyll installation

Jekyll installation

RVM&Ruby install

만약 OSX사용자시면, ruby가 깔려있습니다. 혹 모르니 brew install ruby 해주세요.

$ gpg --keyserver hkp://keys.gnupg.net --recv-keys 409B6B1796C275462A1703113804BB82D39DC0E3 7D2BAF1CF37B13E2069D6956105BD0E739499BDB
$ cd /tmp
$ curl -sSL https://get.rvm.io -o rvm.sh
$ less /tmp/rvm.sh
$ cat /tmp/rvm.sh | bash -s stable --rails
#여기서 에러 발생
#NOTE: GPG version 2.1.17 have a bug which cause failures during fetching keys from remote server. Please downgrade or upgrade to newer version (if available) or use the second method described above.
#GPG signature verification failed for '/home/codex/.rvm/archives/rvm-1.29.3.tgz' - 'https://github.com/rvm/rvm/releases/download/1.29.3/1.29.3.tar.gz.asc'! Try to install GPG v2 and then fetch the public key:
#    gpg2 --recv-keys 409B6B1796C275462A1703113804BB82D39DC0E3
#or if it fails:
#   command curl -sSL https://rvm.io/mpapis.asc | gpg2 --import -
$ command curl -sSL https://rvm.io/mpapis.asc | gpg2 --import -
$ cat /tmp/rvm.sh | bash -s stable --rails
#반드시 username에 사용자명으로 바꿔서 넣어주세요.
$ source /home/username/.rvm/scripts/rvm
#RVM 설치 확인
$ rvm version
rvm 1.29.3 (latest) by Michal Papis, Piotr Kuczynski, Wayne E. Seguin [https://rvm.io]
$ rvm list known
# MRI Rubies
 [ruby-]1.8.6[-p420]
 [ruby-]1.8.7[-head] # security released on head
 [ruby-]1.9.1[-p431]
 [ruby-]1.9.2[-p330]
 [ruby-]1.9.3[-p551]
 [ruby-]2.0.0[-p648]
 [ruby-]2.1[.10]
 [ruby-]2.2[.7]
 [ruby-]2.3[.4]
 [ruby-]2.4[.1]
 ruby-head
 ...
# 여기서 주목해야 하는 부분은 시스템에서 제공하는 최신 루비 버전은 2.4.1이다
# 밑의 방식으로 설치하면 2.4.1의 버전이 설치되버림.
$ rvm install ruby_version
$ rvm list
$ rvm use ruby_version

http://jekyllrb-ko.github.io/docs/installation/ 에서 루비 설치홈에 가보면 최신버전은 ruby 2.5.1이다.

루비 최신 버전 정보

개개인의 선택이겠지만 저는 맥에서 최신 버전을 설치 했기때문에
다시 최신버전으로 재설치를 했어야 했습니다. ㅠㅠ
osx와 우분투에서 각기 다른 버전의 ruby 때문에 문제 발생[해결]

절대 우분투 환경에서 apt-get으로 ruby를 설치하시면 안됩니다. 옛날버전의 루비여서 jekyll를 사용하려고 하면 환경설정부터 각종 오류를 토해냅니다.

jekyll install

$ gem install jekyll
#다른 블로그에서는 bundler도 같이 설치하라는데 왜쓰는지 모르겠다.

Using jekyll

$ jekyll new [any_title]
#처음 설정하는데 좀 오래걸려요. 끝날때 까지 절대 중단하지 말고 기다려주세요.
$ cd [any_name]
$ jekyll serve --watch
#웹에서 http://127.0.0.1:4000/에 접속하면 로컬환경에서 돌아가는것을 확인가능.

Git page publishing

Git respository생성시 유저네임으로
#유저네임.github.io 로 만들어줘야함
#생성후에 설정에서 깃 페이지로 만들어 주면끝.
#이제 아까 jekyll 로 만들었던 폴더 통채로
#유저네임.github.io에 복사해서 업로드 시켜주면됨.
$ cp -r [any_name]/. ./username.github.io
$ cd username.github.io
$ git add -all
$ git commit -m test
$ git push
이제 깃에 다시 들어서 셋팅에서 페이지 생성부분에 보면 내 깃 페이지 주소가 나올것이다. https://username.github.io 이런식으로 나올것이다 여기에 들어가서 Welcome 뜨면 성공

jekyll Usage

새로운 플러그인이나 환경 설정이 변경 되었을때 반드시
추가된 내용이 적용되도록 번들을 이용해야 합니다.

$ bundle install
$ bundle update

로컬에서 실시간으로 웹페이지를 보고 싶다면

$ jekyll serve --livereload
#실시간으로 적용된 부분을 다시 보여줌

Google search

구글 웹마스터

블로그 참고

각 포털 검색등록

google analytics를 적용하기 위해서

_include/ga.html을 작성하고

_include/body.html에 ga.html을 Include 하도록 추가

issue

problem1

apt-get 으로 ruby 설치 했을때 에러

apt-get으로 ruby를 설치했더니 jekyll new할때

#이런 에러를 토해냄
$ Bundler: ruby: No such file or directory --   
/usr/lib/ruby/gems/2.3.0/gems/bundler-1.16.1/exe/bundle (LoadError)
#확인해봤더니
#/usr/lib/ruby/gems/2.3.0/gems 에는 bundler가 없고
#/var/lib/gems/2.3.0/gems에 bundler가 존재
command curl -sSL https://rvm.io/mpapis.asc | gpg2 --import -

problem2

osx와 우분투에서 각기 다른 버전의 ruby 때문에 문제 발생

[ruby]ubunturubyversion

우분투에 ruby 2.5.1 최신 버전을 설치해야 했습니다.
앞에서 rvm을 설치 했기 때문에 rvm 으로 설치 진행 하겠습니다.

$ rvm remove ruby-2.4.1
$ rvm install ruby 2.5.1
$ ruby -v
$ ruby 2.5.1p57 (2018-03-29 revision 63029) [x86_64-linux]
$ gem install jekyll bundle

osx에서 개발할때와 우분투에서 개발할때 루비 버젼이 달라서 에러를 토해냄. 맥은 기본적으로 루비가 설치되어 있고 brew를통해 최신 루비 설치가 가능함. 물론 rvm 으로 설치하는것이 이상적이지만 맥에서는 필요 없다고 판단이됨.

시작부터 끝까지 조금 자세하게 설명되어있음

jekyll 추천 플러그인

jekyll 추천 테마 리스트1

jekyll 추천 테마 리스트2

반응형 깔끔 선형 반응형 깔끔 메뉴 누르기 편함 가장 기본적임

테마 적용법

jekyll 자세한 설명들

gitpage 공식 설명 콩로그님 블로그 플러그인 자세함