birchholt 직접 해보고 남기는 기록

소개

havefunatcode

백엔드 개발 5년차

Hugo로 만든 정적 사이트, Cloudflare Pages 배포, 티스토리 블로그 운영에서 실제로 걸린 문제를 다룹니다. 대부분의 글은 문제 하나를 맡아 증상과 재현 절차, 원인, 고친 방법(또는 아직 못 고친 이유)을 적습니다. Hugo·Cloudflare 문제는 가능하면 로컬 빌드나 별도 브랜치, 프리뷰 배포 같은 사본에서 먼저 재현합니다. 티스토리처럼 사본에서는 재현되지 않는 문제는 라이브에서 확인한 결과와 그 날짜를 적습니다.

글은 세 묶음으로 나눠 두었습니다.

재현과 측정을 적는 방식

Hugo처럼 버전에 따라 결과가 달라지는 도구는 재현에 쓴 버전(예: Hugo v0.165.0)과 측정한 날짜를 본문에 적습니다. 상태 코드나 헤더처럼 명령으로 확인한 결과는 그 명령(curl 등)과 출력을 함께 적어, 읽는 분이 같은 명령으로 다시 확인할 수 있게 합니다.

확인하지 못한 것은 확인하지 못했다고 표기합니다. 공식 문서의 설명과 측정 결과가 어긋나면 어느 한쪽으로 덮지 않고 양쪽을 모두 적습니다.

틀린 내용을 고치는 방식

글을 고치면 제목 아래에 갱신일(YYYY-MM-DD)이 표시되고, 검색엔진이 읽는 구조화 데이터의 dateModified에도 같은 날짜가 들어갑니다. 일부 글은 틀렸던 내용을 본문에 날짜를 붙인 정정 문단(예: 정정 (2026-09-20))으로 남겼습니다. 갱신일만으로는 무엇이 바뀌었는지 알 수 없다는 문제는 따로 글로 다뤘습니다(작성 당시 화면 기준): 예전 글의 틀린 문장을 고쳤는데, 독자에게 남은 건 「9월 갱신」 한 줄이었습니다.

글에서 틀린 내용이나 끊어진 링크를 발견하시면 아래 연락처로 알려 주시기 바랍니다.

연락처