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

Jin's Lab

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

Blogger

Blogger 반응형 여백 디버깅으로 알아낸 CSS 레이아웃 함정

J.Lab ·
목차

    최근 블로그의 반응형 레이아웃을 다듬던 중 기묘한 현상을 발견했다. 태블릿이나 모바일 환경을 모사한 768px 이하 화면에서 본문 콘텐츠 영역의 여백이 어딘가 어색해 보였다. 대충 눈으로 보기에는 좌우 대칭인 것 같았지만, 실제로 정밀하게 확인해 보니 좌우와 상하 여백이 제각각으로 놀고 있었다.

    이 미세한 어긋남을 그냥 넘기기엔 내 성격상 허락하지 않았다. 결국 소매를 걷어붙이고 본격적인 Blogger 반응형 여백 디버깅 작업에 착수하게 되었다.

    노트북과 모바일 화면의 반응형 레이아웃을 정밀하게 디버깅하는 과정을 표현한 아이소메트릭 일러스트

    눈대중의 배신과 getBoundingClientRect 디버깅

    처음에는 단순히 브라우저 개발자 도구의 모바일 프리뷰를 켜고 스크린샷을 찍어 확인했다. 스크린샷 상으로는 좌우 여백이 얼추 비슷해 보이는 착시가 발생해 정확한 원인을 찾기 어려웠다. 눈대중에 의존하는 디버깅은 시간만 낭비할 뿐이라는 생각이 들었다.

    이를 확실하게 검증하기 위해 조금 정밀한 디버깅 방식을 적용하기로 했다. 우선 개발자 도구 콘솔에서 현재 페이지와 동일한 출처(same-origin)의 iframe을 768px 너비로 띄웠다. 그리고 자바스크립트의 getBoundingClientRect() 메서드를 활용해 각 레이어의 정확한 수치를 구했다.

    정밀 측정 결과는 생각보다 충격적이었다. 콘텐츠 영역의 실제 여백이 좌 39px, 우 39px, 상 28px, 하 52px로 완전히 제각각 흩어져 있었기 때문이다. .jp-wrap부터 시작해 그 하위의 .jp-body, .jp-postlist로 이어지는 각 레이어의 인셋(Inset) 값을 숫자로 추적하고 나서야 문제의 실체가 보였다.

    CSS 마진과 패딩 레이아웃의 기하학적 치수를 수치로 측정하는 디버깅 작업을 형상화한 그래픽

    Blogger가 자동으로 주입한 15px의 비밀

    왜 하필 좌우 여백이 39px라는 애매한 숫자가 나왔을까 고민에 빠졌다. 내가 코드에 지정한 .jp-wrap의 패딩은 분명히 24px였다. 그렇다면 남은 15px가 어디선가 굴러들어 왔다는 뜻인데, 과거 링크허브 페이지를 작업할 때 겪었던 동일한 패턴이 머리를 스쳤다.

    원인은 Blogger 플랫폼 특유의 숨겨진 기본 스타일 때문이었다. Blogger는 템플릿 코드에서 showaddelement='yes' 속성이 들어간 섹션(나의 경우 #main.section)에 자동으로 15px의 마진(margin)을 주입한다. 이 문서화되지 않은 기본 마진 15px가 내가 직접 설정한 패딩 24px와 더해지면서 39px라는 해괴한 숫자를 만들어 낸 것이다.

    이것이 반응형 레이아웃에서 여백이 들쭉날쭉해 보였던 근본적인 원인이었다. CSS margin 디버깅을 진행할 때는 내가 작성하지 않은 외부 플랫폼의 주입 스타일까지 꼼꼼히 살피는 시야가 필요하다는 사실을 다시금 절감했다.

    삽질의 연속, 강제 제거와 패딩 조정이 남긴 버그

    원인을 규명했으니 해결하는 일만 남았다고 생각하며 가볍게 첫 번째 시도를 해보았다. 문제의 주범인 Blogger의 자동 주입 마진을 없애기 위해 #main.section { margin: 0 !important; }를 스타일시트에 추가해 보았다. 하지만 화면을 새로고침하자마자 모바일을 포함한 모든 화면 크기에서 가로 스크롤바가 생기는 대참사가 발생하여 급히 코드를 롤백했다.

    두 번째 시도로는 합산되는 수치를 맞추는 보정 방식을 택했다. 기존 패딩 24px를 5px로 줄이면, Blogger가 주입하는 15px 마진과 더해져 총 20px로 보기 좋은 여백이 될 것이라 생각했다. 하지만 이 역시 브라우저의 너비 계산식과 얽히면서 가로 스크롤 현상이 재현되었고, 결국 이 시도 역시 허사로 돌아갔다.

    Blogger의 특정 영역 마진을 무리하게 강제 제거하거나 패딩으로 보정하려는 시도가 도리어 레이아웃의 가로폭 계산을 망가뜨리는 새로운 버그를 유발한 것이다. 단순한 수정이 되려 복잡한 문제를 키울 수 있음을 보여주는 삽질의 과정이었다.

    반응형 웹디자인이 잘 정렬된 모니터 화면을 깔끔하게 나타낸 3D 아이소메트릭 이미지

    결국 최고의 해결책은 원상복구였다

    여러 번의 시행착오 끝에 나는 무리한 수정 대신 안전한 길을 택하기로 했다. 기존에 건드렸던 @media(max-width:960px) 제어 블록을 완전히 원상태로 되돌렸고, 오직 레이아웃 정렬을 위해 필요했던 align-items 수정 코드만 남겨두었다. 쓸데없는 마진 억제 코드를 모두 걷어낸 것이다.

    이렇게 코드를 롤백한 뒤, 요청한 사용자가 화면을 새로고침하여 정상적으로 잘 출력되는 모습을 확인해 주었다. 우려했던 반응형 레이아웃 왜곡이나 스크롤 오류 없이 깔끔하게 렌더링되고 있었기에 추가 수정 없이 최종 완료 처리를 지었다.

    이번 디버깅을 통해 모든 버그를 코드로 뜯어고쳐야 하는 것은 아니라는 귀중한 실전 교훈을 얻었다. 때로는 어떤 플랫폼의 기본 규칙을 억지로 깨뜨리며 수정하는 것보다, 부작용을 최소화하기 위해 그대로 유지하는 편이 훨씬 이롭다. 원인을 명확하게 찾아냈음에도 건드리지 않는 것이 최선의 해결책이 될 수 있다는 점을 항상 명심해야겠다.

    Blogger CodeStack CSS Debugging ResponsiveDesign WebDevelopment
    ← 이전 글
    최근 게시물
    다음 글 →
    이전 게시물
    ≡ 글 목록으로
    소개
    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