[🛠] GitHub Pages 블로그를 다시 작업 가능한 시스템으로 되살리기

✨ GPT-5.5의 요약 　

멈춰 있던 GitHub Pages 블로그를 다시 열고, Daily Review와 AI 대화 아카이브를 분리해 공개 기록 시스템으로 재가동한 기록.

오늘 블로그를 다시 열었다.

그냥 글 하나를 쓰자는 정도가 아니었다. 멈춰 있던 GitHub Pages 블로그를 다시 작업 가능한 상태로 돌려놓는 일이었다.

출발점은 /daily-review/2026-05-25/이었다. 그 글은 다시 매일 기록하겠다는 선언이었고, 동시에 너무 많은 것을 한 번에 품고 있었다. 예비군 사망 사건에 대한 분노, 정치에 대한 혐오, 신앙과 실행에 대한 자기점검, AI를 자기관리 도구로 쓰는 아이디어, 블로그 재개 결심이 전부 한 글 안에 들어가 있었다.

처음에는 그게 맞는 줄 알았다.

재개 첫날이니까, 그날 나를 밀어붙인 대화까지 전부 남기면 된다고 생각했다. 그런데 막상 파일을 보니 이건 Daily Review가 아니었다. 하루 기록이라기보다는 대화 아카이브였다. Daily Review에 몇천 줄짜리 대화 전문을 붙이면, 그 글은 더 이상 매일 이어갈 수 있는 기록이 아니다.

그래서 오늘의 첫 번째 결정은 단순했다.

Daily Review와 AI 대화 아카이브를 분리한다.

조건부터 정했다

블로그를 다시 시작하려면 멋진 선언보다 운영 가능한 구조가 먼저 필요했다.

조건은 이랬다.

• Daily Review는 매일 쓸 수 있을 만큼 가볍게 둔다.
• 긴 AI 대화는 별도 아카이브 글로 분리한다.
• 대화 아카이브는 exporter 덤프처럼 보이지 않게 만든다.
• 욕설과 과격한 표현은 공개용으로 마스킹한다.
• 사용자 발화와 AI 응답을 시각적으로 구분한다.
• 아카이브 목록에서 글의 카테고리가 바로 보이게 한다.
• 모바일에서 코드 블록이나 긴 대화 카드가 화면을 밀어내지 않게 한다.

말로 쓰면 정리 작업처럼 보인다.

하지만 실제로는 블로그 재개를 방해하던 가장 큰 문제를 치우는 작업이었다. 재개 첫 글이 너무 크면 다음 날부터 다시 못 쓴다. 오늘의 핵심은 글을 크게 만드는 게 아니라, 다시 계속 쓸 수 있는 상태를 만드는 것이었다.

대화 전문을 Daily Review에서 꺼냈다

처음에는 /daily-review/2026-05-25/ 안에 대화 전문을 접기 형태로 넣었다.

그런데 이 방식은 금방 한계가 보였다.

Daily Review는 그날의 승패, 산출물, 몸 기록, 도망 기록을 남기는 글이어야 한다. 그런데 그 안에 2,900줄 가까운 대화 전문이 들어가면 글의 성격이 흐려진다. 독자도 헷갈리고, 나도 다음 날 같은 형식을 이어가기 싫어진다.

그래서 대화는 별도 글로 분리했다.

_posts/daily-review/2026-05/2026-05-25-2026-05-25.md
_posts/diary/ai/2026-05-25-reservist-anger-to-blog-restart.md

Daily Review 쪽에서는 거대한 대화 덤프를 줄이고, /diary/ai/reservist-anger-to-blog-restart/를 별도 아카이브로 만들었다.

이게 핵심이었다.

하루 기록은 하루 기록으로 남긴다. 대화 아카이브는 대화 아카이브로 남긴다. 둘을 섞지 않는다.

exporter 덤프를 글처럼 바꿨다

AI 대화 export는 그대로 붙이면 읽기 힘들다.

검색 로그, 만료될 수 있는 이미지 링크, 반복되는 메타 정보, 대화 중간의 잡다한 구조가 섞인다. 그대로 올리면 “기록”은 되지만 “글”은 아니다. 블로그에 남길 수는 있어도 읽히지는 않는다.

그래서 대화 아카이브를 카드 구조로 바꿨다.

<section class="conversation-entry conversation-entry--user">
  <div class="conversation-meta">나 · 2026.05.25 09:12:38</div>
  <div class="conversation-body">
    ...
  </div>
</section>

사용자 발화는 노란색 계열로 강조하고, AI 응답은 더 조용한 배경으로 뒀다. conversation-meta, conversation-body, conversation-mask, conversation-code 같은 클래스를 만들었다. 욕설은 ***로 보이게 남기되, 공개 글에서 그대로 튀어나오지 않게 했다.

이건 단순한 CSS 장식이 아니었다.

대화를 공개 자료로 바꾸는 과정이었다. 원문을 완전히 지워버리지 않으면서도, 블로그 독자가 “어디서 주제가 바뀌었고, 누가 말했고, 왜 이 대화가 재개 선언으로 이어졌는지”를 따라갈 수 있게 만드는 작업이었다.

메타데이터도 다시 정리했다

글을 분리하자 다른 문제가 보였다.

아카이브 목록에서 글 제목과 날짜만 보이면, 이 글이 Daily Review인지 AI 아카이브인지, 개발 일지인지 팁 글인지 바로 감이 오지 않았다. 블로그가 다시 커지려면 목록에서부터 맥락이 보여야 했다.

그래서 _includes/archive-single.html에 카테고리 표시를 붙였다.

daily-review는 오늘 하루는, diary는 일기, ai는 인공지능, github-pages-blog는 GitHub Pages Blog처럼 보이게 매핑했다. 단순히 raw category를 출력하지 않고, 실제 독자가 읽는 이름으로 바꿨다.

처음에는 카테고리 칩을 본문 메타 아래에 붙였지만, 금방 너무 흩어져 보였다. 다시 수정해서 날짜 메타와 카테고리 칩을 같은 줄에 놓았다.

날짜 / 카테고리 칩 / 요약

이 작은 수정으로 아카이브 목록의 정보 밀도가 좋아졌다. 포트폴리오 관점에서도 의미가 있다. 단순히 글을 쓰는 블로그가 아니라, 콘텐츠 타입을 구분하고 탐색성을 개선한 시스템처럼 보이기 때문이다.

모바일에서 깨지는 부분도 바로 잡았다

대화 카드와 코드 블록을 붙이자 모바일 문제가 따라왔다.

긴 문장, 인용, 코드 블록, 복사 버튼이 화면을 밀어내면 블로그는 바로 조잡해 보인다. 특히 Minimal Mistakes의 코드 복사 버튼은 편하지만, 좁은 화면에서는 버튼 자체가 overflow를 만드는 경우가 있었다.

그래서 몇 가지를 바로 잡았다.

.conversation-entry {
  overflow-wrap: break-word;
}

.conversation-body {
  min-width: 0;
}

.clipboard-copy-button {
  overflow: hidden;
}

대화 카드 안의 제목, blockquote, 첫/마지막 문단 margin도 조정했다. 모바일에서는 카드 padding과 내부 제목 크기를 줄였다.

이런 수정은 눈에 잘 띄지 않는다. 하지만 포트폴리오로 보면 오히려 중요하다. 기능을 붙이고 끝낸 게 아니라, 실제 화면에서 깨지는 부분까지 따라가서 다듬었다는 뜻이기 때문이다.

오늘 바뀐 것

오늘 변경은 대략 이렇게 정리된다.

AGENTS.md와 _project/blog-system/README.md로 블로그 운영 규칙 정리
Daily Review에서 대화 전문 제거
AI 대화 아카이브 별도 글 생성
conversation-entry 기반 대화 카드 스타일 추가
욕설 마스킹과 첨부 이미지 생략 규칙 정리
아카이브 목록에 카테고리 칩 추가
날짜 메타와 카테고리 칩 레이아웃 정리
대화 timestamp를 한국식 표기로 통일
모바일 대화 카드와 코드 복사 버튼 overflow 수정

커밋 흐름으로 보면 짧은 시간에 꽤 많은 것을 했다.

d3fb3d5  clean blog project files
1d36a01  clean #87 transcript
1d9ab13  restore #87 toc
ccb9139  archive #87 transcript
310b3af  show archive categories
4579858  refine archive post metadata
fb3516b  localize conversation timestamps
0564866  apply conversation cards
244a4a5  prevent mobile copy-code overflow

한 줄로 요약하면 이렇다.

블로그 재개 선언을 실제 운영 가능한 기록 시스템으로 바꿨다.

결과

오늘 블로그는 다시 열렸다.

하지만 더 중요한 건, 글 하나가 올라간 게 아니라 구조가 다시 잡혔다는 점이다.

Daily Review는 매일 이어갈 수 있는 기록으로 남겼고, 긴 AI 대화는 별도 아카이브로 분리했다. 대화 아카이브는 exporter 덤프가 아니라, 읽을 수 있는 공개 자료로 바꿨다. 아카이브 목록에는 카테고리 맥락을 붙였고, 모바일에서 깨지는 부분도 바로 잡았다.

이 작업은 화려한 기능 추가는 아니다. 하지만 블로그를 다시 살리는 첫 단계로는 정확했다.

내가 다시 쓰려면, 블로그는 감정의 저장소가 아니라 운영 가능한 시스템이어야 한다. 오늘 한 일은 그 시스템의 최소 뼈대를 복구한 것이다.

포트폴리오로 봐도 이 지점이 마음에 든다.

문제는 명확했다. 재개 첫 글이 너무 커져서 매일 기록 시스템을 망가뜨릴 위험이 있었다. 해결은 단순한 삭제가 아니었다. 콘텐츠 타입을 분리하고, UI를 만들고, 메타데이터를 정리하고, 모바일 렌더링까지 다듬었다.

블로그를 다시 시작한다는 말은 쉽다.

오늘은 그 말을 파일 구조, 템플릿, 스타일, 메타데이터, 모바일 화면으로 바꿨다.