jekyll 이란? jekyll 설치 및 배포

jekyll(지킬) 이란

• jekyll 홈페이지
• jekyll은 텍스트 파일로 정적 웹페이지를 만들 수 있는 서비스임
• ruby 기반에서 실행됨
• github pages에서 무료로 호스팅 할 수 있음
• 보통 markdown으로 작성된 텍스트 파일을 배포함

jekyll 설치 방법

ruby 설치하기

• jekyll은 ruby 개발환경이 필요함
• ruby의 설치는 각 OS별로 상이하니 주의해서 설치 필요

OS별 설치참고 사이트

• Windows
• MacOS M1
• Ubuntu
• ruby 설치 시 rbenv나 rvm을 통해 설치하는 것을 추천

jekyll 설치하기

• gem을 이용하여 설치

  $ gem install jekyll bundler
  

• gem은 ruby의 설치관리자로 node의 npm과 유사함

jekyll로 새 블로그 생성하기

$ jekyll new { blogName }

블로그 실행하기

• 블로그 디렉토리로 이동

  $ cd { blogName }
  

로컬환경에서 실행하기

• bundle exec 를 붙이면 GemFile에 정의된 jekyll을 실행할 수 있음

  $ bundle exec jekyll serve
  

• 브라우저에서 기본주소 127.0.0.1:4000로 접속하면 생성된 사이트 확인가능
• 포트변경도 가능

  # 5000번 포트로 변경하여 로컬서버 실행 시
  $ bundle exec jekyll serve --port 5000
  

_site 디렉토리에 정적사이트 생성하기

• build 명령을 통해 _site 디렉토리에 생성가능

  $ bundle exec jekyll build
  

포스트(post) 생성하기

• 블로그에서 글을 포스트(post)라고 함
• jekyll에서 포스트는 _posts 폴더에 저장하고 있음
• _posts 폴더에서 yyyy-mm-yy-title.md형식으로 파일을 생성

  $ cd _posts
  $ vi 2020-01-01-my-first-blog.md # 내용 입력
  

• 포스팅된 것을 확인

github.io에 배포하기

• github에서 { 사용자명 }.github.io로 리포지토리 생성
• 해당 리포지토리에 작성된 파일 배포하면 자동으로 배포됨
• 배포 시 제외되어야 하는 파일목록 예시

# .gitignore에 추가된 파일목록
# Vim
*~
*.sw[p_]

# Sublime Text
*.sublime-project
*.sublime-workspace

# Ruby Gem
*.gem
.bundle
Gemfile.lock
**/vendor/bundle

# Node.js and NPM
node_modules
npm-debug.log*
package-lock.json
codekit-config.json

# macOS
.DS_Store

# Jekyll generated files
.jekyll-cache
.jekyll-metadata
.sass-cache
_asset_bundler_cache
_site

• 브라우저에서 { 사용자명 }.github.io에 접속하면 확인가능

local repo와 remote repo 연결하고 push

$ git remote add origin { github repository 주소 }
$ git branch -M main
$ git push -u origin main