About

만들다 막힌 자리를 기록합니다.

안녕하세요, 류마입니다. RyuMa Space는 제가 뭔가를 만들다 막힌 자리를 기록해두는 블로그입니다.

개발 직군에서 일한 적이 있고, 지금은 회사 일을 마친 저녁에 만들고 싶은 걸 하나씩 붙여봅니다.

코드는 익숙한 편인데, git도 이 블로그를 만들면서 처음 깔았을 만큼 배포와 서버 쪽은 낯설었습니다.

그래서 막히는 자리가 많고, 그게 그대로 글이 됩니다.

지금은 이 블로그 자체가 그 대상입니다.

Astro의 영어권 템플릿 하나를 받아서 한글이 제대로 보이게 고치고,

Cloudflare에 올리고, 댓글과 방문 통계와 예약 발행을 하나씩 붙였습니다.

그 과정이 대부분 글로 남아 있습니다.

어떤 글을 쓰나

“됐습니다”보다 “안 됐습니다” 쪽이 많습니다.

잘 된 이야기는 어차피 공식 문서에 잘 적혀 있고,

정작 검색해서 안 나오는 건 막혔을 때 어디를 봐야 하는지거든요.

지금까지 다룬 건 대략 이렇습니다.

• 정적 사이트 빌드와 배포 — Astro, Cloudflare Workers, npm 버전 문제, 로컬과 배포 환경이 다를 때
• 자체호스팅 — 시놀로지 NAS에 Docker로 댓글 서버 띄우기, 쿠키와 인증, 운영하며 생기는 일
• 디버깅하는 법 — 에러 메시지를 어떻게 읽었는지, 남의 소스를 어디서부터 열었는지, 결국 제 코드였던 경우
• 웹 기본기 점검 — 접근성 검사, 페이지 무게, 검색 색인, 한글 타이포그래피

글을 쓰는 기준

몇 가지는 지키려고 합니다.

• 직접 돌려본 것만 적습니다. 코드와 설정값은 제가 실제로 쓴 버전 기준이고, 버전이 결과를 바꾸는 경우엔 버전을 같이 적습니다.
• 숫자는 잰 값입니다. “꽤 무겁다” 대신 몇 KB인지, 몇 곳이 걸렸는지 적고, 어떻게 쟀는지도 같이 적습니다.
• 근거는 링크로 남깁니다. 글 끝의 “참고한 문서”에 공식 문서나 소스 코드의 어느 부분을 보고 판단했는지 적어둡니다.
• 못 밝힌 건 못 밝혔다고 적습니다. 원인을 모른 채 우회한 것도 우회했다고 적습니다.
• 그림은 직접 만듭니다. 글에 들어간 도식은 전부 제가 짜서 뽑은 것입니다.
• 틀리면 고칩니다. 나중에 틀린 걸 알게 되면 본문을 고치고, 글 끝 “고친 곳”에 무엇을 왜 고쳤는지 남깁니다.

이 블로그는 이렇게 굴러갑니다

• Astro로 빌드하고 Cloudflare Workers에 올립니다
• 글은 GitHub 저장소의 마크다운 파일이고, 휴대폰에서는 Sveltia CMS로 씁니다
• 댓글은 NAS에 직접 띄운 Remark42입니다
• 방문 통계는 GoatCounter를 씁니다. 구글 애널리틱스는 무게 때문에 접었습니다

어떤 정보를 어디에 남기는지는 개인정보처리방침에 따로 적어뒀습니다.

연락

글 아래 댓글이 제일 편합니다. 로그인 없이 이름만 적고 바로 쓰실 수 있습니다.

메일이 편하시면 ryuma@kakao.com 으로 보내주세요. 글의 사실관계가 틀렸다는 지적은 특히 반갑습니다. 확인하고 고친 뒤 글에 남기겠습니다.

새 글은 RSS로도 받아보실 수 있습니다.