제 목 :
Astro 블로그 구축기 #4 - 블로그 테마 적용을 위한 여정

비서 만들기 프로젝트를 하느라 Astro 블로그 테마 입히는 글을 못쓰고 있었다. 일은 벌려놨고 수습은 못하는 이 사태를 진정시키기 위해 다시 돌아왔으니 테마 입히는 작업을 어서 시작해보자.
블로그에 테마를 넣는게 아니라 테마에 블로그를 넣는 것이다.
Astro는 이미 구축된 블로그에 테마를 적용한다기 보다 테마에 블로그 컨텐츠를 적용한다고 보는게 옳다. 어차피 글은 Markdown이나 MDX(Markdown with JSX)로 작성되어있어 각 페이지가 독립적으로 존재하고 있다. 그러니 글만 옮기면 테마가 적용되는 것과 다를게 없다.
나도 처음엔 블로그에 테마를 적용하려고 했는데 테마의 기능과 스타일을 일일이 적용 하려고 하니 여간 손이 많이 가는게 아니라서 포기했다. 결국 테마를 놓고 컨텐츠만 옮기는 작업을 하는 것이 옳겠더라.
지난번에 샘플로 만들어 놨던 블로그의 git 저장소에 브랜치를 하나 따놓고 테마를 얹는 작업을 수행했다.
git branch feature/change-themegit switch feature/change-theme이렇게 브랜치를 새로 만들고 바꾼다.
그리고 맘에 드는 테마를 찾아서 적용하면 되는데 아래의 명령을 입력한다.
git remote add theme https://github.com/작성자/테마저장소.gitgit fetch themegit merge theme/main --allow-unrelated-histories이렇게 하면 기존 소스와 충돌이 꽤 많이 발생한다. 난 적용할 테마로 fuwari 로 정했다.
(Fuwari 테마 스크린샷)

충돌이 발생한다고 놀랄 필요 없다. 그냥 충돌이 나는 설정, 레이아웃, 컴포넌트들은 모두 테마 쪽을 쓰면 된다.
git checkout --theirs . # 충돌 파일을 테마 버전으로git add . && git commit
무슨 vim 에디터가 튀어나와서 머지가 되는 파일 목록을 쭉 보여주는데 충돌 파일들은 조만간 정리하도록하고 일단 의존성정리와 관리를 진행하자.
rm -rf node_modules package-lock.jsonnpm install # 잘 설치하다말고 pnpm을 설치하라고 해서 pnpm을 설치한다.npm insatll -g pnpmpnpm install # 패키지 다시 설치npm run dev # 화면 확인npm run build # 빌드 오류 확인 (스키마 오류는 여기서 드러남)아니 Fuwari 테마가 중간에 갑자기 pnpm을 사용해야 한다면서 오류가 발생해서 어쩔 수 없이 pnpm도 설치하고 한 뒤에 의존성을 설치했더니 아래의 화면처럼 의존성 설치가 마무리 되었다.
이렇게 하고 정상적으로 동작하는지 확인해보자.
그래. 한번에 되는 법이 없지. 문제들을 하나씩 해결해가자.
원인을 보면 이 테마의 버전은 Astro 5 버전이고 지금 내가 설치한 Astro는 7 버전 기준이라서 Font 기능이 정상적으로 돌아가지 않아서 발생한 문제였다. 스타터에만 있던 파일은 테마 파일과 겹치지 않아서 병합 때 그대로 남은게 문제였는데 그 중 src/pages/index.astro가 테마의 [...page].astro 대신 / 경로를 차지한다. 이 파일이 BaseHead.astro를 불러오고, 그 안의 <Font>에서 에러가 나는 것을 확인했다. 망할.
문제를 하나씩 해결해보자.

일단 불필요한 파일들을 제거했다.
git checkout -- package-lock.json # 수정분 되돌리기수정한 내용을 되돌리고.
git rm -r \package-lock.json\.vscode/launch.json \public/favicon.ico \public/favicon.svg \src/assets/blog-placeholder-*.jpg \src/assets/fonts \src/components/BaseHead.astro \src/components/FormattedDate.astro \src/components/Header.astro \src/components/HeaderLink.astro \src/consts.ts \src/content.config.ts \src/layouts/BlogPost.astro \src/pages/blog \src/pages/index.astro \src/pages/rss.xml.js \src/styles/global.css \src/content/bloggit commit -m "chore: Astro 스타터 잔여 파일 제거"git에 삭제한 내용을 반영한다. 그리고 다시 패키지 설치.
pnpm installpnpm dev그리고 다시 실행.

테스트로 글도 썼고 정상적으로 테마가 적용된 것을 확인할 수 있었다.
그럼 이제 메인 브랜치로 병합을 진행한다. 아, 병합하기 전에 빌드를 해서 정상적으로 병합이 되는지 확인해보자.
pnpm build잘 적용되었다.
git switch mastergit merge feature/change-themegit log --oneline -5 # 결과 확인
잘 동작한다.
사실 테마를 적용하는게 쉬운 일이 아니었다. 특히나 이번처럼 다른 버전 Astro를 서로 합치는건 무슨 문제가 발생할지 모른다. 그러니 테마를 적용할 때는 해당 테마가 내 블로그와 버전이 같거나 차이가 근소할 때 시도하자.
아니면 나처럼 그냥 테마를 만들어버리던가.
이번 글은 따라한다기 보다 git 으로 새 브랜치로 분기하고 테마를 적용하고, 다시 원래 브랜치와 병합해서 테마를 적용하는 일련의 과정을 보고 이해하라는 뜻으로 작성했으니. 혹시 같은 문제들을 겪는 분들은 도움이 되기를 바란다.
Astro로 블로그 만들기는 여기서 끝!
안녕!!

꼬리말을 불러오는 중...