WordPress에서 EmDash로 마이그레이션 가이드

게시일 2026-04-01 작성자 EmDash CMS Team

WordPress에서 EmDash로 옮길 때는 마이그레이션을 테마 재현이 아니라 콘텐츠와 스키마 프로젝트로 먼저 다루면 가장 쉽습니다. 콘텐츠를 옮기고 미디어와 구조를 검증한 뒤, 데이터 모델이 안정된 다음에 커스텀 렌더링과 디자인 동등성을 처리합니다.

시작하기 전에

가져오기를 실행하기 전에 어떤 종류의 WordPress 사이트를 옮기는지 파악하세요.

먼저 다음 영역을 검토하세요.

• 표준 포스트와 페이지
• 미디어 첨부
• 커스텀 포스트 타입
• 커스텀 필드와 편집 메타데이터
• 구텐베르크 블록 또는 숏코드가 많은 콘텐츠

단순 발행 사이트는 보통 깔끔하게 가져오지만, 커스텀 블록, 플러그인 생성 필드, 특수 프런트엔드 렌더링에 크게 의존하는 사이트는 가져온 뒤 두 번째 구현 패스가 필요합니다.

가져오기 옵션

WordPress 콘텐츠를 EmDash로 가져오는 합리적인 방법은 두 가지입니다.

WXR 내보내기

파일 기반 마이그레이션 워크플로를 원하면 WXR 내보내기를 사용하세요.

보통 다음에 더 적합합니다.

• 휴대 가능한 내보내기 산출물을 원할 때
• 여러 사람이 소스 내보내기를 검토하거나 보관해야 할 때
• 소스 데이터와 대상 검증 사이에 더 명확한 경계를 원할 때

일반적인 흐름:

1. WordPress 관리자를 엽니다.
2. 사이트 콘텐츠를 WXR 파일로 내보냅니다.
3. 그 내보내기로 EmDash에서 가져오기를 시작합니다.
4. 가져온 항목과 미디어를 검토합니다.

EmDash Exporter 플러그인

라이브 WordPress 인스턴스에서 직접 전송 경로를 원하면 EmDash Exporter 플러그인을 사용하세요.

일반적인 흐름:

1. WordPress 사이트에 플러그인을 설치합니다.
2. 제공하는 보안 내보내기 엔드포인트를 구성합니다.
3. WordPress 애플리케이션 비밀번호로 접근을 보호합니다.
4. 보호된 소스에서 EmDash로 가져오기를 실행합니다.

소스 사이트가 여전히 활발히 관리되면서 내보내기 파일을 주고받기보다 직접 가져오기(pull)를 원할 때 더 적합합니다.

권장 경로

대부분의 팀에게 가장 안전한 순서는 다음과 같습니다.

1. 콘텐츠를 받을 EmDash 사이트를 준비합니다.
2. 가져오기 방법 하나를 선택하고 1차 마이그레이션을 실행합니다.
3. 항목과 미디어가 올바르게 도착했는지 확인합니다.
4. 일반 편집 콘텐츠로 남기면 안 되는 것에 대해 적절한 EmDash 콘텐츠 타입을 만듭니다.
5. 가져온 콘텐츠 구조가 신뢰할 만해진 뒤에만 커스텀 렌더링을 다시 구축합니다.

이 순서는 데이터가 EmDash에서 보이고 검토 가능해진 뒤에야 가장 위험한 작업을 하게 합니다.

가져온 뒤 검증

가져오기가 완료됐는지로 판단하지 마세요. 가져온 콘텐츠가 쓸 수 있는지로 판단하세요.

첫 검증 패스에서 확인할 것:

• 포스트와 페이지가 예상 규모로 존재하는지
• 첨부 미디어가 EmDash 미디어 라이브러리로 들어왔는지
• 제목, 본문, 발행 메타데이터가 합리적인지
• 가져온 뒤에도 편집 관계가 여전히 말이 되는지

이 단계에서는 시각적 세부를 먼저 고치려는 충동을 억제하세요. 콘텐츠 모델이 아직 틀리면 디자인 작업이 비싼 재작업이 됩니다.

커스텀 콘텐츠

WordPress 사이트는 기본 Post와 Page 모델을 넘어서는 경우가 많습니다. 커스텀 포스트 타입을 쓰는 사이트라면 마이그레이션 중 서식 문제가 아니라 스키마 결정으로 다루세요.

EmDash에서는 자체 구조를 가질 만한 콘텐츠에 네이티브 콘텐츠 타입을 만드는 편이 낫습니다. 보통 다음을 검토합니다.

• 어떤 콘텐츠는 표준 편집 항목으로 남길지
• 어떤 콘텐츠는 별도 EmDash 컬렉션이 될지
• 어떤 필드를 본문에 암시적으로 두지 말고 명시적으로 모델링할지

마이그레이션 품질은 여기서 보통 오르내립니다. 기술적으로 WordPress 가져오기는 성공해도 모든 콘텐츠 형태가 일반 항목으로 뭉개지면 약한 EmDash 구현이 될 수 있습니다.

블록과 맞춤 렌더링

커스텀 블록은 의도적으로 다루세요. 옛 사이트가 맞춤 구텐베르크 블록, 숏코드 기반 레이아웃, 플러그인 전용 렌더링에 의존한다면 후속 작업을 예상하세요.

합리적인 접근:

• 먼저 기저 콘텐츠를 가져옵니다
• 이전 후에도 살아남아야 할 렌더링 패턴을 식별합니다
• EmDash 네이티브 도구와 컴포넌트로 해당 부분을 다시 구축합니다

맞춤 블록 동작을 재현해야 한다면 EmDash Block Kit Agent Skill이 관련 시작점입니다.

실용 체크리스트

작업용 마이그레이션 체크리스트로 사용하세요.

• WordPress에서 포스트, 페이지, 미디어, 커스텀 포스트 타입 감사
• WXR 또는 EmDash Exporter 플러그인 중 더 나은 가져오기 경로 결정
• 대상 EmDash 사이트 준비
• 첫 가져오기 실행
• 미디어 전송과 항목 무결성 확인
• 필요한 곳에 EmDash 네이티브 콘텐츠 타입 생성
• 두 번째 구현 패스가 필요한 커스텀 렌더링 식별
• 시각적 동등성을 시도하기 전에 콘텐츠 구조 검토

여전히 계획이 필요한 것

가져오기 경로가 깔끔해도 일부 마이그레이션 작업은 가져오기 도구 밖에 남습니다.

• 리다이렉트
• SEO 동등성 점검
• 필드 정리
• 커스텀 렌더링 동등성
• 롤백과 런치 순서

가져오기는 콘텐츠를 EmDash로 넣습니다. 편집 검토, 스키마 결정, 런치 규율의 필요를 없애지는 않습니다.