Jekyll을 이용한 Github Blog 만들기

• Jekyll(지킬) 이란?

  • Jekyll 이란 개인, 프로젝트 또는 조직 사이트를 위한 간단한 블로그 인식 정적 사이트 생성기이다. 이는 Github 설립자인 Tom-Preston-Werner가 루비 언어로 작성하였으며, MIT 라이선스를 기반으로 오픈소스 배포가 된다.

    Jekyll 사이트

---

1. 자신의 깃허브 페이지 생성하기.

   • 자신의 깃허브 페이지를 만들어 보자. 우선 우측 상단에 New Repository를 들어가자. 그리고 repositry이름을 다음과 같은 양식에 맞게 작성해주자.

     (자신의 깃허브 닉네임).github.io

   • 필자의 경우를 작성해 보면 다음과 같이 나타낼 수 있다. 여기서 경고창이 뜨는 이유는 필자는 이 글을 작성할때 이미 J-hoplin1.github.io라는 repository를 이미 만들었기 때문이다.

     

2. 지킬에서 테마고르기

   • 이제 Jekyll에서 자신이 블로그에 이용할 테마를 적용해보자. 우선 지킬 테마들을 보기위해 이 링크 로 들어가자.

   • 필자의 경우에는 minimal-mistakes이라는 테마를 이용해서 만들었다. 그렇기에 이 포스트 또한 mnimal-mistakes를 기준으로 작성된다.

3. 설정하기

   • 우선 해당 링크에 들어가면 _config.yml이라는 파일이 있는것이 볼 수 있다. 해당 파일을 들어가서 모두 복사를 한다.

     

   • 그리고 자신의 github.io repository를 들어가서 똑같이 _config.yml이라는 파일을 만들어 준다. 파일을 만드는 법은 'Create NewFile'이라는 버튼을 눌러주면 된다.

     

   • minimal-mistakes 같은 경우에는 _config.yml에서 고쳐줄것이 있다. 우선

     #remote_theme           : "mmistakes/minimal-mistakes"

     부분의(14번째줄) 주석(#)을 없애주어야한다

   • 그 다음에는 url, base url(24,25번째줄)을 수정해 주어야한다. url의 경우에는 자신의 github.io 레포지토리의 이름을 입력해주면되고 base url은 비워놓아도된다.

     url                      : # the base hostname & protocol for your site e.g. "https://mmistakes.github.io"
     
     baseurl                  : # the subpath of your site, e.g. "/blog"

   • 그 후 밑의 title, description, URL 같은것은 각자 자신에게 맞도록 설정해주자.

   • 설정을 완료 했다면 index.html을 생성해주자. 그리고 해당 내용을 입력해주자.

     

   ---

   layout: home

   author_profile: true

5. 블로그에 글 작성하기

   • 글을 작성하기 위해서는 _post 라는 폴더에 markdown형식으로 정리를 해주어야 한다. 폴더 생성을 위해서는 _post를 적은뒤에 '/' 를 적어주면 디렉토리 생성으로 인식한다. markdown의 기본적인 문법은 필자가 정리해놓은 문서도 있다.

   • 한번 폴더와 임의의 블로그 글 마크다운을 만들어보자. 일반적으로 깃허브 블로그 글을 쓸때의 제목 포맷은 연도-월-일-포스트이름.md 의 형식을 따른다고 한다.

     

5. 블로그 접속해보기

   • 이제 테스트 글까지 작성해 보았다면 자신의 깃허브 블로그를 접속해보자.

     

   • 필자의 테마가 검은 이유는 'minimal_mistakes_skin' 부분(이부분은 테마설정을 해줄수 있는 부분이다)을 neon으로 설정해주었기 때문이다.

   • 자신의 블로그가 잘 떳다면 잘 완료한것이다. 추후 깃허브 블로그 관련 글은 테마 변경과 같은 여러가지 커스텀에 대한 글을 작성해보겠다.