Gumu.kr 리빌딩 기록

2026. 5. 6. · Gugu

이 글은 새 CMS 글과 기존 WordPress 마이그레이션 글의 차이를 확인하기 위한 기록입니다.

현재 리빌딩 방향

Gumu.kr은 기존 WordPress/PHP/DB 기반 구조에서 Astro + MDX 정적 사이트 구조로 전환하는 중입니다.

핵심 목표는 다음과 같습니다.

• 기존 글의 URL은 legacyId, legacyPath로 유지
• 새 글은 /posts/YYYY/MM/slug/ 규칙 사용
• WordPress 업로드 이미지는 로컬 정적 파일로 캐싱
• 검색은 Pagefind 기반 정적 검색으로 처리
• 글 작성/관리는 GitHub OAuth 기반 관리 화면으로 작성
• 댓글은 익명 댓글 대신 Giscus 기반 선택형 구조로 유지

기존 글과 새 글의 차이

기존 글은 WordPress에서 가져온 HTML 본문을 rawHtml로 보존하고, 같은 Content Collection 안에서 렌더링합니다.

새 글은 이 파일처럼 src/content/posts/*.mdx 형식으로 저장되며, Markdown/MDX 문법을 직접 사용할 수 있습니다.

다음 단계

운영 전에는 다음 작업이 남아 있습니다.

1. GitHub 저장소 연결
2. CMS 인증을 GitHub OAuth 중심으로 운영
3. 배포 파이프라인 정리
4. 기존 WordPress와 최종 컷오버 방식 결정