[완결] Series: AstroPaper 수정하다가

이 블로그가 쓰는 AstroPaper 테마를 손본 4편의 기록 — 시리즈 모아보기 기능을 새로 만든 것부터, 목록 대신 최신 편 미리보기만 보여주기로 한 결정, 최종 리뷰가 잡아낸 버그, 독립글 전용 페이지와 nav 재편, 시리즈 배지·목차, 그리고 시리즈 설명이 1편에 고정돼 있던 걸 고치기까지.

• AstroPaper 수정하다가 — 시리즈 페이지, 목록 대신 미리보기 하나만 보여주기로 했다

  18 Jul, 2026

  AstroPaper엔 태그 시스템만 있고 시리즈 개념이 없어서 직접 만들었다. 태그 pill을 그대로 복사해서 시작했는데, 다 만들고 나니 결정할 게 두 개 더 나왔다 — 목록을 어떻게 보여줄지, 완결 표시를 어떻게 할지.

• AstroPaper 수정하다가 2편 — 시리즈 페이지 검증은 다 통과했는데 최종 리뷰가 버그를 잡았다

  19 Jul, 2026

  태스크마다 타입체크와 리뷰를 통과했고, 실제 dev 서버로 열어보고 프로덕션 빌드까지 돌리는 마지막 검증까지 다 통과했다. 그런데 전체 브랜치를 놓고 하는 최종 리뷰에서 진짜 버그(breadcrumb 접기 로직이 series 페이지를 안 챙김)가 하나 나왔다 — 그 검증 자체가 perPage 설정을 잘못 가정하고 있었다.

• AstroPaper 수정하다가 3편 — 항목 개수가 같다고 폭까지 같은 건 아니었다

  31 Aug, 2026

  독립글(시리즈에 안 속한 글)을 모아볼 방법이 없어서 /standalone 페이지를 새로 만들었다. nav에 자리를 만들려고 Archives를 뺐는데, '아이콘 하나 빼고 텍스트 하나 넣으면 항목 수는 같으니 괜찮다'는 계산부터 틀렸다. 구조를 바꾸는 김에 Google Search Console 재색인 걱정도 문서로 확인하고 넘어갔다.

• AstroPaper 수정하다가 4편 — 최신편으로 바꾸는 것도 같은 종류의 문제였다

  1 Sep, 2026

  3편을 발행하자마자 Cloudflare 빌드가 Google Fonts fetch 실패로 죽었다. 그 다음엔 시리즈 글에 상단 배지와 하단 전체 목차를 만들고, 독립글 이전/다음 네비게이션도 독립글끼리만 순환하게 스코프를 좁히다가 방향이 뒤집힌 버그를 하나 잡았다. 마지막엔 시리즈 페이지 설명이 항상 1편에 고정돼 있던 걸 seriesDescription 필드로 고쳤다.