woosday 블로그를 시작하며

woosday는 글과 프로젝트, 작은 도구들을 모아 둔 개인 사이트다. 이 공간에는 프로젝트를 만들고 운영하면서 남긴 기록, 다시 찾아보고 싶은 기술 메모, 직접 쓸 수 있는 작은 도구를 하나씩 쌓아 두려 한다.

글을 읽는 사람에게는 해결 과정과 선택의 이유가 남고, 나에게는 같은 문제를 다시 만났을 때 돌아볼 기록이 되는 사이트를 만들고 싶었다. 그래서 글은 posts/ 폴더의 Markdown 파일로 관리한다. 제목과 날짜 같은 정보는 파일 앞부분에 두고, 본문은 읽기 쉬운 일반 Markdown으로 작성한다.

글이 사이트에 올라오는 방식

각 글에는 YAML front matter가 들어간다.

---
title: 글 제목
date: 2024-01-01
category: 백엔드
tags: [Spring, 운영]
summary: 이 글에서 다루는 문제와 독자가 얻을 내용을 한 문장으로 작성
---

파일명은 글 주소의 일부가 되므로, 기존 글의 URL을 바꾸지 않도록 주제를 나타내는 slug를 사용한다. 제목이나 본문을 고칠 때도 파일명을 함께 바꾸지 않는 이유다.

현재 사이트는 Spring Boot 3.5.16과 Java 21을 사용하고, Markdown 파일을 읽어 블로그 페이지를 구성한다. 프로젝트와 생활 도구도 같은 사이트 안에 두되 각 기능의 목적이 분명하게 보이도록 계속 다듬고 있다.

이곳에 쌓을 기록

• 직접 만든 프로젝트의 설계와 운영 경험
• 개발과 배포 과정에서 만난 문제와 해결 방법
• 반복해서 쓰는 작은 도구와 사용 안내
• 시간이 지나 다시 확인할 가치가 있는 기술 메모

글을 많이 쌓는 것보다, 실제로 겪은 맥락과 확인할 수 있는 근거를 남기는 일을 우선하려 한다. 이 첫 글도 woosday의 구성과 기록 방식을 바꿀 때 함께 고쳐 나가겠다.