워드프레스 테마 만들기: html2wp 앱으로 HTML을 테마로 변환하는 방법

HTML로 워드프레스 테마 만들기: 변환 앱 설치

Apple 실리콘(M1 이상)을 탑재한 Mac용 또는 Windows용 html2wp 앱을 내려받아 다른 애플리케이션처럼 설치하세요. Windows 버전은 아직 Preview 단계이며, Linux 버전은 나중에 나옵니다.

처음 열면 "Prepare environment"(환경 준비)를 클릭하세요. 그러면 앱이 필요한 모든 것을 내려받습니다. 이 작업은 한 번만 하며, 시간이 조금 걸립니다.

앱이 작업하려면 무료 프로그램인 Docker Desktop이 필요합니다. Docker가 임시 WordPress를 실행하면 앱이 그곳에 테마를 설치하고 검사합니다. Docker가 없으면 앱이 대신 내려받아 설치 프로그램을 실행합니다. 설치 도중에 컴퓨터가 암호를 물어볼 수 있습니다.

ChatGPT로 로그인

변환 작업은 사용 중인 ChatGPT 구독의 AI가 수행하므로, 크레딧이나 토큰 비용을 저희에게 따로 내지 않습니다.

앱에서 "Connect with ChatGPT"를 클릭하세요. 앱이 9자리 코드를 보여 주고 브라우저에서 OpenAI 페이지를 엽니다. 그 페이지에서 ChatGPT 계정을 선택하거나 로그인하세요.

다음으로 페이지가 "터미널에 표시된" 코드를 요청하면서 Codex CLI를 언급합니다. 정상입니다. html2wp는 Codex를 사용하며, 페이지가 요구하는 코드는 앱에 표시된 코드입니다. 코드를 붙여 넣고(앱에서 코드를 클릭하면 복사됩니다) "Continue"를 클릭하세요. 로그인이 끝나면 앱이 자동으로 갱신됩니다.

새 프로젝트: 워드프레스 테마 만들기에 쓸 HTML

"New project"를 클릭하고 사이트가 들어 있는 폴더나 ZIP을 선택하세요. Lovable, Bolt, v0에서 내보낸 파일, Claude로 만든 디자인, 일반 HTML 사이트 모두 가능합니다. 앱은 사이트 주소(URL)를 받지 않습니다. 사이트를 구성하는 파일이 필요하기 때문입니다.

어떤 페이지가 홈페이지이고 어떤 페이지가 블로그, 글, 상품인지는 앱이 스스로 판단합니다.

그다음 무엇을 얻고 싶은지 선택합니다. 보통은 Flash 또는 Full 모드로 HTML을 WordPress 테마로 변환합니다. WordPress가 필요 없다면 대신 Astro 5 프로젝트를 선택하세요. 이 변환은 더 짧고, 완성된 사이트를 앱에서 바로 Cloudflare Pages에 배포해 무료로 호스팅할 수 있습니다.

Flash 또는 Full: 워드프레스 테마 만들기의 두 가지 방식

Flash는 빠른 변환이며 앱의 기본값입니다. 각 단계를 한 번씩 실행합니다. 메뉴, 블로그, 쇼핑몰, 양식을 인식해서 바로 연결합니다. 검사도 한 번만 실행하며, 그 결과는 보고서에서 볼 수 있습니다. 약 30분이 걸리고, 대부분의 사이트와 가볍게 써 보는 용도에 알맞습니다.

Full은 꼼꼼한 변환입니다. 모든 검사를 실행하고 발견한 오류를 고치려고 시도합니다. 약 1시간이 걸리며 ChatGPT 구독 한도를 더 많이 사용합니다. 그래서 더 복잡한 사이트나, Flash 보고서에 다듬을 항목이 많이 남았을 때 쓸 만합니다.

두 모드 모두 HTML을 쓸 수 있는 WordPress 테마로 변환하고, 남은 문제가 있으면 메모를 붙입니다. 정확한 시간은 페이지 수와 컴퓨터 속도에 따라 달라집니다.

워드프레스 테마 만들기에 쓸 AI 모델 선택

앱에서 AI 모델과 추론 수준("Reasoning effort")을 선택합니다.

• 일반적인 변환에는 Extra high로 설정한 GPT-6-Luna로 충분합니다. 저렴하고, 구독 한도를 적게 쓰며, 대부분의 사이트를 혼자서 처리합니다.
• 무언가를 고쳐야 할 때는 Medium 또는 High로 설정한 GPT-6-Sol을 권장합니다. 예를 들어 Full 변환이나 채팅으로 수정할 때가 그렇습니다.
• GPT-6-Astra는 가장 강력하고 가장 비싼 모델입니다. 평소 작업에는 필요 없지만, Sol로도 풀지 못하는 문제가 있을 때 도움이 됩니다.

변환이 실행 중이 아닐 때는 언제든 모델을 바꿀 수 있습니다. 프로젝트마다 다른 모델을 쓸 수도 있습니다.

워드프레스 테마 만들기 결과를 원본 HTML과 비교하기

변환이 끝나면 앱이 알려 줍니다. 잘 안 된 부분이 있으면 앱이 먼저 스스로 고치려고 시도합니다. 어느 경우든 다듬을 부분에 대한 메모와 함께 항상 쓸 수 있는 테마를 넘겨줍니다.

"Preview" 탭에서 "Open website"를 클릭해 브라우저에서 새 사이트를 보세요. "Compare" 탭은 원본과 변환 결과를 나란히 보여 주고 차이를 퍼센트로 표시합니다. 마음에 들지 않는 부분을 채팅에 입력하면 앱이 고칩니다. 수정이 끝나면 "Make release"로 새 버전을 저장하세요.

자동 검사는 대부분의 차이를 잡아내지만 전부는 아닙니다. 그러니 클라이언트에게 테마를 넘기기 전에 페이지를 직접 훑어보세요. 테마 ZIP은 "Exports" 탭에서 저장하고, WordPress의 외모(Appearance) → 테마 → 새로 추가 → 테마 업로드에서 업로드합니다.

데이터와 개인정보

테마는 저희 서버가 빌드합니다. 하지만 측정, 원본과의 비교, 수정 같은 작업 대부분은 내 컴퓨터에서 실행되고, ChatGPT 계정의 AI가 이를 진행합니다. AI가 다루는 내용은 OpenAI가 사용자 계정의 약관에 따라 처리합니다.

서버로 전송되는 데이터

Astro 프로젝트로 변환된 사이트(페이지, 스타일, 스크립트, 이미지, 글꼴)와 각 페이지에 대한 정보가 전송됩니다. 원본 프로젝트 폴더와 설치된 라이브러리(node_modules)는 전송되지 않습니다. 업로드된 데이터는 48시간 후 자동으로 삭제됩니다. 지문(해시)만 남으며, 이 지문 덕분에 재실행이 한 번의 변환으로 계산됩니다.

암호와 키가 들어 있는 파일

로그인 정보처럼 보이는 파일은 아예 번들에 들어가지 않습니다. .env, 키 파일(.pem, .key, id_rsa), .npmrc, .netrc, .ssh와 .aws 폴더, 개인 키가 들어 있는 모든 파일이 여기에 해당합니다. 앱이 제외한 파일은 모두 보고서에서 이름으로 확인할 수 있습니다.

검사 결과

테마를 테스트한 뒤 앱은 검사 결과만 보냅니다. 어떤 검사를 통과했고 어떤 검사를 통과하지 못했는지, 페이지 수, 원본과의 가장 큰 차이, 실패한 페이지의 짧은 이름(예: "about")입니다. 사이트 주소, 도메인, 코드, 텍스트, 스크린샷, 파일 경로, 라이선스 키, 사이트 이름은 보내지 않습니다.

검사는 내 컴퓨터의 WordPress를 대상으로 실행되며, 저희 서버는 이 WordPress를 볼 수 없습니다. 검사 결과가 없으면 서버는 변환이 중단되지 않았다는 사실만 알 수 있습니다. 그래서 이전 변환이 결과를 보낸 뒤에야 다음 변환이 시작됩니다. 앱은 결과를 자동으로 보냅니다. 전체 설명은 개인정보 페이지에 있습니다.

워드프레스 테마 만들기 후 Visual Edit로 편집하기

HTML에서 WordPress 테마로 변환한 사이트는 실행하는 데 플러그인이 필요 없습니다. 페이지, 블로그, 양식, 메뉴, SEO, 리디렉션이 모두 테마에 들어 있습니다. 리디렉션은 옛 주소를 새 주소로 보냅니다. 예전 링크 /about.html을 연 사람은 /about/에 도착하므로 사이트의 검색 순위가 유지됩니다.

클릭해서 편집하는 기능은 직접 추가하는 WordPress 플러그인인 Visual Edit가 제공합니다. 클릭한 부분만 바뀝니다. 페이지 빌더가 그 아래의 페이지 코드를 다시 만드는 일은 없습니다.

Pro는 요금 페이지에서 판매하는 별도의 연간 라이선스입니다. Free든 Pro든 모든 변환 결과에는 무료 Lite 버전으로 가는 링크가 들어 있습니다. 플러그인을 꺼도 페이지는 계속 표시되고 테마도 그대로 온전히 쓸 수 있습니다.

라이선스, 구독, 베타

재실행

무료 요금제에서는 모든 변환을 합쳐 재실행이 총 5회이고, Pro 라이선스에서는 무제한입니다. 재실행은 같은 사이트를 다시 업로드하는 것입니다. 서버가 지문(해시)으로 이를 알아보므로, 새 변환이 아니라 재실행으로 계산됩니다.

구독 관리와 해지

구독은 구독 관리 페이지에서 관리합니다. 링크는 사이트 푸터와 모든 라이선스 이메일에 있습니다. Paddle 고객 포털에서 구독 해지, 카드 변경, 인보이스 다운로드, 월간 Pro의 연간 전환을 할 수 있습니다. 포털은 구매할 때 쓴 이메일로 보낸 링크로 로그인하므로 암호가 필요 없습니다.

해지하면 다음 갱신이 멈춥니다. 키는 결제한 기간이 끝날 때까지 작동하고, 변환한 테마는 모두 계속 소유하게 됩니다. 해지는 환불이 아닙니다. 환불은 환불 조건을 따릅니다.

베타의 의미

html2wp는 실제 사이트를 변환하며 실제 업무에 쓰이고 있습니다. 앱은 모든 페이지를 원본과 비교하고, 실패한 검사를 하나하나 보고서에 기록하며, 쓸 수 있는 가장 좋은 테마와 부족한 점에 대한 설명을 함께 넘겨줍니다. 자동 검사가 차이를 놓칠 수 있으므로, 클라이언트에게 결과를 약속하기 전에 페이지를 직접 훑어보세요.

변환기 자체에서 버그를 발견하면 플러그인 문서에 나온 방법대로 신고해 주세요. 사람이 직접 읽으며, 수정 사항은 서비스 업데이트로 반영됩니다.