Category: Dev
Dev 카테고리에 작성된 글 목록입니다.
Dev Roadmap
블로그를 그냥 글 저장소가 아니라, 빌드와 배포, 검색 유입, 자동화까지 직접 다듬는 운영 기록으로 읽는 순서입니다.
Astro 기반 블로그를 만들고, GitHub Pages에 배포하고, AdSense와 자동 발행 흐름까지 붙여가며 생긴 실제 문제를 묶어둡니다.
블로그 기반 만들기
- Astro와 MDX로 기술 블로그 구축하기 (1편): 개발 환경 설정
Astro와 MDX로 직접 제어 가능한 기술 블로그 기반을 만드는 첫 단계입니다.
- Windows PowerShell에서 pnpm 10 설치하고 실행하기
Windows에서 Astro 블로그 개발 환경에 맞는 pnpm 버전을 설치하고 확인하는 과정입니다.
- Astro와 GitHub Pages: 커스텀 도메인으로 기술 블로그 배포하기
Astro 정적 사이트를 GitHub Pages와 커스텀 도메인으로 배포하는 기본 흐름입니다.
- Astro Content Collections, 글이 많아질수록 frontmatter 정리가 먼저다
Astro 블로그에서 글이 늘어날 때 slug, 날짜, 태그, 카테고리를 안정적으로 관리하는 방법입니다.
- Astro 블로그 검색 붙이기, Pagefind가 잘 맞는 이유
정적 Astro 블로그에 서버 없이 검색 기능을 붙일 때 Pagefind가 맞는 이유와 체크 포인트입니다.
콘텐츠 전략
- 기술 블로그 주제가 너무 좁을 때, 유입용 카테고리 다시 잡는 법
전문 글과 유입용 글이 섞이지 않도록 카테고리와 글감 축을 다시 잡는 기준입니다.
- Astro 카테고리 페이지를 목차처럼 만들면 오래된 글도 다시 읽힌다
Astro 카테고리 페이지를 단순 목록이 아니라 주제별 목차와 로드맵으로 쓰는 방법입니다.
수익화와 운영
- Astro RSS와 sitemap 체크리스트, 글을 써도 검색엔진이 못 찾으면 소용없다
Astro 블로그에서 RSS와 sitemap이 검색 유입의 기본 배관 역할을 하도록 확인하는 체크리스트입니다.
- Astro에서 AdSense가 페이지 전환 후 안 보일 때 확인할 것
Astro 페이지 전환 뒤 광고가 비는 원인과 중복 요청을 막는 기준을 정리합니다.
빌드와 배포 최적화
- Astro 블로그 빌드가 느릴 때, OG 이미지 캐시로 줄이는 방법
매번 다시 만들 필요 없는 OG 이미지를 캐시해서 Astro 블로그 빌드 시간을 줄이는 접근입니다.
- Astro 이미지 관리, public과 src/assets는 언제 나눠야 할까
Astro 블로그에서 이미지 파일을 public과 src/assets 중 어디에 둘지 판단하는 기준입니다.
- Astro public과 dist 폴더는 무엇이 다른가
Astro 프로젝트의 정적 원본과 빌드 결과물을 구분하는 기준입니다.
- Astro GitHub Actions 빌드 캐시, 매번 느린 배포를 줄이는 법
GitHub Actions에서 Astro 블로그 빌드 시간을 줄일 때 캐시를 어디에 적용하면 좋은지 정리합니다.
- Astro dev에서는 되는데 build 후 깨질 때 보는 순서
Astro 개발 서버에서는 정상인데 정적 빌드나 배포 후 깨질 때 확인하는 순서입니다.
- Astro Tailwind 레이아웃에서 오른쪽 여백이 남을 때 확인할 것
광고 레일이나 사이드바를 제거한 뒤 Astro/Tailwind 레이아웃에 오른쪽 여백이 남을 때 보는 체크리스트입니다.
- Astro Markdown 코드블록에 파일명과 복사 버튼을 붙이면 글이 읽기 쉬워진다
기술 블로그 코드블록에 파일명과 복사 버튼을 붙일 때 사용성이 좋아지는 이유와 구현 체크 포인트입니다.
- Astro 동적 OG 이미지, 템플릿과 캐시를 분리해서 봐야 한다
Astro에서 글별 OG 이미지를 자동 생성할 때 템플릿, 렌더링, 캐시를 나눠 설계하는 관점입니다.
글쓰기와 자동화
- Codex로 기술 블로그를 쓸 때 AI와 사람이 나눠야 할 일
AI에는 구조와 반복 작업을 맡기고, 사람은 경험과 기술 판단을 확인하는 흐름입니다.
- 티스토리 공개 글 111개를 이미지까지 로컬 백업해 봤다
티스토리 공개 글과 직접 업로드 이미지를 로컬 작업본으로 보관한 과정입니다.
최근 글
-
티스토리 공개 글 111개를 이미지까지 로컬 백업해 봤다
티스토리 공개 글 111개를 HTML, Markdown, JSON과 이미지로 나눠 로컬에 백업하고 확인한 결과를 기록합니다.
- DevUpdated:
Windows PowerShell에서 pnpm 10 설치하고 실행하기
Windows PowerShell에서 pnpm 10을 npm으로 설치하고, 스크립트 실행 정책 오류를 피해서 버전을 확인하는 방법입니다.
-
Astro public과 dist 폴더는 무엇이 다른가
Astro의 public과 dist가 비슷해 보이는 이유와 Git에 보관할 폴더, 삭제해도 되는 빌드 결과물을 구분합니다.
- Advertisement
-
Astro 동적 OG 이미지, 템플릿과 캐시를 분리해서 봐야 한다
Astro 블로그에서 글별 동적 OG 이미지를 만들 때 템플릿 구성과 캐시 정책을 분리해야 빌드 시간과 유지보수 문제가 줄어든다.
-
Astro dev에서는 되는데 build 후 깨질 때 보는 순서
Astro에서 dev 서버에서는 정상인데 build 결과나 GitHub Pages 배포 후 이미지, 검색, 경로, 스타일이 깨지는 경우 확인할 체크리스트를 정리한다.
-
Astro RSS와 sitemap 체크리스트, 글을 써도 검색엔진이 못 찾으면 소용없다
Astro 블로그에서 RSS, sitemap, canonical URL, robots.txt 같은 기본 색인 요소를 어떻게 확인해야 검색엔진이 새 글을 놓치지 않는지 정리한다.
-
Astro Markdown 코드블록에 파일명과 복사 버튼을 붙이면 글이 읽기 쉬워진다
Astro 기술 블로그에서 Markdown 코드블록에 파일명 표시와 복사 버튼을 붙이면 독자가 코드 위치와 사용법을 더 빨리 이해할 수 있다. 구현 시 고려할 점을 정리한다.
-
Astro Tailwind 레이아웃에서 오른쪽 여백이 남을 때 확인할 것
Astro와 Tailwind로 만든 블로그에서 사이드 광고를 제거한 뒤 오른쪽 공간이 남거나 제목만 좁게 보일 때 확인해야 할 max-width와 공용 레이아웃 규칙을 정리한다.
-
Astro GitHub Actions 빌드 캐시, 매번 느린 배포를 줄이는 법
Astro 블로그를 GitHub Actions로 배포할 때 의존성, OG 이미지, 검색 색인 같은 반복 작업을 캐시 관점에서 어떻게 줄일 수 있는지 정리한다.
-
Astro 이미지 관리, public과 src/assets는 언제 나눠야 할까
Astro 블로그에서 public 이미지와 src/assets 이미지의 차이를 운영 관점으로 나누고, 삽화와 OG 이미지 같은 파일을 어디에 두면 좋은지 정리한다.