birchholt 직접 해보고 남기는 기록

운영 기록

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

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

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

2026년 10월 · Cloudflare

Cloudflare Pages 미리보기 배포에서 링크를 누르면 운영 사이트로 넘어갑니다

템플릿이 절대 주소를 쓰면 미리보기 배포의 링크와 CSS가 운영 도메인을 가리켜 404가 납니다. Hugo baseURL을 배포마다 바꾸는 법과, CF_PAGES_URL에 기댈 수 없는 직접 업로드에서 주소를 계산하는 스텝을 재서 정리했습니다.

읽기 →
2026년 10월 · Hugo

예전 글의 틀린 문장을 고쳤는데, 독자에게 남은 건 「9월 갱신」 한 줄이었습니다

블로그 글을 고친 뒤 화면의 갱신일, 구조화 데이터 dateModified, sitemap lastmod를 18편에서 맞춰 봤습니다. 날짜는 셋 다 맞았지만 무엇을 고쳤는지는 어디에도 없어서 정정 내역을 남기는 틀을 만들었습니다.

읽기 →
2026년 10월 · Hugo

오늘 날짜로 쓴 Hugo 글이 아침 9시까지 안 보입니다 — timeZone을 넣고 시각별로 재 봤습니다

시각 없이 date만 적은 Hugo 글은 한국 시각 09:00 전까지 빌드에서 빠집니다. timeZone을 넣으면 무엇이 바뀌고 무엇이 안 바뀌는지, 빌드 시각을 고정해 두 설정으로 재 봤습니다.

읽기 →
2026년 10월 · Hugo

Hugo 이미지 render hook에서 figure를 냈더니 p 안에 들어가 있었습니다

render-image.html에서 figure를 내면 Hugo는 기본값으로 그걸 p로 감쌉니다. 설정 한 줄과 .IsBlock 분기로 132개를 0개로 만들었고, 링크로 감싼 이미지는 그래도 남는다는 걸 확인했습니다.

읽기 →
2026년 10월 · Hugo

Hugo sitemap에서 페이지 하나를 뺐는데, 어떤 표기는 경고 없이 무시됐습니다

Hugo의 sitemap.disable을 표기 13가지, 섹션·cascade·커스텀 템플릿 조합으로 빌드해 봤습니다. 빠지는 경우와 경고 없이 무시되는 경우, sitemap에서 빠져도 색인은 막지 못한다는 점을 정리했습니다.

읽기 →
2026년 10월 · Hugo

출처로 걸어둔 외부 링크가 죽어도 블로그는 아무 말을 하지 않았습니다

Hugo 빌드 결과물 전체를 lychee로 훑었습니다. 외부 링크 76개 중 에러는 1건이었는데 죽은 링크가 아니었고, 정작 봐야 할 것은 OK로 통과한 리다이렉트 속에 있었습니다. 주간 점검 설정까지 적었습니다.

읽기 →