github.io 만들기 1: jekyll 설치 및 블로그 기본형 구성


    목차
    1. Ruby+Devkit 다운받기
    2. Devkit 설치
    3. jekyll 및 부가기능 설치
    4. 로컬에서 기본 페이지 생성
    5. GitHub에서 계정 주소의 온라인 저장소(repository) 생성
    6. GitHub와 로컬 디렉토리 연동시키기
    7. Jekyll 테마 설정
    8. 로컬 서버를 구동해 블로그 확인



1. Ruby+Devkit 다운받기




2. Devkit 설치


  • DevKit-mingw64–64–4.7.2–20130224–1432-sfx.exe
  • 실행한 파일은 C:\devkit에 풀기



3. jekyll 및 부가기능 설치


  • win+R+cmd
ruby -v 			# Ruby 버전 확인
cd C:\devkit 			# devkit 폴더로 이동
ruby dk.rb init
ruby dk.rb install ruby devkit
cd c:\ 
gem install jekyll 		# jekyll 설치



4. 로컬에서 기본 페이지 생성


  • win+r+cmd
cd c:/ 						# C드라이브를 기본 디렉토리로 설정
jekyll new githubID.github.com 			# C드라이브 바로 밑에 githubID로 된 로컬디렉토리와 파일 생성
cd c:/githubID.github.com  			# 기본 디렉토리 변경
gem install jekyll 				# 디렉토리 내에 jekyll 설치
jekyll serve --watch 				# 서버 구동

########################################################################################

sudo bundle install				# gemfile error 발생 시 bundler install 및 bundle 서버를 구동
bundle exec jekyll serve 			# 테마 설치를 해봤을 때 시행
  • 웹브라우저 주소창에서 127.0.0.1:4000 혹은 localhost:4000 입력: 디폴트로 생성된 지킬사이트 확인!



5. GitHub에서 계정 주소의 온라인 저장소(repository) 생성


  • githubID.github.io 이름의 저장소(repository) 생성



6. GitHub와 로컬 디렉토리 연동시키기


  • Git Bash
cd c:\githubID.github.com 			# 기본디렉토리 설정
  • Connect repository
$ git init
$ git remote add origin 저장소URL 		# git 저장소URL 추가
$ git remote -v 				# 저장소URL 확인
$ git remote rm origin 				# 현재 연결된 origin 제거 (URL 잘못 입력 시)
  • Commit & Push
$ git add . 					# 수정된 전체 파일을 저장소에 올릴 준비
$ git commit -m “Create blog” 			# Create blog: 커밋 내용. add한 수정된 파일을 저장소에 올릴 것을 확정
$ git push origin master 			# 수정 사항을 저장소에 반영

  • Jekyll에서 페이지 생성하는데엔 10분 정도 소요.
  • 웹브라우저 주소창에서 githubID.github.io: 블로그 확인 가능!



7. Jekyll 테마 설정


gem install bundler 					# bundler 설치
  • Jekyll Themes 사이트: https://jekyllthemes.io/ 에서 원하는 테마 고르고 GitHub에서 파일 다운로드
  • 압축 파일을 풀고 githubID.github.com 디렉토리를 모두 비운 후, 전부 붙여넣기
  • 터미널에서 현재 위치를 githubID.github.com 으로 잡고, 빌드 진행

  • Commit & Push
    $ git add .
    $ git commit -m “Change Theme”
    $ git push -u origin master 			# 에러 뜰 수 있음. 추가 검색하기
    ############################################################################
    $ git push -f origin master			# master -> master (fetch first) 에러 발생 시
    ############################################################################
    $ git pull					# 그래도 안되면
    $ git push -f origin master
    



8. 로컬 서버를 구동해 블로그 확인


bundle exec jekyll serve 
  • 웹브라우저 주소창에 localhost:4000 입력: 테마 바뀐 블로그 확인 가능!



<참고>


  1. https://medium.com/%40psychet_learn/git-%EC%82%AC%EC%9A%A9%EB%B2%95-3%EC%9E%A5-github-%EC%9D%B4%EC%9A%A9%ED%95%98%EA%B8%B0-f53e765844e3
  2. https://nolboo.kim/blog/2013/10/15/free-blog-with-github-jekyll/
  3. https://dataitgirls2.github.io/tutorial/Tutorial_180709_StaticBlogging_JekyllandRuby.html
  4. https://faith-developer.tistory.com/25
comments powered by Disqus