블로그 글 한 편에 표지와 도식 붙이고 발행 기록표 만들기
2026.10.22

소개
이미 써 둔 블로그 글 한 편에 링크 미리보기용 표지 한 장과 도식 한 장을 붙여 보고, 원문과 파생물의 주소와 독자 반응을 한 장에 모으는 발행 기록표(원장)를 만들었습니다. 글을 쓴 뒤 공유 주소가 어떻게 보이는지 확인하지 않았거나, 이미지를 대제목마다 붙여야 하는지 망설이는 분께 도움이 될 것 같습니다.
청강생으로 24기 콘텐츠발행자동화 3주차를 들었습니다. 이안 스터디장은 만든 결과물을 Vercel로 공개하고 내 홈페이지로 모으는 방법을, 조셉 조 공동 스터디장은 콘텐츠를 왜 내 사이트로 모아야 하는지를 다뤘습니다. 강의에서 가져온 기준은 세 가지입니다. 링크는 간판이므로 미리보기가 어떻게 보이는지 확인하고, 올린 뒤에는 분류와 이미지와 기존 자료가 그대로인지 확인하며, 비밀키는 공개 파일에 두지 않는다는 것입니다.
링크는 간판입니다. (조셉 조, 00:47)
이번 주 과제(홈페이지를 만들고 새 자료가 자동 등록되는지 확인하기)는 청강이라 제출하지 않았고 Vercel 배포도 하지 않았습니다. 제 블로그는 이미 GitHub Pages로 공개돼 있어서, 교안 항목의 뜻만 내 블로그에 대어 재 보았습니다. 지난 글에 류웅수_이안_IAN 님이 "표나 코드만으로 이해하기 어려운 관계 한 곳을 골라 도식으로 바꾸면" 좋겠다고 남겨 주셔서 그대로 따랐습니다. 조셉_조 님이 물으신 "노출 수 옆에 어떤 한 줄이 함께 있어야 다음 글의 재료로 쓸 수 있는가"에는 Step 7에서 답했습니다.
측정일은 2026-10-22입니다. 블로그 저장소는 읽기만 했고, 표지와 도식은 저장소 복사본에 입혀 빌드해서 확인했습니다. 원본 글은 바꾸지 않았습니다.
진행 방법
사용 도구: Claude Code, git, curl, Python 3(matplotlib, Pillow, pytest), Jekyll 빌드(복사본에서만)
범위
구분 | 대상 |
|---|---|
블로그 글 | 원격 저장소(origin/main)의 한글 글 14편. 이 가운데 1편은 비공개 설정 |
시제품 대상 | 클라우드 AI 에이전트가 텔레그램을 못 보낼 때 GitHub Actions로 우회한 글 1편 |
링크드인 | 발행 원장( |
스킬 | 블로그 발행 스킬( |
이번 주 산출물 |
|
Step 1. 강의 기준과 측정 항목
강의 말씀을 명령으로 잴 수 있는 항목으로 바꿨습니다. "측정"은 명령으로 센 값이고, "추정"은 제 해석입니다.
강의 기준 | 잴 것 | 구분 |
|---|---|---|
링크는 간판. 카톡에서 썸네일이 나오게 한다(00:16, 00:47) | 글마다 공개 주소의 | 측정 |
올린 뒤 분류, 본문 이미지, 기존 자료를 확인한다(00:26) | 발행 스킬에 공개 주소 확인 단계가 있는가 | 측정 |
| 공개 저장소에 비밀 값 패턴이 있는가 | 측정 |
플랫폼에서 만나고 내 땅에서 머문다(00:36) | 링크드인 발행 가운데 블로그 글 주소가 들어간 발행 수 | 측정 |
한 번에 크게 만들지 말고 필요해서 하나씩 더한다(00:22) | 도식을 붙일 대제목을 어떻게 고르는가 | 추정 |
2주차에 적은 계획 | 여덟 가지의 실행 여부 | 측정 |
Step 2. 2주차 계획의 실행 여부
2주차 사례글 뒤에 적어 둔 다음 주 계획을 파일 수정 시각과 저장소 기록으로 확인했습니다.
cd ~/<내 블로그 저장소> && git fetch -q
git rev-list --count main..origin/main # 0
git log origin/main --since=2026-10-14 --format=%h -- _posts | wc -l # 0 (글을 바꾼 커밋)
git log origin/main --since=2026-10-14 --format='%h %ad %s' --date=short | grep -v "econ-radar:"
# 2e98953 2026-10-22 Google Search Console 소유권 확인 파일 추가
stat -f '%Sm' -t '%F' ~/.claude/skills/blog-post/SKILL.md # 2026-07-01
grep -c "linkedin-archive/drafts" ~/.claude/skills/blog-post/SKILL.md # 0

2주차 계획 여덟 가지에서 이번 주에 한 것은 표지와 도식 시제품, 발행 기록표, 재측정입니다. 스킬 두 줄, 이미지 폴더를 용도 단위로 바꾸는 안, 대시보드 재생성 스크립트는 하지 않았습니다. 스킬 수정은 모든 작업에 영향을 주는 전역 설정(~/.claude)이라 이번에는 남겨 두었고, 나머지 둘은 이번 주에 표지와 도식과 원장에 집중하느라 미뤘습니다. 이미지 폴더는 이번 시제품도 글 단위 폴더(posts/ccr-bridge/)에 두었으니 안이 바뀌지 않은 채 같은 방식이 한 번 더 늘었습니다.
Step 3. 같은 명령의 재측정
2주차에 쓴 측정 스크립트를 복사해 기준일만 옮겨 다시 돌렸습니다. 2주차에 rg가 셸 함수라 0건이 나왔던 문제는 이미 파이썬 검색으로 바뀌어 있습니다.
항목 | 2주차 (10-14) | 3주차 (10-22) |
|---|---|---|
한글 글, 영문 글 | 14편, 13편 | 14편, 13편 |
이미지가 있는 글, 본문 이미지 | 3편, 27장 | 3편, 27장 |
표지를 지정한 글 | 0편 | 0편 |
두 글 이상이 함께 쓴 이미지 | 0장 | 0장 |
갈래가 0인 글 | 7편 | 7편 |
링크드인 원장에서 노출 수치가 적힌 곳 | 1건 | 1건 |
mp4와 이력 문서가 함께 있는 폴더 | 10곳 | 11곳 |
폴더가 한 곳 늘어난 것을 영상 갈래로 읽을 뻔했습니다. 새 폴더를 찾아보니 다른 스터디 회의 녹화였고, 블로그 글을 대본으로 쓴 영상은 1편 그대로입니다. 글을 바꾼 커밋이 0건이므로 원격 저장소의 값이 같은 것은 당연한 결과입니다. 이번 주 변화는 복사본에서만 생깁니다.
Step 4. 공유 주소와 공개 파일 점검
교안의 홈페이지 과제 항목 가운데 내 블로그에 댈 수 있는 것을 잰 결과입니다. 글마다 공개 주소를 열어 og:image를 읽었습니다. 아래 명령은 한 글의 값이고, 스크립트는 14편 전부에 같은 일을 했습니다.
curl -s "<내 사이트>/kr/2026/06/19/<글 주소>/" | grep -o 'property="og:image" content="[^"]*"'
# property="og:image" content="<내 사이트>/assets/home/og-card.png"
git grep -I -l -E 'AKIA[0-9A-Z]{16}|AIza[0-9A-Za-z_-]{35}|sk-[A-Za-z0-9]{20,}|gh[pousr]_[A-Za-z0-9]{30,}' origin/main | wc -l # 0
git ls-tree -r --name-only origin/main | grep -cE '(^|/)\.env' # 0 (추적되는 env 파일)
git show origin/main:.gitignore | grep -c '^\.env' # 0 (.gitignore의 env 항목)

공개 주소가 응답한 글은 13편이고 모두 같은 미리보기 카드(
og-card.png) 한 장을 씁니다. 응답하지 않은 1편은 비공개 설정(published: false)이라 정상입니다.비밀 값 패턴 여섯 종류(AWS, Google, OpenAI 계열, GitHub, Slack, 텔레그램 봇)에 일치한 파일은 0개이고, 추적되는 env 파일도 0개입니다. 다만
.gitignore에 env 항목이 없어서, 나중에 실수로 올릴 때 막아 주는 장치는 없습니다. 이 점검은 패턴 여섯 종류에 한정한 결과입니다.링크드인 발행 원장에서 블로그 개설(2026-05-30) 뒤 발행은 10건이고, 블로그 글 주소가 들어간 발행은 2건, 홈페이지 주소만 들어간 발행은 1건입니다. 조셉 공동 스터디장이 말한 "플랫폼에서 만나고 내 땅에서 머문다"를 이 블로그에 대면, 플랫폼 글 열 건 가운데 내 사이트로 가는 주소를 남긴 글은 두 건입니다.
블로그는 별도 도메인 없이 GitHub Pages 주소를 씁니다(저장소에
CNAME파일이 0개). 강의가 권한 도메인 구입은 하지 않은 상태입니다.
Step 5. 도식을 붙일 대제목 고르기
처음에는 2주차 강의대로 표지 1장과 대제목마다 1장을 붙이려고 했습니다. 이안 스터디장의 제안을 따라, 먼저 대제목마다 표, 코드, 이미지 중 하나라도 이미 있는지를 세어 보았습니다. 글만으로 설명하는 대제목이 도식 후보입니다.

대상 글 한 편은 대제목이 6개이고, 코드가 있는 대제목이 4개, 글만 있는 대제목이 2개("처음엔 토큰 문제인 줄 알았습니다", "이 패턴이 쓸 곳")입니다. 글만 있는 두 곳은 문장으로 충분히 읽혀서 그림이 필요한 곳으로 보이지 않았습니다. 반대로 코드가 있는 "작동하고 나서 발견한 두 번째 버그"에는 커밋 4개의 해시 목록과 HEAD~1 HEAD라는 비교 범위가 코드로만 적혀 있었습니다. 어느 커밋이 어느 비교에 들어가는지는 해시만 봐서는 읽히지 않아, 이 한 곳을 관계 도식 후보로 골랐습니다.
도식은 글에 적힌 설명을 베끼지 않고 실제 저장소에서 읽은 값으로 그리기로 했습니다. 그림을 그리기 전에 검사부터 썼습니다. 참값을 아는 입력을 만들었습니다. 커밋 셋 가운데 첫 커밋에만 vault/push 파일이 있는 임시 저장소에서, 마지막 커밋만 비교하면 못 찾고 push 전체를 비교하면 찾아야 합니다.
cd 실습 && KMP_DUPLICATE_LIB_OK=TRUE OMP_NUM_THREADS=1 python3 -m pytest -q test_blog_visuals.py
# ERROR test_blog_visuals.py ModuleNotFoundError: No module named 'push_window' (구현 전)
# 12 passed in 3.22s (구현 뒤)
검사 12개는 푸시 범위 3개, 대제목 분류 2개, 원장 5개, 표지 계약 2개입니다. 구현 전에는 모듈이 없어 실패하는 것만 확인했고, 개별 검사의 실패까지 본 것은 아닙니다. 대신 구현을 일부러 고장 내 보았습니다. 날짜 정렬 방향을 뒤집고 코드 울타리 안의 ##을 대제목으로 세게 한 두 곳을 모두 검사가 찾아냈습니다.
Step 6. 표지와 도식 만들기
도식은 이 글이 다루는 알림 저장소에서 커밋 네 개와 변경 파일을 git diff --name-only로 읽어 그렸습니다. 읽어 낸 값은 글의 설명과 같았습니다.
b38e97f 변경 파일 10개 (vault/push 포함)
8834dde 변경 파일 1개
027155e 변경 파일 1개
4520dc9 변경 파일 3개
첫 규칙 HEAD~1 HEAD -> vault/push 파일 0개
고친 규칙 before..HEAD -> vault/push 파일 1개 (2026-06-16)

표지는 2주차 강의 기준을 따랐습니다. 바탕 그림에는 글자를 넣지 않고, 제목은 나중에 Pretendard로 얹었습니다. 바탕에 글자가 0개인지도 검사로 걸었습니다. 이미지 생성 도구가 한글을 깨뜨리는 문제를 피하는 방법이기도 합니다.
시제품을 입힌 복사본은 저장소의 원격 최신 판을 임시 폴더에 풀어 만들었고, 빌드는 7초쯤 걸렸습니다. 처음에는 글의 머리말에 image:를 넣었는데 빌드 결과의 og:image가 그대로 사이트 공통 카드였습니다. 이 블로그의 테마(minimal-mistakes)는 header.og_image를 읽어서, 이 줄로 바꾸자 표지로 바뀌었습니다.
cd <복사본> && bundle exec jekyll build -q --destination ../site
grep -o 'property="og:image" content="[^"]*"' ../site/kr/2026/06/19/<글 주소>/index.html
# 처음 (image:) -> .../assets/home/og-card.png
# 고침 (header.og_image) -> .../assets/images/posts/ccr-bridge/cover.png
grep -c 'diagram-push-window' ../site/kr/2026/06/19/<글 주소>/index.html # 1
브라우저로 화면을 열어 보지는 못했고, 빌드된 HTML에서 이미지 태그 1개와 og:image 값을 확인한 범위까지입니다. 반영은 블로그 저장소 수정이고 외부 공개라 하지 않았습니다. 바뀌는 줄은 머리말 세 줄과 이미지 한 줄이며, 차이는 실습/산출/의 diff 파일에 있습니다.
Step 7. 발행 기록표와 반응 칸
이안 님의 제안대로 원문과 파생물의 주소를 한 장에 모으는 원장을 만들었습니다. 칸은 원문, 채널, 주소, 발행일, 노출, 반응, 유입, 독자 한 줄, 가리킨 대목, 다음 글감 열 개이고, 원문과 채널이 같으면 새 줄을 만들지 않고 고칩니다. 같은 명령을 두 번 실행해 파일 해시가 같은 것을 확인했습니다(7줄).
조셉 님의 질문에는 이렇게 답하려고 합니다. 노출 수 옆에 독자가 쓴 말 한 줄을 그대로 옮기고, 그 말이 가리킨 대목(소제목)을 함께 적어야 다음 글의 재료가 됩니다. 숫자는 어느 글이 읽혔는지만 알려 주지만, 말 한 줄과 대목은 무엇을 고치거나 다음에 무엇을 쓸지를 알려 줍니다.
이 칸이 채워지는지를 지난 글의 댓글 두 건으로 시험했습니다. 이안 님의 댓글은 2주차 사례글에서 모든 소제목에 이미지를 붙이는 것이 맞는지 판단할 수 없다고 적은 대목(Step 5)을 가리켰고, 그 한 줄이 이번 주 작업의 출발점이 되었습니다. 반대로 노출과 유입은 링크드인과 지피터스의 통계 화면을 읽어야 해서 비워 두었습니다.

결과와 배운 점
측정 결과
항목 | 2주차 값 | 3주차 값 (원격 저장소) | 시제품 복사본 |
|---|---|---|---|
표지를 지정한 글 | 0편 | 0편 | 1편 |
이미지가 있는 글, 본문 이미지 | 3편, 27장 | 3편, 27장 | 4편, 28장 |
갈래가 0인 글 | 7편 | 7편 | 6편 |
링크 미리보기 카드 종류(응답한 글 13편) | 확인 안 함 | 1종 | 2종 |
글만으로 설명하는 대제목 | 확인 안 함 | 97개 중 67개 | 97개 중 67개(도식을 코드가 있던 대제목에 붙여 변화 없음) |
2주차 계획 여덟 가지 | 완료 3, 일부 1, 미실행 3, 결정 대기 1 | ||
비밀 값 패턴 일치 파일 | 확인 안 함 | 0개 |

배운 점
공유 주소의 얼굴은 글마다 같은 카드 한 장이었습니다. 공개된 글 13편이 모두 사이트 공통 카드를 씁니다. 강의의 "링크는 간판"을 이 블로그에 대면 간판이 하나뿐입니다. 표지 한 장을 붙이는 데서 끝나지 않고, 머리말의 어느 줄이 미리보기를 바꾸는지 빌드 결과로 확인해야 했습니다. 처음 넣은
image:만 믿었다면 바뀌었다고 생각하고 지나갔을 수 있습니다. 이안 스터디장이 "항상 확인해야 한다"고 한 말(00:26)이 이 경우에 해당합니다.이미지는 관계가 읽히지 않는 한 곳에 붙였습니다. 대제목 97개 중 67개가 글만으로 설명하지만 그 67곳이 모두 그림이 필요한 것은 아닙니다. 대상 글에서도 글만 있는 두 곳은 그대로 두었습니다. 그림이 필요했던 곳은 코드가 있는데도 범위가 읽히지 않던 한 곳이었고, 그 한 곳을 실제 저장소에서 읽은 값으로 그렸더니 글의 설명(마지막 두 커밋만 비교하면 놓친다)이 맞는다는 것도 함께 확인됐습니다.
독자 한 줄 칸이 채워지는 것까지 확인했고 효과는 아직 모릅니다. 지난 댓글 두 건이 칸에 들어가고, 그중 하나가 이번 작업으로 이어진 것을 확인했습니다. 독자 말을 적은 원장이 다음 글을 더 잘 고르게 하는지는 반응이 쌓여야 알 수 있습니다.
링크드인 발행 열 건 가운데 블로그 주소가 들어간 것은 두 건입니다. 내 땅에서 머물게 하려면 플랫폼 글이 내 사이트로 가는 길을 남겨야 합니다. 이 비율이 낮다는 것까지가 측정이고, 높이면 유입이 늘어나는지는 모릅니다. 유입 칸이 비어 있어서입니다.
실제 블로그에 반영하는 일은 아직 남았습니다. 스킬 두 줄 추가, 시제품의 글 반영, 링크드인 초안 정리는 이번 주에도 하지 않았습니다. 시제품은 블로그를 건드리지 않고 복사본에서 끝까지 확인할 수 있는 데까지만 했습니다.
시행착오
머리말
image:를 넣고 표지가 적용됐다고 볼 뻔했습니다. 빌드한 HTML에서 값이 그대로였고,header.og_image로 바꿔 해결했습니다.처음 만든 도식은 시간선이 글자를 가로지르고 점선이 설명 글과 겹쳤습니다. PNG를 열어 확인하고 글 위치와 선 위치를 옮겼습니다. 표지도 제목 상자가 그림을 덮어서 바탕 그림의 위치를 아래로 내렸습니다.
같은 주에 영상 폴더가 한 곳 늘어난 것을 갈래로 읽을 뻔했습니다. 새 폴더의 내용을 열어 보고 블로그와 무관하다고 판단했습니다.
블로그를 건드리지 않고 끝낼 수 있는 일부터 하다 보니, 실제 블로그와 설정을 고쳐야 하는 항목이 계속 뒤로 밀리는 것이 보였습니다.
이 측정은 2026-10-22에 git fetch 후 제 블로그 원격 저장소의 한글 글 14편(공개 응답 13편), 제 컴퓨터의 링크드인 발행 원장과 초안 폴더, 블로그 발행 스킬, 이 글이 다룬 알림 저장소의 커밋 4개를 대상으로 잰 결과입니다. 링크드인과 지피터스의 조회 수, 카카오톡에서 실제 미리보기가 뜨는 모습, 브라우저 화면은 확인하지 못했습니다.
도움 받은 글
24기 콘텐츠발행자동화 3주차 강의(이안, 조셉 조): Vercel로 공개하고 홈페이지로 모으는 방법, 카톡 썸네일, 등록 뒤 확인, 키와
.env관리, 내 땅과 빌린 땅. 3주차 교안(과제 문구와 항목)3주차 사례 발표, MJK 님: 강의 내용을 블로그 자동화 도구에 그대로 옮겨 단계형 초안과 글감 보드를 만든 방식. 결과물을 먼저 만든 뒤 검수를 나눠 맡긴 과정이 이번 점검 항목을 고르는 데 참고가 되었습니다
2주차 사례글에 달린 류웅수_이안_IAN 님의 댓글: 표나 코드만으로 이해하기 어려운 관계 한 곳을 도식으로 바꾸고, 원문과 파생물의 주소를 한곳에 남기라는 제안
같은 글에 달린 조셉_조 님의 댓글: 반응 기록 칸에 노출 수 옆에 어떤 한 줄이 필요한지에 대한 질문
로그인하고 댓글을 남겨 주세요
지난 글에 달린 조언을 그대로 따라 도식을 만들고, 받은 질문에 답까지 하신 과정이 정말 멋져요. '링크는 간판'이라는 말처럼 공유 미리보기를 직접 확인하신 것도 좋은 습관이네요.
원문과 파생물의 주소, 독자 반응을 한 장에 모으는 발행 기록표는 꼭 만들어보고 싶어요. 기록표가 쌓이면 어떤 숫자를 보고 다음 글을 고르실지 궁금해요. 청강인데도 매주 꾸준히 측정하시느라 수고 많으셨어요!
지난 댓글의 제안을 실제로 시험하고, 무엇이 달라졌는지 다시 보여주셔서 반갑습니다. 글만 있는 대제목 두 곳은 그대로 두고 코드가 있어도 비교 범위를 읽기 어려웠던 한 곳을 골랐다는 판단이 특히 좋았어요. 이미지 개수보다 독자가 이해하기 어려운 관계가 무엇인지 살펴보신 과정이 잘 드러납니다.
도식을 저장소의 실제 변경 파일로 그린 점도 흥미로웠습니다. 마지막 커밋만 볼 때와 푸시 전체를 볼 때의 차이를 한 장에 놓으니, 해시 목록만으로는 놓치기 쉬운 범위가 설명되겠네요. 일부러 정렬과 분류를 고장 내 검사에 잡히는지 확인한 기록도 테스트 숫자를 이해하는 데 도움이 됐습니다.
원장에 독자의 말 한 줄과 그 말이 가리킨 대목을 함께 둔 답도 공감했습니다. 제 댓글이 이번 작업으로 이어진 것을 이렇게 확인하니, 반응을 다음 실험의 입력으로 쓰는 모습이 구체적으로 보이네요. 노출과 유입은 확인하지 않아 비워 두셨다는 점까지 있어 기록의 의미가 명확합니다.
이제 복사본에서 확인한 표지와 도식을 실제 화면에서 볼 차례가 남았네요. 한 편에서 모바일 본문과 공유 미리보기를 확인하고, 반영 전후를 원장에 붙이면 이번 실험이 한 바퀴 이어지겠습니다. 설정을 고쳐야 하는 일이 뒤로 밀렸다는 관찰도 남겨 주셨으니, 다음에는 그중 한 항목을 작게 마무리하는 변화가 기대됩니다.




Fri-mer님, 안녕하세요.
조셉입니다. ^^
발행한 뒤의 상태까지 직접 챙기며, 글 한 편을 끝내는 기준을 넓혀 가신 점이 좋았습니다. 콘텐츠 자동화가 꾸준히 돌아가려면 만드는 과정과 함께 무엇을 발행했고 무엇을 확인했는지도 남아야 합니다.
표지와 본문 도식을 따로 만들고, 이미지가 들어간 최종 글까지 직접 확인하신 점도 잘하셨습니다.
이미지를 만든 뒤에도 수정할 부분을 짚으며 끝까지 확인하시는 모습에서 꼼꼼함이 느껴졌습니다.
발행 기록표를 만드실 때는 각 확인 날짜에 무엇을 보고 어떤 결정을 할지 한 줄씩 붙여 두시면, 기록이 다음 글을 고치는 데도 쓰일 겁니다.
마지막 질문입니다. 앞으로 기록표에 어떤 변화가 쌓이면, 이 글이 원하던 독자에게 도움이 되고 있다고 판단하시겠습니까? 그리고 이미 만든 글에서 다음 글로 연결하기 위한 콘텐츠 링크는 어떻게 기획하셨을까요?
이번 한 편에서 정리하신 순서가 다음 글을 발행할 때는 한결 수월한 길이 되기를 바랍니다.
4주간 수고하셨습니다. 화이팅입니다~! ^^