최근 스레드 프로필에 링크를 하나만 걸 수 있는 제약 때문에 고민이 많았다. 내가 운영하는 IssueLog, KidStory, Jin's Lab, IT Story까지 총 4개의 블로그를 한눈에 보여줄 수 있는 링크허브 페이지가 필요했기 때문이다. 처음에는 base64 이미지를 넣은 HTML 파일로 시작해 Blogger 페이지에 붙여넣기를 시도했지만, 결국 기존 Jin's Lab 테마를 베이스로 나만의 전용 테마를 새로 만들기로 결심했다.
이 과정에서 Blogger 테마를 직접 편집하다가 악명 높은 블로거 커스텀 테마 XML 에러 현상을 마주하게 되었다. 오류의 원인을 찾아내고 정상적으로 렌더링이 되기까지 직접 겪은 생생한 삽질 기록과 해결 방법을 공유하고자 한다.
첫 번째 장벽, 저장하자마자 터진 Blogger SAXParseException
테마 코드를 편집기에서 복사해 저장하려는 순간 화면에 org.xml.sax.SAXParseException 에러가 발생했다. 로컬 환경의 순수 HTML에서는 아무런 문제가 없던 코드였기에 처음에는 원인을 알기 어려웠다. 원인은 바로 Blogger 테마가 요구하는 엄격한 XHTML 문법에 있었다.
우리가 흔히 쓰는 일반 HTML과 달리, 블로거 테마는 엄격한 XML 기반이기 때문에 모든 태그가 제대로 닫혀야 한다. 특히 줄바꿈이나 이미지처럼 끝 태그가 없는 태그들을 일반적인 방식으로 방치하면 파서 에러가 난다. 해결을 위해서는 반드시 XHTML 자기종료 태그 형태를 갖춰야 한다.
결국 에디터에서 정규식을 이용해 미종료 태그들을 일괄적으로 찾아내어 끝에 슬래시를 붙여주는 방식으로 일괄 자동 종료 처리했다. 수많은 줄바꿈과 이미지 태그들을 수정하고 나서야 겨우 첫 번째 에러 관문을 통과할 수 있었다.
두 번째 삽질, 조건문과 위젯을 건드렸더니 나타난 백지 현상
문법 오류를 해결하고 나니 이번에는 화면이 온통 하얗게 변하는 백지 현상이 발생했다. 화면 구성 요소를 단순화하기 위해 인덱스(index)와 아이템(item) 페이지를 나누는 조건분기 b:if와 b:else 구문을 임의로 걷어내고 상세 템플릿만 남겼기 때문이다. 게다가 불필요한 광고나 사이드바, 푸터, 헤더 위젯을 통째로 삭제해 버렸다.
가장 큰 실수는 화면 제어를 위해 내 마음대로 새로운 위젯 ID를 만들어 테마 XML에 하드코딩해 넣은 점이었다. 블로거 플랫폼은 b:section b:widget 구조 안에서 새로 나타난 임의의 위젯 ID를 데이터베이스에 자동으로 등록해주지 않는다.
결국 존재하지 않는 위젯 ID를 렌더링하려다 보니 화면 전체가 빈 상태로 출력된 것이었다. 섣부르게 구조를 커스텀하려다가 오히려 화면 전체가 깨지는 결과를 초래했다.
검증된 테마 구조를 활용한 최종 해결책
결국 내가 선택한 최종 해결책은 완전히 밑바닥부터 새로 위젯을 만드는 것을 포기하고, 이미 검증된 기존 Jin's Lab 테마의 구조를 그대로 재사용하는 것이었다. 블로거 테마 규격의 핵심인 b:section b:widget 규칙과 검증된 ID 체계를 유지한 채 스타일과 알맹이만 바꾸는 방식을 택했다.
- XHTML 자기종료 태그 규칙 준수: 모든 태그는 반드시 규칙에 맞게 닫아주어 구문 분석 오류를 예방한다.
- 검증된 기존 테마 뼈대 재사용: 무리하게 새 위젯 ID를 하드코딩하기보다, 이미 안정성이 검증된 기존 테마의 XML 구조를 재활용하여 레이아웃을 안전하게 커스텀한다.
이처럼 기존 테마 구조를 유지하면서 불필요한 스타일과 내부 구성요소만 벼려내는 방식으로 선회하자, 드디어 내가 원하던 4개의 블로그 링크허브 페이지가 완벽하게 화면에 출력되었다. 섣부른 하드코딩보다 플랫폼의 규칙을 따르는 것이 얼마나 중요한지 깨달은 값진 삽질이었다.