/ JEKYLL

Jekyll 기반의 GitHub Page 생성(7)

Jekyll 기반의 GitHub Page 생성은 여러 절로 구성되어 있습니다.


GitHub Gist 활용

GitHubGist에 대해서 잘 알지 못하시는 분은 여기를 클릭하셔서 간단하게 Gist에 대한 이해를 하고 오시면 됩니다.

그럼 설치부터 천천히 알아보도록 하죠.


먼저 gist를 사용할 수 있도록 gem을 설치해야 합니다. 아래와 같이 command 창에서 명령어를 입력합니다.

gem install jekyll-gist

gem 설치가 끝나면 _config.yml을 수정해야 합니다.

아래의 코드는 저의 _config.yml입니다.

위의 코드는 gist를 이용하여 불러온 코드입니다.

중간쯤에

plugins: [jekyll-paginate, jekyll-feed, jekyll-gist]

부분처럼 설치한 jekyll-gist를 추가시킵니다.

그리고 포스트를 하나 생성해서 다음과 같은 구문을 이용하여 gist를 불러오면 됩니다. gist를 불러올 때 JavaScript 링크를 붙였넣는것이 아닙니다. 만약 불러올 링크가 아래와 같으면

<script src="https://gist.github.com/moon9342/d37bb68b8a51c21d4fe6d1b03dfdfa3e.js"></script>

여기에서

moon9342/d37bb68b8a51c21d4fe6d1b03dfdfa3e

부분만 이용합니다.
즉, 아래와 같이 불러오시면 됩니다.


{% gist moon9342/d37bb68b8a51c21d4fe6d1b03dfdfa3e %}


오류 해결

한방에 된다면 좋겠지만 잘 안될 수 있습니다.

가장 많이 나는 오류는 SSL_connect 오류입니다. Windows 10 사용자들은 다음과 같은 오류가 높은 확률로 발생합니다.

SSL_connect returned=1 errno=0 state=SSLv3 read server certificate B: certificate verify failed

에러 메시지를 보니 그냥 해결할 수 있는 종류가 아닌 듯 보입니다. Stack Overflow 사이트에서 찾아보면 몇가지 해결 방안을 발견할 수 있습니다.

command 창을 열고 다음과 같이 하나하나 실행 하시면 됩니다.

gem update --system

gem install rubygems-update

update_rubygems

위의 과정은 RubyGem을 최신으로 upgrade 시키는 작업입니다.

그런 다음 링크를 클릭해서 파일 하나를 다운로드 받습니다. 이 파일은 .pem 파일로 certificate 역할을 하는 파일입니다. 파일을 다운로드해서 적절한 위치에 복사합니다. (원하는 폴더에 저장해놓으면 됩니다.)

저는 D:/myRuby 폴더를 생성하고 이 안에 해당 파일을 복사해 넣었습니다. 파일이름은 cacert.pem이라고 했습니다.

이제 시스템 환경변수를 하나 생성합니다. 환경변수 이름은 SSL_CERT_FILE로 하셔야 하며 환경변수의 값으로 파일에 대한 절대경로를 넣어줍니다. 저같은 경우는 D:/myRuby/cacert.pem로 설정해야 겠네요.

여기까지 진행했으면 command 창을 다시 열어서(환경변수가 변경되었으니 다시 열어야죠!) 블로그를 다시 build 하시면 됩니다.

SSL_connect 문제에 대한 보다 자세한 설명은 링크에서 확인하실 수 있습니다.


위와 같이 해서 Code Snippet을 원하는 곳에 붙여 사용할 수 있습니다. gist에서 제공하는 default theme가 맘에 안드시면 다음의 CUSTOMIZING GITHUB GISTS를 방문해 보세요. 조금만 살펴보시면 원하는 style로 gist를 사용하실 수 있습니다.

End.