jekyll를 이용한 github에 개인 사이트 구축
10분 만에 블로그 뚝딱 만들기
jekyll로 만들어진 홈페이지 보기
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/
