birchholt 직접 해보고 남기는 기록

운영 기록

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

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

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

· Hugo

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

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

읽기 →
· Cloudflare·배포

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

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

읽기 →
· Hugo

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

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

읽기 →
· Cloudflare·배포

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

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

읽기 →
· Hugo

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

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

읽기 →
· Hugo

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

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

읽기 →