[Jekyll]github에 개인 블로그 구축 하기

Daniel's home page 바로가기

About jekyll

다음은 jekyll 문서에서 가져온 내용입니다.

Jekyll 은 아주 심플하고 블로그 지향적인 정적 사이트 생성기입니다. Jekyll 은 다양한 포맷의 원본 텍스트 파일을 템플릿 디렉토리로부터 읽어서, (Markdown 등의) 변환기와 Liquid 렌더러를 통해 가공하여, 당신이 즐겨 사용하는 웹 서버에 곧바로 게시할 수 있는, 완성된 정적 웹사이트를 만들어냅니다. 그리고 Jekyll 은 GitHub Pages 의 내부 엔진이기도 합니다. 다시 말해, Jekyll 을 사용하면 자신의 프로젝트 페이지나 블로그, 웹사이트를 무료로 GitHub 에 호스팅 할 수 있다는 뜻입니다.

Install jekyll

먼저 jekyll의 설치를 하기전에 다음의 준비물이 설치 되어 있어야 한다.

Jekyll 설치는 아주 쉽고 직관적이지만, 시작하기 전에 먼저 확인해야 할 몇 가지 준비물이 있습니다.

• Ruby (Jekyll 2 사용 시 v1.9.3 이상, Jekyll 3 사용 시 v2 이상의 개발 패키지 포함)
• RubyGems
• 리눅스, 유닉스, 또는 맥 OS X
• NodeJS, 또는 다른 JavaScript 실행환경 (Jekyll 2 와 그 이전 버전에서, CoffeeScript 지원에 필요함).
• Python 2.7 (Jekyll 2 나 그 이전 버전일 경우)

상세 설치 주소는 여기 에서 확인

가장 기본적인 형태로 Jekyll 사이트를 구축하고 실행하는 방법을 먼저 알려드립니다.

~ $ gem install jekyll
~ $ jekyll new myblog
~ $ cd myblog
~/myblog $ jekyll serve
# => Now browse to http://localhost:4000

현재 디렉토리에서 Jekyll 을 구성하려면, 새 디렉토리 이름 대신 jekyll new . 을 실행하세요.

초기 블로그의 화면은 http://localhost:4000 로 접근 하면 확인이 가능 하다.

만약, jekyll이 위의 방법으로 설치 되지 않을 경우

다음의 방법으로 jekyll를 설치 하세요.

~ $ sudo apt-get install jekyll

Make Blog with Theme

테마를 사용하면, 좀더 멋진 블로그를 만들 수 있다. 내가 사용한 테마는 Moon이다.

테마는 jekyll Themes에서 찾아 볼 수 있다.

테마를 사용하기 위해서 하는 일은 다음과 같다.

1. 테마의 소스를 로컬 PC에 다운로드 한다.
2. 소스를 빌드 한다.
   • 빌드 중 오류가 발생 하면, 4.을 참고
3. 빌드된 디렉토리에서 jekyll serve를 입력 한다.
4. 설치 하라는 플러그인이 있을 경우 추가로 설치 한다.
   1. 설치해야하는 플러그인 정보는 Gemfile 에 표현되어 있다.
   2. 그 외에 추가 설치 정보는 오류 메시지를 확인 하자
5. 실행이 완료 되었으면 http://localhost:4000 를 확인 한다.

플러그인 설치 중 오류 발생시 다음을 실행

~ $ sudo apt-get install ruby-dev
~ $ sudo gem update --system
~ $ sudo apt-get install libxml2
~ $ sudo apt-get install zlib1g-dev

Reference

• https://brunch.co.kr/@hee072794/39
• https://vjinn.github.io/tip/jekyll-plugins-and-github-pages/
• https://github.com/flapjack/omnibus-flapjack/issues/72
• https://nolboo.kim/blog/2013/10/15/free-blog-with-github-jekyll/
• https://github.com/TaylanTatli/Moon
• http://jekyllrb-ko.github.io/docs/home/