Technical Blog

Hugo와 PaperMod로 구성한 AI-native 기술 블로그입니다. 글의 원본은 Markdown이며 GitHub Actions가 GitHub Pages로 자동 배포합니다.

로컬 사용

시스템 전체에 Hugo를 설치할 필요가 없습니다. 저장소가 고정한 Hugo 버전을 처음 실행할 때 .tools/ 아래에 내려받고 공식 체크섬으로 검증합니다.

make serve

초안을 포함한 사이트가 http://localhost:1313/에서 열립니다.

make new SLUG=kv-cache-basics
make check
make build

• make new: content/posts/<slug>.md 초안을 생성합니다.
• make check: 임시 디렉터리에서 프로덕션 빌드와 필수 페이지 생성을 검사합니다.
• make build: 배포용 결과물을 public/에 만듭니다.

발행 흐름

1. 작업 기록과 연구 노트에서 소재를 선택합니다.
2. make new SLUG=<slug>로 draft: true 초안을 만듭니다.
3. AI가 초안을 작성하되 실제 로그, 코드, 실험 결과를 근거로 사용합니다.
4. make serve로 읽어보고 수치, 주장, 공개 범위를 사람이 검수합니다.
5. front matter의 draft를 false로 바꾸고 make check를 통과시킵니다.
6. main에 push하면 .github/workflows/pages.yml이 자동 배포합니다.

GitHub Pages 연결

이 블로그는 vpfkfl753.github.io 사용자 페이지로 배포합니다. main에 push하면 GitHub Actions가 사이트를 빌드하고 Pages에 배포합니다.

워크플로는 GitHub가 알려주는 실제 Pages URL로 baseURL을 덮어쓰기 때문에, 배포 전에 저장소명이나 사용자 페이지 여부가 바뀌어도 링크가 깨지지 않습니다.

PaperMod

PaperMod는 themes/PaperMod Git submodule로 고정합니다.

git submodule update --init --recursive
git submodule update --remote --merge

두 번째 명령은 테마를 업데이트할 때만 사용하고, 업데이트 후에는 make check로 확인합니다.

공개 전 확인

• AI가 만든 일반론보다 실제 측정값, 코드, 실패와 판단을 중심에 둡니다.
• 모든 수치는 출처와 측정 조건을 함께 적습니다.
• kapu, 개인 재정, 실명·민감정보는 발행하지 않습니다.
• 미제출 논문의 신규 결과와 아이디어는 공개 시점을 먼저 확인합니다.
• project_ai_native_blog.md는 로컬 전용 프로젝트 메모이며 .gitignore와 Hugo 콘텐츠 디렉터리 양쪽에서 제외됩니다.