[GitHub] GitHub 블로그 만들기 (Ruby)

 

1. GitHub Repository 생성 및 git 폴더 생성

(1) GitHub Repository 생성

<<Check Point>>
1. Repository Name을 "{username}.github.io"로 해줘야 함
2. "Add a README file" 체크

 

 

 

(2) Git 폴더 생성 및 GitHub 연동 (터미널 이용)

<<Check Point>>
1. 만든 Github Repository 주소 복사

 

 

 

<<Check Point>>
1. 터미널에서 앞으로 깃페이지 파일 정리할 폴더로 경로 이동 : cd [폴더 경로]
2. 해당 폴더로 만든 깃허브 연동&내용 복사 : clone [위에서 복사한 깃허브 주소]

 

 

 

 

<<Check Point>>
1. 위에 단계가 제대로 수행됐으면 위와 같은 폴더 생성됨

 

 

 

2. Ruby 및 Jekyll 설치 (https://rubyinstaller.org/downloads/) - 윈도우 전용

(1) Ruby 설치

<<Check Point>>
1. 맥OS/Linux 등은 "https://www.ruby-lang.org/ko/downloads/" 에서 가이드 보고 다르게 설치 
2. Ruby에서 추천하는 버전은 "Ruby+Devkit 2.7.3" 
   하지만, 글쓴이는 사용할 테마와의 호환성 문제로 "Ruby+Devkit 2.6.7"버전을 받음
   (일단 2.7버전 받고, 테마에서 문제가 발생하면 다운그레이드 버전 받아도 됨)

 

 

 

<<Check Point>>
1. 설치 중에 "Use UTF-8 as default external encoding" 체크

 

 

 

<<Check Point>>
1. 다운 완료된 후 첫 실행화면에서 "1, 2, 3 + Enter" 해서 설치하면 됨

 

 

 

(2) Jekyll 설치 (터미널에서)

<<Check Point>>
1. 루비 설치 확인 : "ruby -v"
2. jekyll 설치 : "gem install jekyll bundler"

 

 

 

3. 사용할 테마 선택 및 적용

(1) 사용할 테마 선택 및 다운

• http://jekyllthemes.org/
• https://jekyllthemes.io/free
• https://jamstackthemes.dev/ssg/jekyll/
• https://jekyll-themes.com/free/

<<Check Point>>
1. 선택한 테마의 깃허브에 들어가 "Gemfile, _config.yml" 파일이 있는지 확인
* Gemfile : Ruby 의존성 설정
* _config.yml : 테마 설정

 

 

 

(2) 선택한 테마 GitHub에 적용 

<<Check Point>>
1. 앞에서 생성해둔 폴더에 다운로드한 테마 파일들 복붙

 

 

 

<<Check Point>>
1. 해당 폴더로 이동 : "cd ./[폴더명]  또는 cd [전체 폴더 경로]"
2. 테마의 젬 파일 설치 : "gem install bundler"
3. 관련 번들 설치 : "bundler install"

 

 

 

<<Check Point>>
1. url 자신의 github url로 수정

 

 

 

<<Check Point>>
1. github에 push하기 (글쓴이는 이미 해서, 이거는 코드로 대체)

$ git add .
$ git commit -m "Theme created"
$ git push​

 

 

 

4. 테마 적용 확인하기

(1) Jekyll server (github 올리기 전에 변경 확인용)

<<Check Point>>
1. 해당 폴더로 이동 : "cd ./[폴더명]  또는 cd [전체 폴더 경로]"
2. jekyll 서버 실행 : "bundle exec jekyll serve"
3. 인터넷에서 확인 : "http://127.0.0.1:4000/"

 

 

 

(2) Github Page (최종 완성본)

<<Check Point>>
1. 위에 처럼 GitHub에도 폴더가 올라가 있고, 주소 페이지에 반영되어 있으면 완성!!!

 

 

 

* 다음 이이기

깃 페이지 꾸미기

 

 

 

출처

- https://zoomkoding.github.io/gitblog/2019/08/15/git-blog-1.html

- https://velog.io/@zawook/Github-%EB%B8%94%EB%A1%9C%EA%B7%B8-%EB%A7%8C%EB%93%A4%EA%B8%B0-2

- http://jekyllrb-ko.github.io/docs/step-by-step/01-setup/