birchholt 직접 해보고 남기는 기록

운영 기록

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

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

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

2026년 10월 · Hugo

구글 검색결과에 내 블로그 파비콘이 안 뜬다면: favicon.ico가 404였고, '48px 배수'는 지금 기준이 아니었습니다

구글 검색결과에 파비콘이 안 뜰 때 크기부터 의심하기 쉽습니다. 제 블로그는 favicon.ico가 404였고, 커뮤니티 답변에 인용된 '48px의 배수' 규칙은 2024년 말 개정 전 문구였습니다. Hugo에서 고친 과정을 적었습니다.

읽기 →
2026년 10월 · Hugo

Hugo 메뉴에 현재 페이지 active가 안 붙을 때: url 대신 pageRef를 써야 합니다

hugo.toml 메뉴를 url로 적으면 IsMenuCurrent와 HasMenuCurrent가 제가 본 다섯 페이지에서 모두 false였습니다. 블로그 사본에서 재현하고 pageRef로 바꿔 active·ancestor가 갈리는 것까지 확인했습니다.

읽기 →
2026년 10월 · Cloudflare

링크 점검기가 /cdn-cgi/l/email-protection 을 404로 잡는데, 고장 난 건 없었습니다

Cloudflare 이메일 난독화가 켜지면 mailto가 /cdn-cgi/l/email-protection 링크로 바뀝니다. 그 404가 어디서 오는지, JS를 끄면 무엇이 사라지는지 재 보고, Hugo에서 메일 주소만 빼는 주석이 두 번 지워지는 것도 확인했습니다.

읽기 →
2026년 10월 · Cloudflare

저장소만 있으면 블로그가 다 살아날 줄 알았는데, 레포 밖에 설정이 여섯 가지 있었습니다

Hugo 블로그를 새로 clone해 빌드했더니 라이브 파일 171개와 바이트까지 같았습니다. 그런데 DNS, 리다이렉트 규칙, 시크릿, 배포 이력은 저장소에 없었고 그중 리다이렉트 규칙은 배포용 토큰으로 읽을 수도 없었습니다.

읽기 →
2026년 10월 · Hugo

Hugo RSS를 전문으로 바꿨더니 이미지 주소는 멀쩡했고, 포럼식 CDATA에서만 깨졌습니다

Hugo 내장 RSS의 .Summary를 .Content로 바꿔 피드 용량과 상대 경로를 쟀습니다. 슬래시로 시작하는 주소는 Hugo가 알아서 절대 주소로 바꾸지만 CDATA로 감싸면 그 변환이 꺼지고, 각주·번들 이미지는 끝까지 남았습니다.

읽기 →
2026년 10월 · Hugo

languageCode 경고를 지우려고 locale로 바꿨더니 구버전 빌드에서 깨집니다

Hugo 0.158부터 languageCode는 locale로 바뀌었습니다. 0.147.7과 0.157~0.165, 열 개 버전으로 빌드해 보니, 오류는 설정 키가 아니라 템플릿의 .Locale에서 났고 설정 키는 오류 없이 값만 바꿨습니다.

읽기 →