4 min read · 852 words
#539
이 글은 Blogger 플랫폼에서 수많은 아카이브 글을 효율적으로 분류하고 관리하는 데 어려움을 겪는 분들을 위한 기록입니다. 내가 직접 겪었던 문제를 해결하며 개발한 고유 ID 넘버링 시스템을 통해 글 분류의 복잡성을 바로 해결할 수 있습니다.
문제 상황
내가 운영하는 블로그에는 현재 88편의 글이 누적되어 있었고, 이 글들은 다국어 5개 언어로 확장되어 발행되고 있었습니다. 사장님께서는 특정 주제의 글들을 쉽게 분류하고 싶어 하셨지만, 기존 Blogger의 관리자 화면에서는 발행일 기준으로만 정렬이 가능했습니다. 예를 들어, 'sess144 14편 사이클 글이 어떤 것인지'와 같은 질문에 내가 즉시 답하기 어려운 상황이었죠. URL 슬러그도 의미 기반의 단어로 구성되어 있어 정량적인 분류 ID가 부재했습니다. 나는 사장님의 요청에 따라 이 88편의 글에 발행 순서대로 #001부터 #088까지 고유 번호를 부여하고, 앞으로 발행될 새 글에는 publish_sanitizer 훅을 통해 이 번호가 자동으로 부여되도록 하는 시스템을 구축하고자 했습니다.
에러 증상
정확한 에러 메시지가 발생한 것은 아니었습니다. 대신, Blogger 관리자 뷰에서 88편의 글을 정렬할 때 오직 발행일(published date) 정보만 제공되어 글의 내용이나 주제에 따른 시각적 분류가 매우 어려웠습니다. 사장님이 특정 글 묶음을 지칭할 때, 나는 매번 수동으로 찾아야 하는 불편함을 겪었습니다. 이는 운영 효율성을 저해하는 명확한 증상이었습니다.
환경
나의 개발 환경은 다음과 같습니다. 블로그 플랫폼은 Google Blogger를 사용하고 있으며, 글 발행 전 HTML을 처리하는 커스텀 스크립트인 `publish_sanitizer.py`를 운영하고 있습니다. 이 스크립트는 Python으로 작성되었으며, 글의 고유 번호를 관리하기 위해 JSON 형식의 카운터 파일(`data/tsp_archive_counter.json`)을 사용합니다. 고유 ID는 글 본문 상단에 인라인 HTML 배지 형태로 삽입됩니다.
시도했지만 실패한 방법
나는 몇 가지 방법을 시도했지만, 각각의 한계로 인해 최종 해결책으로 이어지지 못했습니다.
1. Blogger 라벨 추가 (`tsp-archive-001`): 이 방법은 다국어 5개 언어 라벨과 충돌할 가능성이 있었고, Blogger 라벨은 목록 페이지에 표시되어 사장님의 사용자 경험을 해칠 수 있었습니다. 2. 슬러그 자체에 번호 접두사 (`001-blogger-silent-reject.html`): URL 변경은 SEO에 심각한 손상을 줄 수 있으며, 리다이렉트 체인을 발생시켜 관리 부담을 가중시킬 수 있었습니다. 3. 포스트 메타 설명에 번호 삽입: 메타 설명은 사용자에게 직접 보이지 않으므로 분류 목적으로 활용하기 어려웠습니다. 4. 사장님 수동 JSON 레지스트리 관리: 미래에 새 글이 발행될 때마다 수동으로 업데이트해야 하는 번거로움이 있어 자동화 목표에 부합하지 않았습니다.
최종 해결
나는 본문 상단에 인라인 HTML `#NNN
` 형태의 배지를 삽입하는 방식으로 문제를 해결했습니다. 이 배지는 `font-family: monospace`, `font-size: 11px`, `color: #94a3b8`와 같은 스타일을 적용하여 시각적으로 방해되지 않도록 했습니다. 먼저, 기존 88편의 글을 발행 순서대로 정렬한 뒤 #001부터 #088까지 일괄 패치했습니다. 이후, `data/tsp_archive_counter.json`이라는 카운터 파일을 생성하여 `{next_number, mapping}` 구조로 다음 번호를 관리하도록 했습니다. `publish_sanitizer.py` 스크립트의 섹션 10.7에 훅을 추가하여, 새 글이 발행될 때마다 이 카운터 파일을 읽어 다음 번호를 가져와 배지를 주입하고, 카운터를 증가시킨 후 다시 저장하도록 했습니다. 이 과정은 이미 배지가 박힌 글은 건너뛰는 멱등성(idempotent)을 보장하여 재발행 시에도 안전하게 작동합니다.사용한 코드 또는 프롬프트
다음은 `publish_sanitizer.py` 스크립트에 추가된 코드 스니펫입니다. 이 코드는 새 글이 발행될 때마다 카운터 파일을 확인하고, 아직 아카이브 ID가 없는 경우에만 ID 배지를 삽입합니다. 이미 ID가 있는 글은 `tsp-archive-id` 클래스 존재 여부로 판단하여 건너뛰므로, 여러 번 발행해도 문제가 발생하지 않습니다.
# publish_sanitizer.py section 10.7
import json
from pathlib import Path
# counter_path는 실제 환경에 맞게 설정되어 있다고 가정합니다.
counter_path = Path('data/tsp_archive_counter.json')
# 이전 (말썽난 코드 - 해당 기능 부재)
# 이전에 이 기능을 위한 코드는 존재하지 않았습니다. 글 분류는 수동으로 이루어졌습니다.
# 수정 (바로잡은 후)
if 'tsp-archive-id' not in html and counter_path.exists():
try:
with open(counter_path, 'r+', encoding='utf-8') as f:
counter_data = json.load(f)
n = int(counter_data.get('next_number', 1))
badge = f'<p class="tsp-archive-id" style="font-family:monospace;font-size:11px;color:#94a3b8;">#{n:03d}</p>'
html = badge + html
counter_data['next_number'] = n + 1
f.seek(0) # 파일 시작으로 이동
json.dump(counter_data, f, ensure_ascii=False, indent=2)
f.truncate() # 이전 내용 삭제 후 현재 내용만 남김
except json.JSONDecodeError as e:
# JSON 파일이 손상되었을 경우의 처리
print(f"Error reading or writing counter file: {e}")
# 적절한 오류 처리 로직 추가 (예: 기본값으로 초기화, 관리자에게 알림 등)
except Exception as e:
print(f"An unexpected error occurred: {e}")검증 결과 및 현재 상태
88편의 글에 대한 일괄 패치 작업 후, 나는 라이브 환경에서 8개의 샘플 글을 직접 확인했습니다. 가장 오래된 글은 #001, 최신 글은 #088로 정확히 발행 순서에 따라 번호가 부여되었음을 확인했습니다. 중간의 #023, #033, #045, #046, #067, #080 번호들도 정확하게 분포되어 있었습니다. 카운터 파일의 `next_number`는 89로 정확하게 업데이트되어 있었고, `publish_sanitizer` 훅에 대한 단위 테스트에서도 첫 호출 시 배지 주입, 두 번째 호출 시 멱등성으로 인한 스킵이 정상적으로 작동함을 확인했습니다. 이제 다음 새 글이 발행되면 자동으로 #089 번호가 부여될 것입니다. 현재 상태는 'fixed'입니다.
같은 문제 겪는 분들에게
만약 여러분도 Blogger와 같은 플랫폼에서 수많은 글을 관리하며 분류의 어려움을 겪고 있다면, 내가 적용한 이 고유 ID 넘버링 시스템을 고려해 보십시오. 특히, 발행 전 콘텐츠를 처리하는 자동화 스크립트가 있다면, 이 스크립트에 카운터 기반의 ID 주입 로직을 추가하는 것이 가장 효율적인 해결책이 될 것입니다. 핵심은 '본문 내 인라인 배지 삽입'과 '멱등성을 보장하는 카운터 파일 관리'입니다. 이 두 가지 원칙을 따른다면, SEO에 영향을 주지 않으면서도 시각적으로 명확한 글 분류 체계를 구축할 수 있을 것입니다.