birchholt 직접 해보고 남기는 기록

운영 기록

이 자리에 모인 글은 전부 제가 직접 걸려서 재본 것들입니다. 읽고 정리한 것이 아니라, 안 되는 화면을 앞에 두고 원인을 찾을 때까지 재본 기록입니다. 그래서 주제가 예쁘게 이어지지 않습니다. 티스토리 스킨 치환자 이야기 다음에 GitHub Actions 스케줄 이야기가 오고, 그 다음이 다시 도메인 이야기입니다. 막힌 순서대로 쌓았기 때문입니다.

쓸 때 지키는 것이 세 가지 있습니다. 첫째, 숫자는 어떻게 쟀는지 같이 적습니다. “느리다"가 아니라 몇 초였고 무엇으로 쟀는지를 적습니다. 둘째, 틀렸던 것은 지우지 않고 정정합니다. 처음에 세운 가설이 실측에서 깨지면 그 과정을 남깁니다 — 틀린 경로를 지워버리면 다음 사람이 같은 곳에 다시 들어갑니다. 셋째, 확인하지 못한 것은 확인하지 못했다고 적습니다. 그럴듯하게 채우면 읽는 사람이 검증하는 데 드는 시간이 제가 아낀 시간보다 커집니다.

공식 문서가 이미 잘 설명하는 것은 여기 없습니다. 문서와 실제가 어긋난 지점, 문서 문장을 제가 잘못 읽었던 지점, 그리고 로컬에서는 멀쩡한데 라이브에서만 깨지던 것들이 남았습니다. 같은 데서 막힌 사람이 검색으로 닿기를 바라며 적습니다.

2026년 10월 · Hugo

Hugo RSS에 lastBuildDate가 없고, 개인정보처리방침이 0001년 글로 섞여 있었습니다

Hugo 기본 RSS는 홈 페이지의 날짜가 비면 lastBuildDate를 빼는데, git 정보를 켜고 _index.md를 커밋하면 그 날짜가 빕니다. 날짜 없는 페이지가 0001년으로 피드에 들어가는 문제와 함께 내장 템플릿을 덮어써 고쳤습니다.

읽기 →
2026년 10월 · Cloudflare

Cloudflare Pages에 www를 붙였더니 522가 났습니다 — DNS만으로는 안 됩니다

www 레코드를 하나 추가했더니 522가 0.2초 만에 돌아왔습니다. Pages에 도메인을 따로 등록해야 열리고, 열린 www는 apex의 사본입니다. DNS, Pages, 리다이렉트 규칙을 한 단계씩 걸며 직접 쟀습니다.

읽기 →
2026년 10월 · Hugo

Hugo 한국어 제목의 목차 링크가 #원인--파일 처럼 하이픈 두 개로 나왔습니다

Hugo의 autoIDType 세 값(github, github-ascii, blackfriday)으로 같은 한국어 제목을 빌드해 id와 목차 링크를 비교했습니다. 공유 주소가 인코딩되는 모습과 {#id}로 고정하는 법까지 확인했습니다.

읽기 →
2026년 10월 · Cloudflare

Cloudflare Pages에서 끝 슬래시 없는 링크가 308을 한 번 더 타고 있었는지 확인했습니다

제 Cloudflare Pages 사이트에서 /posts/x 는 /posts/x/ 로 308 리다이렉트됐습니다. 로컬에서는 드러나지 않는 이 한 홉을 Hugo 빌드 결과물에서 찾는 검사를 만들고, 틀린 링크를 일부러 넣어 잡히는지 확인했습니다.

읽기 →
2026년 10월 · Hugo

글을 고쳤는데 sitemap 의 lastmod 가 발행일에 멈춰 있었습니다

Hugo 에서 enableGitInfo 를 켜고 Actions 의 fetch-depth: 0 을 짝으로 맞춰야 sitemap lastmod 가 커밋 시각이 됩니다. 얕은 클론과 목록 페이지에서 걸린 것까지 재서 적었습니다.

읽기 →
2026년 10월 · Hugo

Sveltia CMS가 선언 안 한 프론트매터 키를 지운다고 적어뒀는데, 지우는 쪽은 따로 있었습니다

config.yml에 안 적은 키는 저장할 때 사라진다고 주석까지 달아뒀습니다. 코드를 직접 돌려보니 그 키는 남았고, 값이 실제로 망가지는 건 위젯을 잘못 골라 선언했을 때였습니다.

읽기 →