최근에 운영 중인 4개의 블로그를 한곳에 모아주는 나만의 링크 허브 페이지를 블로거(Blogger) 테마를 활용해 멋지게 완성했다. 깔끔하게 정돈된 페이지를 보며 뿌듯해하던 것도 잠시, 게시물과 다양한 디자인 에셋을 관리하는 과정에서 예상치 못한 삽질들이 줄줄이 터지기 시작했다. 역시 개발과 커스텀의 세계는 한 치 앞을 예측할 수 없다는 것을 다시 한번 뼈저리게 깨달았다.
Blogger Compose 에디터가 style 태그를 삼켜버린 사연
가장 먼저 나를 당황하게 만든 것은 열심히 꾸며놓은 게시물의 스타일이 통째로 날아가는 현상이었다. 본문 영역에 직접 <style> 태그를 삽입하고 멋지게 꾸민 뒤 저장했는데, 다시 글을 수정하려고 열어보니 스타일 코드가 흔적도 없이 사라져 있었다. 알고 보니 블로거 에디터의 치명적인 특성 때문이었다.
게시물을 편집하면서 HTML 탭이 아닌 '작성(Compose)' 탭을 단 한 번이라도 거치면, 블로거의 리치 에디터가 <style> 태그 자체를 유효하지 않은 코드로 인식해 자동으로 삭제해 버리는 것이 문제의 원인이었다. 매번 HTML 탭에서만 조심조심 작업하기에는 실수의 위험이 너무 컸다. 결국 나는 이 문제를 근본적으로 해결하기 위해, 모든 HTML 요소에 style 속성을 직접 부여하는 인라인 스타일 방식을 선택했다. 다소 번거롭기는 하지만 에디터를 오가도 코드가 날아가지 않는 가장 안전한 방법이었다.
메모장에서 발생한 한글 깨짐과 UTF-8 BOM의 구원
스타일 문제를 해결하고 나니 이번에는 텍스트 인코딩이 발목을 잡았다. 일부 수정한 템플릿 파일이나 백업 텍스트를 메모장 같은 기본 편집기에서 열었을 때, 한글이 알아볼 수 없는 외계어로 깨져 보이는 현상이 나타났다. 전형적인 글자 깨짐(Mojibake) 오류였다.
원인을 추적해 보니 기존 파일이 바이트 순서 표식(BOM)이 없는 일반 UTF-8 형식으로 저장되어 있어, 윈도우 메모장 등이 다른 인코딩 방식으로 오해한 것이 문제였다. 해결 방법은 생각보다 간단했다. 텍스트 에디터에서 저장할 때 명시적으로 UTF-8 BOM 인코딩을 포함하도록 설정하여 다시 저장하는 것이었다. 인코딩을 바꾼 이후로는 어떤 편집기에서 열어도 한글이 깨끗하게 잘 출력되었다.
Base64 이미지 다이어트: 180KB에서 33KB로 최적화
마지막 삽질은 페이지 로딩 속도와 직결되는 이미지 용량 문제였다. 링크 허브에 사용되는 아이콘들을 외부 호스팅 없이 빠르고 깔끔하게 불러오기 위해 base64 코드로 본문에 직접 박아 넣었다. 그런데 유독 특정 아이콘만 포함되면 페이지 로딩이 미묘하게 무거워지는 느낌이 들었다.
코드를 뜯어보니 아이콘 하나의 용량이 무려 180KB나 차지하고 있었다. 원인은 화면에 실제로 표시되는 아이콘 크기가 44px 정도임에도 불구하고, 256px 크기의 거대한 원본 이미지를 그대로 인코딩해서 사용하고 있었기 때문이었다. 곧바로 원본 이미지를 64px 크기로 리사이징한 뒤 다시 base64로 인코딩하여 적용했다. 그 결과 이미지 용량이 33KB로 대폭 줄어들었고, 허브 페이지의 전체적인 퍼포먼스도 한층 가벼워졌다.
시행착오를 통해 얻은 세 가지 핵심 교훈
이번 링크 허브 구축과 트러블슈팅을 거치며 뼈아프지만 값진 세 가지 교훈을 얻었다. 첫째, 블로거 게시물 본문에서 스타일을 안전하게 유지하려면 에디터 전환 시 날아갈 수 있는 공통 스타일 태그 대신 인라인 스타일을 사용하는 것이 안전하다. 둘째, 로컬 환경에서 텍스트 기반 파일을 다룰 때는 인코딩 오류 방지를 위해 UTF-8 BOM 형식으로 저장하는 습관이 필요하다. 마지막으로, base64 이미지 역시 실제 렌더링되는 크기에 맞춰 철저히 최적화해야 불필요한 네트워크 낭비를 막을 수 있다. 나와 비슷한 문제를 겪고 있는 다른 개발자나 블로거들에게 이 삽질기가 작게나마 도움이 되었으면 좋겠다.