gatsby로 이전 했습니다.

다시 시작하기 전에 정한 기준

이 글은 Gatsby로 블로그를 처음 옮긴 시점의 기록이다. 단순히 테마를 바꾸는 일보다 중요했던 것은 예전에 쓴 글과 이미지의 주소를 잃지 않고, 앞으로 글을 쓰는 흐름을 단순하게 만드는 일이었다. 당시에는 설정할 것이 많아 어리숙했지만, 아래 기준을 먼저 정해두니 다음 이전 작업에서도 판단이 훨씬 쉬워졌다.

• 글의 URL은 한 번 정하면 가능한 바꾸지 않는다.
• 이미지와 첨부 파일은 글 본문과 별도로 관리해 배포가 바뀌어도 주소를 유지한다.
• 빌드가 성공하는 것과 검색 엔진이 읽기 좋은 HTML을 만드는 것은 별개로 확인한다.
• 완벽한 구조를 기다리기보다, 새 글을 꾸준히 발행할 수 있는 최소 흐름을 만든다.

왜 정적 블로그를 선택했나

당시에는 서버를 운영하는 부담보다 글을 쓰는 데 집중하고 싶었다. Gatsby는 Markdown 기반 글을 정적 HTML로 만들 수 있어, 배포할 결과물이 단순하고 캐시하기도 편했다. 새 글을 추가하면 빌드와 배포가 다시 실행되는 흐름도 개인 블로그에는 충분했다.

다만 정적 사이트라고 해서 관리가 사라지는 것은 아니었다. 글의 frontmatter, 이미지 경로, 태그, 사이트맵처럼 작은 규칙이 쌓이기 시작했다. 그래서 이전 전에 아래 항목을 체크리스트로 만들었다.

1. 기존 글의 제목·발행일·대표 이미지를 보존한다.
2. 내부 링크가 새 URL을 가리키는지 확인한다.
3. 외부에서 이미 방문하는 주소는 가능한 유지하고, 불가피하면 대체 글로 이동시킨다.
4. 배포 결과에서 제목, 설명, canonical, 사이트맵을 직접 확인한다.

실제로 가장 시간이 든 부분

콘텐츠와 이미지 정리

글 파일을 옮기는 일보다 이미지 경로를 정리하는 데 시간이 더 들었다. 외부 이미지에 의존한 글은 원본이 사라지거나 표시 방식이 바뀔 수 있다. 새 글부터는 가능한 한 사이트 안의 /images/ 경로를 사용하고, 외부 이미지를 사용할 때는 출처와 사용 조건을 함께 기록하기로 했다.

URL과 배포 확인

로컬 미리보기에서 잘 보이더라도 실제 배포 주소가 달라지면 검색과 공유 링크가 깨질 수 있다. 특히 /글주소와 /글주소/처럼 끝 슬래시가 다른 주소가 섞이지 않도록 하나의 형식을 정하고, canonical과 사이트맵도 같은 형식을 쓰도록 맞췄다.

이 기록이 남긴 것

Gatsby로의 이전은 끝이 아니라 콘텐츠를 관리하는 방식의 시작이었다. 이후 블로그를 다른 도구로 옮길 때도 글 자체보다 URL, 이미지, 메타데이터, 검색 신호를 먼저 확인하게 된 계기가 됐다. 다음 플랫폼으로 옮긴 이유와 과정은 Next.js로 이전한 기록과 Astro로 이전한 기록에서 이어서 정리했다.

블로그를 새로 시작하려는 사람에게는 한 가지를 권하고 싶다. 처음부터 모든 기능을 넣기 보다, 글 한 편을 작성해 배포하고 링크를 공유하는 전 과정을 짧게 완성해보자. 그 흐름이 안정되면 검색, 통계, 디자인은 그 다음에 차근차근 더할 수 있다.