GitHub 블로그 만들기 (2)

본 문서는 GitHub 블로그 만들기 시리즈의 두번째 단계로 블로그 개설과 테마 적용 방법을 담고 있다.

Ruby와 Jekyll이 설치된 환경이어야 하며, 이전 포스팅에서 그 방법을 확인할 수 있다.

GitHub 블로그 만들기(1)

1. GitHub Pages 시작하기

---

GitHub Pages는 GitHub를 통해 호스트되고 게시되는 퍼블릭 웹 페이지이다.

1-1. 신규 Repository 만들기

user_name.github.io를 Repository Name 으로 하여 새로운 Repository를 만든다.

생성한 Repository를 원하는 로컬 저장소로 clone 한다.

$ git clone https://github.com/{user_name}/{user_name}.github.io.git

2. Jeklly 사이트 생성 & 테마 적용

---

2-1. 테마 적용

아래 페이지들에서 원하는 테마를 선택하고 다운로드하거나, 해당 테마의 GitHub 페이지에서 fork한다.

나는 private으로 사용하고 싶었기 때문 압축파일을 다운로드했다.

• https://jamstackthemes.dev/ssg/jekyll/

• http://jekyllthemes.org

• https://jekyllthemes.io/

Mac을 사용할 경우 .으로 시작하는 디렉토리가 보이지 않을 수 있기 때문에 해당 디렉토리들이 보이도록 하려면 Mac 숨겨진 파일 보기을 참고하여 설정을 바꿀 수 있다.

압축 해제 후 모든 파일을 로컬 저장소(user_name.github.io)로 복사한다.

나는 jekyll-theme-chirpy을 선택하였다.

2-2. 기존 파일 수정

몇 가지 파일을 삭제하거나 수정해야 한다.

• docs 디렉토리 삭제
• .github/workflows/pages-deploy.yml.hook 파일을 제외한 나머지 파일 삭제
• .github/workflows/pages-deploy.yml.hook 파일명을 pages-deploy.yml로 변경

_confing.yml 파일을 열어 블로그 기본 설정이 가능하다. title, tagline, url 등을 수정할 수 있으며, 주석에 해당 필드에 대해 간단하게 설명되어 있다.

2-3. 로컬로 사이트 빌드

로컬 저장소에서 아래 command를 실행하여 bundle을 설치한다.

$ bundle install

아래의 command 실행 후 http://127.0.0.1:4000에 접속하면 테마가 적용된 페이지를 확인할 수 있다.

$ bundle exec jekyll serve

오류 - webrick

Ruby 3.0 이상을 설치한 경우(Homebrew를 통해 기본 버전을 설치한 경우) 이 단계에서 오류가 발생할 수 있다. Ruby에 webrick이 설치되어 있지 않기 때문이다. 오류를 해결하려면 아래 command 실행 후 다음 다시 실행하면 된다.

$ bundle add webrick