path
Jin's Lab
코드로 실험하고 기록하는 개발 일지 · J.Lab

Jin's Lab

코드로 실험하고 기록하는 개발 일지. 커리어와 삶의 방향을 탐색하며 기록하는 공간입니다

Blogger

블로거 게시물 style 태그 사라짐 문제와 인라인 스타일로 해결하는 법

J.Lab ·
목차

    최근에 운영 중인 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 이미지 역시 실제 렌더링되는 크기에 맞춰 철저히 최적화해야 불필요한 네트워크 낭비를 막을 수 있다. 나와 비슷한 문제를 겪고 있는 다른 개발자나 블로거들에게 이 삽질기가 작게나마 도움이 되었으면 좋겠다.

    Blogger HTMLCSS ImageOptimization UTF8Encoding WebDesign
    ← 이전 글
    최근 게시물
    다음 글 →
    이전 게시물
    ≡ 글 목록으로
    소개
    path
    J.Lab

    커리어와 삶의 방향을 탐색하며
    기록하는 공간입니다

    카테고리
    403 Forbidden Error 1 429 Error 1 Ad Exchange 1 Ad Layout Guide 1 ad-slot 1 adsense 2 AdSense 2 AdSense Bot Detection 1 AdSense CTR 1 AdSense Display Issue 1 adsense-optimization 1 AI Automation 1 AI Image Generation 1 ai-automation 2 ai-book-writing 1 ai-image-generation 1 AI-Prompting 1 ai-side-hustle 1 ai-workflow 1 ai-writing 1 AIAutomation 1 AIBlogAutomation 1 AICodeLog 1 AIContentGeneration 1 AIImageGeneration 1 AIWritingErrors 1 API Automation 2 API Retry Design 1 api-automation 1 API-Deprecation 1 api-error 1 api-fallback 1 api-integration 2 api-pagination 1 api-retry-strategy 1 api-troubleshooting 1 APIDebugging 1 APIError 1 APIErrorHandling 1 APIIntegration 3 APIQuotaOptimization 1 APITokenRenewal 1 apps-script-trigger 1 AppsScript 1 appsScriptAutomation 1 AutomatedBlogging 1 automation 5 Automation 4 Automation Queue 1 Automation Scheduler 1 Automation Troubleshooting 1 automation-error 1 automation-script 1 AutomationBug 1 AutomationTroubleshooting 1 Backoff Algorithm 1 Base64 Image 1 Base64Encoding 1 batch-processing 1 BatchProcessing 1 Blog Optimization 2 blog-automation 4 blog-customization 2 blog-migration 4 blog-monetization 1 Blog-Sorting 1 blog-strategy 1 blog-theme-customization 1 blog-workflow 1 blogautomation 1 BlogAutomation 4 Blogger 13 Blogger API 2 Blogger Automation 2 Blogger SEO 1 blogger-api 4 blogger-automation 1 blogger-customization 1 blogger-error-400 1 blogger-labels 1 blogger-seo 1 blogger-theme 1 blogger-theme-debug 1 blogger-tips 1 Blogger-Tips 1 blogger-xml 1 BloggerAPI 7 BloggerAutomation 1 BloggerBypath 1 BloggerCustomization 2 BloggerFavicon 1 BloggerPermalink 1 BloggerTemplate 1 BloggerTemplateEditing 1 BloggerTheme 3 BloggerThemeCustomization 1 BloggerXMLStructure 1 Blogging-Automation 1 BloggingTools 1 BlogQuality 1 BlogSpot 1 Bug Fix 1 bug-fix 1 bug-hunting 1 BWidgetBIncludable 1 card-overlay-css 1 CardClickHandler 1 career-advice 1 CDATA 1 checklist-template 1 clamping-text 1 Claude 1 claude-ai 3 claude-code 2 ClaudeChat 1 ClaudeCode 1 CLIPTokenLimit 1 CloudflareWorkersAI 1 CNAME 1 Code Cleanup 1 Code Integration 1 code-refactoring 1 codelog 1 CodeLog 1 codeRefactoring 1 CodeStack 1 coding-log 2 comment-classification 1 config-pattern 1 Content Strategy 1 Content-Marketing 1 content-monetization 1 content-strategy 1 content-writing 1 contentsequencing 1 ContentStrategy 1 context-management 1 cost-reduction 1 CSS 1 css-axis-rotation 1 css-bug-fix 1 CSS-Debugging 1 css-fix 1 css-flexbox 1 css-layout 3 css-logo 1 css-print 1 css-troubleshooting 1 CSSLayout 1 CSSOverlay 1 Custom Domain 1 custom-theme 1 data-backfill 1 data-parsing 1 data-synchronization 1 data-validation 1 DatabaseDesign 1 DataMigration 1 DataRecovery 1 DataValidation 1 DateInjection 1 debugging 2 Debugging 5 Debugging Log 1 DebuggingLog 1 derived-state 1 detail-page-design 1 dev-journey 2 dev-log 1 Developer-Blog 1 developer-career 1 DeveloperJourney 2 DevJourney 1 DevLog 1 digital-creator 1 digital-products 2 display-none-seo 1 DOM-Inspection 1 dom-manipulation 1 Domain Migration 1 DomainMigration 1 DOMAutomation 1 duplicate-content 1 dynamic-menu 1 ebook-marketing 2 ebook-planning 1 ebook-publishing 5 editing-tips 1 Error Handling 2 error-handling 1 Error-Handling 1 ErrorHandling 2 EventDispatch 1 Execution Timeout 1 ExecutionLimit 1 exponential-backoff 1 FactChecking 1 FallbackSystem 1 FaviconEmbedding 1 Feed-API 1 filesystem 1 Flat Illustration 1 flux-model 1 FluxModel 1 FreeAIImage 1 frontend 1 Frontend 1 frontend-developer 1 frontend-layout 1 frontend-tips 1 FrontEndDev 1 FrontendTips 1 GAS 1 GAS Blogger API 1 GAS Refactoring 1 GAS Trigger 1 gas-automation 2 gas-optimization 1 gas-trigger 1 GASTimeout 1 gasTriggerManagement 1 GCP Project Linkage 1 Gemini 1 Gemini API 2 gemini-api 1 GeminiAPI 3 GeminiPrompt 1 GeminiPromptEngineering 1 getBoundingClientRect 1 github-raw-url 1 GmailRestrictions 1 Google AdSense 1 Google Apps Script 12 Google Discover 1 google-apps-script 8 Google-Apps-Script 1 google-blogger 1 googleAppsScript 1 GoogleAppsScript 12 googlesapps-script 1 GoogleSearchConsole 1 grep 1 hero-image 1 hero-image-validation 1 HTML Fix 1 HTMLCSS 1 HTMLWidgetBlogger 1 http-429 1 HuggingFace 1 HuggingFaceAPI 1 ico-generator 1 Image Optimization 1 image-automation 2 image-generation 1 image-hosting 1 image-optimization 1 image-processing 1 image-upload 1 ImageGeneration 2 ImageIntegrity 1 ImageOptimization 1 In-App Browser 1 invalid-argument 1 javascript 4 JavaScript 4 javascript-automation 1 javascript-toc 1 JavaScriptDevLog 1 JavaScriptInjection 1 jlab-codelog 1 JLabDevLog 1 json-schema 1 label-length-limit 1 lead-magnet 1 legacy-code 1 LinkedIn-API 2 LinkedIn-OAuth 1 LinkHub 1 linux 1 markdown 1 meta-description 1 MetaTags 1 Migration 1 Migration Script 1 mobile-friendly 1 Mobile-Web 1 monetization 1 Monitoring Automation 1 MultilingualSEO 1 NakedDomain 1 Negative Prompt 1 node-js 1 nodejs-automation 1 noindex-tag 1 Notion API 1 notion-api 3 notion-database 2 notion-gas-integration 1 notion-setup 1 notion-template 1 NotionAPI 3 NotionAutomation 1 notionintegration 1 NotionIntegration 1 OAuth Scope 1 OpenGraph 1 padding-overlap 1 pagination 1 payload-validation 1 pdf-generation 1 pdf-publishing 1 pdf-selling 1 permalink-management 1 PersonaDesign 1 pil-image-processing 1 Pinterest 2 PinterestAutomation 1 PipelineFix 1 playwright 1 Pollinations 1 Pollinations Flux 1 pollinations-ai 1 pollinations-api 2 PollinationsAI 1 PositionAbsolute 1 post-queue 1 productivity-tools 1 Prompt Design 1 Prompt Engineering 1 prompt-engineering 3 Prompt-Engineering 1 prompt-validation 1 PromptEngineering 3 Publishing Flow 1 publishorder 1 python-favicon 1 python-markdown 1 python-pil 2 python-scripting 1 Queue Design 1 queue-pattern 1 queue-stuck 1 RandomDelay 1 rate-limiting 1 react 1 React 1 Refactoring 1 Resource Exhausted 1 responsive-ads 1 responsive-design 4 ResponsiveCSS 1 ResponsiveDesign 1 retrospective 1 rfc3339 2 Robots Meta Tag 1 RSS Feed 1 rss-feed 1 RSSProxy 2 SAXParseException 1 Script Authorization 1 scriptNotFound 1 SDXL 1 Search Engine Optimization 2 Search-Engine-Optimization 1 SearchConsole 1 Self Rescheduling Trigger 1 SEO 2 SEO Tips 1 seo-optimization 5 SEO-Optimization 1 SEOOptimization 2 seriesmanagement 1 serverless-automation 1 sessionstart-hook 1 shell-script 1 Side Ad Duplication 1 side-income 1 side-project 1 SidebarLinks 1 SNSMarketing 1 Social-Media-Automation 2 SocialSharing 1 state-management 1 StaticWebPage 1 sub-agent 1 SVG Icon 1 svg-mask 1 SVGIcon 1 Synchronization 1 table-of-contents 1 tech-blogging 1 TechJournal 1 TechVibe 1 Template 1 TextSanitization 1 threads-api 2 Threads-API-Comparison 1 ThreadsAPI 3 time-driven-trigger 1 Tistory 2 tistory-customization 1 tistory-migration 1 tistory-skin 1 tistory-theming 1 tistory-tips 1 TOC Ad Placement 1 token-optimization 1 TranslationAPI 1 transparent-favicon 1 triggerCleanup 1 troubleshooting 2 Troubleshooting 2 typesetting 1 ui-optimization 1 unzip 1 URL Slug 1 UrlFetchApp 1 usememo 1 UTF8Encoding 1 vanilla-js 1 Web Development 2 Web Publishing 2 Web Security 1 web-development 7 Web-Development 2 web-development-log 1 web-development-tips 1 web-layout 1 Web-Layout 1 web-performance 1 web-publisher 1 web-scraping 1 WebAccessibility 1 WebAutomation 1 WebDebugging 1 WebDesign 2 WebDevelopment 10 WebDevelopmentTips 1 WebDevJourney 1 WebMigration 1 windows 1 windows-task-scheduler 2 WorkAutomation 1 workflow-automation 1 WorkflowAutomation 1 writing-process 1 XHTML 1 XMLCustomization 1 XMLParser 1 XMLSpecialCharacters 1 XMLTheme 1 z-index-issue 1 zip 1
    인기 글
    GAS에서 Blogger API 403 오류 완전 정복 — appsscript.json 스코프와 GCP 프로젝트 연결
    GAS에서 Blogger API 403 오류 완전 정복 — appsscript.json 스코프와 GCP 프로젝트 연결
    GAS 트리거 방치했다가 오류 폭탄 맞은 이야기 — 함수명 바꿀 때 트리거도 꼭 같이 정리하세요
    GAS 트리거 방치했다가 오류 폭탄 맞은 이야기 — 함수명 바꿀 때 트리거도 꼭 같이 정리하세요
    Notion API page_size 함정 — 우선순위 항목이 조회에서 빠지는 이유와 해결법
    Notion API page_size 함정 — 우선순위 항목이 조회에서 빠지는 이유와 해결법
    다른 블로그
    IssueLog
    IssueLog
    issuelog.jinbytes.com
    KidStory
    KidStory
    kidstory.jinbytes.com
    IT Story
    IT Story
    jinbytes.com
    이야기하는 밤
    이야기하는 밤
    story.jinbytes.com
    [eBook] 개발자로 살아간다는 것
    [eBook] 개발자로 살아간다는 것
    유료 전자책
    [eBook] FE 실무 디테일
    [eBook] FE 실무 디테일
    유료 전자책
    [미니북] FE 실무 디테일
    [미니북] FE 실무 디테일
    무료 미니북
    © Jin's Lab · J.Lab · All Rights Reserved
    jinbytes.com · Powered by Blogger