jekyll-theme-chirpy 블로그 오류 정리
jekyll-theme-chirpy 블로그 오류 정리
블로그를 운영하며 수 많은 오류에 직면했습니다.
괜히 깃허브 블로그를 선택했다 생각을 하면서도 하나 하나 고쳐가는 재미에 새벽까지 밤을 새우는 날도 많았네요😬
지금까지 직면한 오류를 정리하며 저 또한 구글링을 통해 많은 도움을 받았기 때문에 다른 분들에게 도움을 드리고 싶습니다!
또한 제가 작성한 기록을 보며 오류를 다음에 마주했을 때 쉽게 해결하기 위해 이 글을 작성합니다.
깃허브 블로그 페이지네이션 적용 안 됨 해결
해당 부분에 대해 수많은 방법을 시도하고 코드도 뜯어봤습니다. 제일 괜찮다고 생각하는 방법은 기본 제공하는 pagination이 있기에 새로 받아서 버전을 업그레이드 하는 방식으로 해결했습니다.
이미 많은 글을 작성했기에 Chirpy 소스를 직접 다운 받아서 수작업으로 빌드하는 방식을 선택했습니다.
해당 블로그를 통해 버전 업그레이드를 했습니다. 중요한 점은 깃허브 블로그는 새로 배포를 하면 적용될 때 다음과 같은 Update 버튼이 화면에 표시됩니다. 꼭 Update 버튼을 눌러 적용하시길 바랍니다.
Can’t find stylesheet to import 오류 해결
1
2
3
4
5
6
7
8
9
10
11
12
13
Error: Can't find stylesheet to import.
╷
1 │ @import 'dist/bootstrap';
│ ^^^^^^^^^^^^^^^^
╵
main.bundle.scss 1:9 @import
/home/runner/work/tom-whi.github.io/tom-whi.github.io/assets/css/jekyll-theme-chirpy.scss 1:9 root stylesheet
Conversion error: Jekyll::Converters::Scss encountered an error while converting 'assets/css/jekyll-theme-chirpy.scss':
Can't find stylesheet to import.
------------------------------------------------
Jekyll 4.3.3 Please append `--trace` to the `build` command
for any additional information or backtrace.
------------------------------------------------
해당 오류가 뜬다면 다음 명령어로 해결합니다.
1
2
3
4
5
6
7
8
# 1번
npm install
# 2번
npm run build
# 3번
git add assets/js/dist _sass/dist -f
파일 충돌
해당 에러는 다른 경로에 같은 이름의 파일이 존재해 충돌이 생기므로 로컬 루트 경로에 있는 feed.xml, index.html, robots.txt를 삭제하면 됩니다.
본인이 충돌나는 파일을 살펴보고 맞게 삭제할 것.
assets/js/dist/ ~.js 파일 does not exist
해당 오류는 dist 폴더의 하위 경로에 있는 js 파일이 존재하지 않는다는 오류입니다.
해당 파일들이 없는 이유는 테마를 fork 또는 clone 한 뒤 bash tools/init 명령어를 실행하지 않았기 때문입니다.
공식 사이트의 일부입니다. fork나 clone을 한 직후에 리눅스 환경에서 “최신 버전“의 node.js를 설치한 뒤 bash tools/init 명령어를 실행하면 assets/js/dist/ 가 정상적으로 생성됩니다.
윈도우를 사용한다면 # (WSL) Windows 에서 Ubuntu bash 사용하는 방법 해당 블로그를 통해 bash tools/init 명령어를 실행할 수 있게 됩니다.
여기서 node.js를 설치할 때 그냥 sudo apt install node를 하면 bash tools/init가 중간에 실패하게 됩니다. 리눅스 패키지 서버에 있는 node 버전은 구식으로 꼭 최신 버전은 node를 설치해야됩니다.