/ JEKYLL

Jekyll 기반의 GitHub Page 생성(7)

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


영상설명

이번 영상은 Code Snippet을 관리하기 위한 도구인 GitHub Gist를 우리블로그에서 사용하는 방법에 대한 내용입니다.

Jekyll 기반의 GitHub Page 생성(7) - GitHub Gist 활용 영상


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 역할을 하는 파일입니다. 파일을 다운로드해서 적절한 위치에 복사합니다. (원하는 폴더에 저장해놓으면 됩니다.)

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

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

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

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


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

End.