운영 기록
이 자리에 모인 글은 전부 제가 직접 걸려서 재본 것들입니다. 읽고 정리한 것이 아니라, 안 되는 화면을 앞에 두고 원인을 찾을 때까지 재본 기록입니다. 그래서 주제가 예쁘게 이어지지 않습니다. 티스토리 스킨 치환자 이야기 다음에 GitHub Actions 스케줄 이야기가 오고, 그 다음이 다시 도메인 이야기입니다. 막힌 순서대로 쌓았기 때문입니다.
쓸 때 지키는 것이 세 가지 있습니다. 첫째, 숫자는 어떻게 쟀는지 같이 적습니다. “느리다"가 아니라 몇 초였고 무엇으로 쟀는지를 적습니다. 둘째, 틀렸던 것은 지우지 않고 정정합니다. 처음에 세운 가설이 실측에서 깨지면 그 과정을 남깁니다 — 틀린 경로를 지워버리면 다음 사람이 같은 곳에 다시 들어갑니다. 셋째, 확인하지 못한 것은 확인하지 못했다고 적습니다. 그럴듯하게 채우면 읽는 사람이 검증하는 데 드는 시간이 제가 아낀 시간보다 커집니다.
공식 문서가 이미 잘 설명하는 것은 여기 없습니다. 문서와 실제가 어긋난 지점, 문서 문장을 제가 잘못 읽었던 지점, 그리고 로컬에서는 멀쩡한데 라이브에서만 깨지던 것들이 남았습니다. 같은 데서 막힌 사람이 검색으로 닿기를 바라며 적습니다.
hasCJKLanguage 한 줄에 단어 수가 세 배, 요약은 한 문단으로 줄었습니다
한국어 Hugo 블로그 글 12편을 hasCJKLanguage를 끄고 켜서 두 번 빌드했습니다. 단어 수는 2.5~3.2배, 읽는 시간은 0~2분 늘었고, 요약 길이 편차는 설정보다 첫 문단 길이에서 왔습니다.
읽기 →Hugo 글을 draft로 내렸는데, 그 글로 가는 링크는 빌드가 아무 말도 안 했습니다
일반 마크다운 링크는 대상 글이 사라져도 빌드가 조용히 통과합니다. ref 숏코드와 직접 만든 render-link 훅으로 깨질 링크를 빌드 단계에서 잡은 과정과 실측 결과를 적었습니다.
읽기 →Hugo가 없는 맥에서, 설치하지 않고 정해진 버전으로 한 번만 빌드해 봤습니다
macOS용 Hugo는 이제 압축 파일이 아니라 .pkg 설치 프로그램으로만 나옵니다. 설치 프로그램을 열지 않고 pkgutil로 바이너리만 꺼내서, 버전을 고정해 한 번 빌드하고 지우는 절차를 처음부터 다시 돌려 잰 기록입니다.
읽기 →Cloudflare Pages에서 내린 글이 내 도메인에서만 계속 열렸습니다
draft로 돌린 글이 pages.dev에서는 404인데 커스텀 도메인에서는 옛 본문이 200으로 남았습니다. Purge로도 안 지워졌고, 그 주소에 Hugo alias를 두어 배포로 덮었습니다.
읽기 →댓글창이 4주 동안 비어 있었습니다 — 스피너가 멈춘 걸 위젯이 떴다고 읽었습니다
댓글 치환자를 넣었는데 화면에 아무것도 없었습니다. 서버가 내려주는 HTML의 댓글 자리가 완전히 비어 있었고, 원인은 치환자가 아니라 그것을 감싸는 그룹 태그였습니다. 무한 로딩이 풀린 것을 위젯이 떴다고 읽어서 4주를 몰랐고, 그 잘못된 진단을 제가 이미 글로 발행해둔 상태였습니다.
읽기 →못 덮었던 통계를 덮었습니다 — 남은 가설은 맞았고, 대신 두 가지를 잃었습니다
앞선 글을 「수집 경로가 안 열려 있다」는 미확인 가설로 닫았습니다. 그 가설이 맞았고, 설치 모드를 바꾸자 세 호스트가 전부 204로 돌아섰습니다. 다만 전환 뒤에도 curl 재현은 여전히 404였고, 무결성 속성과 EU 방문자 제외 설정을 함께 잃었습니다.
읽기 →