Jekyll Theme 적용하기

Requirements

  • GNU/Linux, Unix, or macOS
  • Ruby version 2.1 or above, including all development headers
  • RubyGems

Jekyll Theme 고르기

아래의 사이트에서 자신이 원하는 Jekyll Theme를 선택한다.
http://jekyllthemes.org/

Jekyll 적용하기

  1. 원하는 Jekyll Theme를 다운로드(.zip)한다.
    • Jekyll 사이트에서 직접 다운로드한다.
    • 혹은 연결된 GitHub에서 Clone or download -> Download ZIP 을 통해 다운로드한다.
  2. 압축을 푼다.
  3. Jekyll 블로그를 저장한 로컬 디렉터리에 압축 푼 내용을 모두 복사하여 넣는다.
    • ex. ~/blog/[github 사용자명].github.io
    • Gemfile, Gemfile.lock은 삭제한다.
  4. 아래 명령어를 통해 적용된 테마를 확인할 수 있다.
    ~/blog/[github 사용자명].github.io$ jekyll serve
    # => 개발용 서버가 http://localhost:4000/ 에서 구동된다.
    # 자동-재생성: 활성화됨. 비활성화 하려면 `$ jekyll serve --no-watch` 이용
    
    • 이 명령어를 통해 Jekyll이 제공하는 서버를 실행시킬 수 있다.
    • 자동으로 내용의 변화를 감지하고 재생성해준다.
    • 블로그 사이트가 제대로 구성되어 있는지 로컬에서 미리 확인할 수 있다.


Error
만약 아래와 같이 빈 화면이 나타난다면
=> index.md를 삭제한 후 다시 진행한다.


Error
Error: Address already in use - bind(2) for 127.0.0.1:4000
=> 터미널을 재실행한다.

Jekyll 기본 디렉터리 구조

Jekyll 기본 디렉터리 구조에 대한 자세한 개념은 http://jekyllrb-ko.github.io/docs/structure/를 참고하자.

Posting 하기

_posts 디렉터리 안에 반드시 ‘YYYY-MM-DD-[Post 이름].md’라는 파일명으로 파일을 생성한 후, markdown 문법을 이용하여 Post를 작성한다. (물론, Textile 또는 일반 HTML 등 자신이 즐겨 사용하는 마크업 언어로 문서를 작성할 수 있다.)

관련된 Post

  1. Jekyll에 대한 개념과 설치 및 실행 방법을 익히고 싶으면
    Jekyll을 이용한 .github.io 블로그 만들기_1 를 참고하시기 바랍니다.
  2. 로컬에 있는 블로그 내용들을 GitHub Pages를 이용하여 Posting 하고 싶으면
    Jekyll을 이용한 .github.io 블로그 만들기_3 를 참고하시기 바랍니다.

References