다-메세톡 블로그, 드디어 정상화 완료- 블로그 홈판 구축하라
블로그를 처음 만들 때는 생각보다 자잘한 문제가 많았습니다.
테마는 적용됐는데 메인 화면이 비어 보이거나, 글이 바로 노출되지 않아서 어디를 먼저 손봐야 할지 헷갈리기도 했습니다.
이번에 하나씩 구조를 정리하면서 드디어 기본 블로그 형태가 정상적으로 보이기 시작했습니다.
이 글은 블로그를 정상화하면서 확인했던 핵심 포인트를 간단히 정리한 기록입니다.
title: “다-메세톡 블로그, 드디어 정상화 완료- 블로그 홈판 구축하라” date: 2026-04-01 09:00:00 +0900 categories: [blog] tags: [chirpy, github-pages, jekyll] —
블로그를 처음 만들 때는 생각보다 자잘한 문제가 많았습니다.
테마는 적용됐는데 메인 화면이 비어 보이거나, 글이 바로 노출되지 않아서
어디를 먼저 손봐야 할지 헷갈리기도 했습니다.
이번에 하나씩 구조를 정리하면서 드디어 기본 블로그 형태가 정상적으로 보이기 시작했습니다.
이 글은 블로그를 정상화하면서 확인했던 핵심 포인트를 간단히 정리한 기록입니다.
지금까지의 난관들
1. 홈 화면이 텅 비어 보이던 시절
처음 Chirpy 테마를 올렸을 때,
사이드바와 헤더는 나오는데 정작 중앙 Home 영역이 비어 있어 당황했습니다.
_posts폴더에 글이 없거나- 파일명이
YYYY-MM-DD-slug.md규칙을 지키지 않으면
홈이 비어 보일 수 있다는 사실을 뒤늦게 깨달았습니다.
첫 테스트 포스트를 제대로 된 파일명과 Front Matter로 만들고 나서야
비로소 홈에 글이 보이기 시작했습니다.
2. 잘못된 include 한 줄이 빌드를 모두 멈추게 한 사건
Google AdSense 예시 코드를 정리하다가
<script async src="https://pagead2.googlesyndication.com/pagead/js/adsbygoogle.js?client=ca-pub-1372015701075050" crossorigin="anonymous"></script> <ins class="adsbygoogle" style="display:block" data-ad-format="fluid" data-ad-layout-key="-fb+5w+4e-db+86" data-ad-client="ca-pub-1372015701075050" data-ad-slot="3855664340"></ins> <script> (adsbygoogle = window.adsbygoogle || []).push({}); </script> 한 줄 때문에
GitHub Actions 빌드가 계속 실패하는 일을 겪었습니다.
_includes에 실제 파일이 없는데 include를 걸어 두었고- 가이드용 예시를 코드블록이 아닌 “실행 코드”로 넣어 놓은 것이 문제였습니다.
결국 예제는 전부 마크다운 코드블록으로 옮기고,
레이아웃 파일에서 해당 include를 제거하면서 빌드 에러가 사라졌습니다.
3. _config.yml 작은 오타의 위력
_config.yml 을 고치다가 콜론 하나, 들여쓰기 한 칸을 잘못 넣어서
사이트 전체 빌드가 깨지는 경험도 했습니다.
url,baseurl,timezone,lang등 기본 항목을 정리하면서
항상 수정 → 커밋 → Actions 로그 확인까지 세트로 보는 습관을 들이게 된 계기였습니다.
네블로그 홈판을 어떻게 구축했는가
지금 보이는 홈 화면이 만들어지기까지 실제로 거쳤던 단계는 대략 이렇습니다.
- Chirpy 스타터 템플릿으로 새 저장소 생성
→ 불필요한 파일은 그대로 두고, 우선 기본 구조부터 이해했습니다. _config.yml에서 사이트 정보와url/baseurl/timezone정리
→ 도메인과 시간대가 맞으니 포스트 날짜와 링크가 안정됐습니다.- 테스트 포스트 여러 개 작성
→ 홈이 비어 보이지 않도록 최소 몇 개의 글을 먼저 쌓았습니다. - 이미지·자산 구조 정리 (
assets/img/posts/...)
→ 본문 이미지와 대표 이미지를 한 폴더에서 관리하게 했습니다. - 광고/예제 코드 때문에 생기던 include 에러 제거
→ 예시는 모두 코드블록으로, 실제 include는_includes파일이 준비됐을 때만 사용.
이 과정을 반복하면서
“일단 블로그가 안정적으로 돌아가는 상태”를 먼저 만든 뒤,
그 위에 홈 커스터마이징과 글 정리를 올리는 방향으로 생각이 정리되었습니다.
앞으로 이 블로그에서 할 것들
이제 기본 뼈대가 잡혔으니, 다음 단계는 콘텐츠와 운영입니다.
- Chirpy + GitHub Pages 세팅 과정과 트러블슈팅 기록
- Jekyll 설정(
_config.yml,_posts, assets 구조) 실전 팁 - 홈/포스트 레이아웃 커스터마이징, 수익화(AdSense) 시도 과정
처음 이 글을 읽는 분들은
“나도 지금 저 문제들 때문에 막혀 있다”는 상태일 가능성이 큽니다.
이 블로그가 그런 분들에게 작은 힌트와 동기부여가 되는 공간이 되도록
앞으로도 시행착오를 꾸준히 기록해 보려 합니다.