[GitHub/Jekyll] Jekyll 설치 및 실행 - Theme변경, 로컬 실행 #1

# Jekyll과 GitHub를 이용한 블로그 만들기

공식 사이트 : https://jekyllrb.com/

##배경

Github를 자주 이용하면서 깃허브와 블로그를 한곳에서 같이 운영하고 싶었다. 그러한 마음에 시작하게 되었습니다.
깃허브 블로그가 잘 만들어진다면 T-Story블로그를 잘 정리해서 Git Blog로 이전할까 합니다.
그럼 이제 차례대로 적어볼까 합니다.

- 글쓴이 환경 : Mac OSX Sierra

## 1. 설치 전 필수 사항

• Linux || Unix || Mac OS X

• Python 2.7 (Jekyll 2 나 그 이전 버전일 경우)

• NodeJS, 또는 다른 JavaScript 실행환경 (Jekyll 2 와 그 이전 버전에서, CoffeeScript 지원에 필요합니다).

• RubyGems

• Ruby (Jekyll 2 사용 시 v1.9.3 이상, Jekyll 3 사용 시 v2 이상의 개발 패키지 포함)

## 2. Jekyll 설치

$ gem install jekyll

$ gem install jekyll bundler

$ cd ~/Desktop

$ mkdir development/jekyll

$ cd development/jekyll

$ jekyll new {shooney.github.blog} //: { } 안에는 자신의 블로그 프로젝트 이름을 적어주세요.

## 3. 실행

$ cd {shooney.github.blog}

$ bundle exec jekyll serve

문제 없이 실행이 완료되었다면 http://localhost:4000/

이런 모습을 보았다면, 문제 없이 완료된 것입니다.

일단 시작하는 내용까지 알아보았습니다.

인덱스의 간단한 내용들을 바꾸고 싶다면, 폴더 안에 있는 

_config.yml 파일을 열어보시면 바꿀 수 있습니다.

##4. 추가사항

사이트 : http://jekyllthemes.org/

- jekyll Template가 제공되고 있습니다. 마음에 드는것이 있으시면 다운받아 아까 말한 폴더에 옮기시면 됩니다.

가장 편한 방법은

 - 마음에 드는 Theme을 고른다.

 - Download 

 - GitHub에서 Zip파일로 받는다.

 - 압축을 푼다

 - 나의 프로젝트에 넣는다.

 - 변경된 파일을 알아서 인식하기때문에 새로고침하면 변경된 템플릿을 볼 수 있다.

* 테마 변경 후 에러 발생시,

$ gem install bundler

$ bundle install

$ bundle exec jekyll serve

##5.  Jekyll 기본 디렉토리 구조

디렉토리와 설정화일인 _config.yml은 구조와 설명은 참고적으로 설명한다. 
그러나, 자신이 작성할 블로그글을 _post 안에 YYYY-MM-DD-[POST SLUG].[FORMAT 형식으로 포스트 화일명을 지정하는 것은 엄격하게 지켜야 한다.

• _config.yml // 전역 환경설정 화일
• _layouts // 기본 레이아웃
• _posts
• 2013-09-14-welcome-to-jekyll.markdown // 기본 블로그 포스팅
• _site // 제너레이트된 블로그가 위치하는 곳
• css
• main.css
• syntax.css // 코드 하일라이트 스타일링
• index.html
  
  

### 5.1. _config.yml
환경설정은 YAML 형식을 사용한다.
name과 description의 따옴표 안에 자신의 것을 넣어 준다. 특수문자를 포함하지 않으면 따옴표를 사용할 필요도 없다.

### 5.2. _includes

template partials(혹은 워드프레스의 get_header() 명령)에 친숙하다면 includes 디렉토리는 같은 일을 한다. 헤더와 푸터 같이 공통의 화일을 같는 포스트와 페이지의 테마 빌더이다. 디렉토리나 화일 앞의 _을 붙이면 웹사이트를 제너레이트할 때 복사되지 않는다.

### 5.3. _layouts

이것도 테마에 사용되는 폴더이다. 포스트의 레이아웃 화일을 저장한다. 여러 개의 레이이웃을 사용할 수 있으며, 대부분의 블로그 포스트는 post 레이아웃을 사용하고, 각 포스트의 텍스트 컨텐츠, 공유버튼, Disqus 댓글 등을 포함한다. 댓글과 공유버튼이 없는 posts-no-comments라는 레이아웃을 사용하는 페이지도 있다. 너비가 꽉차는 포트폴리오 레이아웃을 사용하기도 한다.

### 5.4. _posts

마크다운(또는 HTML/Textile) 블로그 포스트 화일을 넣는 곳이다.

### 5.5. _site

컴파일된 블로그 사이트는 _site에 옮겨진다.

이상 jekyll #1 블로그를 마치고, 차차 알아가며 #2을 써보도록 하겠습니다.

## 6. 참조

- https://nolboo.kim/blog/2013/10/15/free-blog-with-github-jekyll/