chirpy 설치 후 초기 설정 진행 방법
jekyll 테마를 모아놓은 사이트에서 chirpy 테마가 마음에 들어서 설치했습니다. 그런데 로컬 저장소와 연동하기 위해 push하면 이런저런 오류가 발생해서 상당히 곤란했습니다.
사흘 정도를 오류 해결에만 몰두했는데, 해결법은 “매뉴얼대로 설치하기”였습니다. 아래의 chirpy 공식 매뉴얼을 따라 설치하면 대부분 문제가 해결되었습니다.
https://chirpy.cotes.page/posts/getting-started/
그런데 이 매뉴얼에는 큰 걸림돌이 있습니다. bash tools/init명령어의 수행입니다. 리눅스 환경에서만 동작하는 명령이라 원도우에서는 사용할 길이 없습니다. 이 명령을 실행하면 코드 및 템플릿 배포를 위해 존재하는 불필요한 파일을 삭제하고, 필요한 파일을 추가하고, 정리해줍니다.
그렇다면 윈도우에서는 어떻게 해야 초기 설정을 진행할 수 있을까요?
수동 초기화
첫 번째는 자동으로 진행되는 과정을 수동으로 진행하는 방법입니다.
아래 블로그에 자세히 소개되어 있습니다.
https://velog.io/@hashnsalt/Github-Blog-만들기-2
이 방법을 사용해 여러 번 시도해봤는데, 저는 도무지 에러가 해결되지 않아서 다른 방법을 찾아보게 되었고, 매뉴얼에서 init 명령을 사용해 초기화를 진행한다는 것을 알게 되어 wsl을 사용하기로 했습니다.
WSL2를 이용해 init 파일을 실행하는 방법
두 번째는 윈도우 자체에 리눅스를 사용할 수 있게 해주는 WSL2를 설치하는 방법입니다. 저는 아래 글을 참고해 설치했습니다.
LZ: 프로그래머 하우투 가이드 - WSL2 설치 및 사용법
우분투 터미널을 사용하는 것보단 파워셀 상에서 실행하는 게 더 편한 것 같습니다. 처음에 블로그 파일이 있는 폴더에서 bash tools/init 명령을 실행하자
commit unstaged files first, and then run this tool again.
라는 문구가 나왔습니다. 커밋을 먼저 하고 실행하라네요.
커밋까지만 진행하고 실행했더니 이번에는
syntax error near unexpected token `$’{\r’’
라고 합니다. 리눅스와 윈도우가 개행문자를 다루는 방식이 달라 발생하는 문제입니다. 다음 코드를 입력하여 해결할 수 있습니다.
1
sed -i 's/\r//' init
이후 bash tools/init 명령을 실행해 초기화를 진행하면
.github 폴더에 workflow 폴더만 남고, _posts 폴더에 있던 샘플 포스트가 사라집니다.
초기화 이후 발생하는 문제
gh_pages 브랜치가 생성되지 않음
매뉴얼에서는 이제
Gemfile.lock 파일 관련 에러
위 과정까지 마친 후 config.yml 파일을 올바르게 수정했다면 정상적으로 동작되어야 하는데, push하면 git에서 처리하는 과정 중에 문제가 발생합니다.
bundle failed whit exit code 16, jekyll-theme-chirpy build error
Gemfile.lock 파일이 이 문제의 원인입니다. 아래 명령을 실행하면 해결할 수 있습니다.
1
bundle lock --add-platform x86_64-linux
page.min.js, home.min.js 등이 존재하지 않는 오류
init 명령을 수행하면 /assets/js/dist 폴더에 몇 가지 js 파일이 생성되어야 하는데, 생성되지 않아 발생하는 문제입니다.
여기에 있는 js파일들은 Table of Contents를 보여주는 기능 등을 수행하는데, 파일이 없다면 원격저장소에서 오류가 발생함은 물론 로컬 실행 환경에서도 ToC가 보이지 않습니다.
아래 명령을 수행하면 해결할 수 있습니다. 저는 dist 폴더를 생성한 상태에서 명령을 수행했는데, 그렇지 않아도 잘 동작할지는 모르겠네요.
1
NODE_ENV=production npx rollup -c --bundleConfigAsCjs
정리
github 블로그를 운영하려면 정말 맨땅에 헤딩하듯 모든 디자인을 처음부터 직접 해나가야 하는 줄 알았는데, 이미 완성도 높은 템플릿을 사용할 수 있다는 점이 정말 매력적입니다.
chirpy는 정말 많은 분이 사용하고 계시고, 저 역시 마음에 들어 적용해보고 싶은 테마였는데 이런저런 오류를 해결하기가 정말 손에 꼽을 수 있을 만큼 힘들었습니다.
너무 힘들어서 포기하고 다른 테마를 적용해볼까 했지만 오류가 발생하는 건 마찬가지였고, chirpy만한 디자인이 없다고 생각해 계속 시도하다 드디어 성공하게 되었네요.
덕분에 git을 많이 다뤄볼 수 있는 기회가 되었고, WSL도 설치하게 되었습니다. 역시 직접 블로그를 운영하면서 배울 수 있는 내용이 많은 것 같습니다.
여러분들의 오류 해결에도 도움이 되었으면 좋겠습니다.
참조
- 개행문자 문제 해결
https://main.tistory.com/38 - js 파일 문제 해결
https://github.com/cotes2020/jekyll-theme-chirpy/issues/1090 - 리눅스에 chirpy 설치하는 과정
https://www.irgroup.org/posts/jekyll-chirpy