> ## Documentation Index
> Fetch the complete documentation index at: https://supastack.dev/llms.txt
> Use this file to discover all available pages before exploring further.
> For the full documentation corpus in one file, fetch: https://supastack.dev/llms-full.txt

# 블로그 글 작성

작동하는 카테고리와 가이드 링크가 있는 로컬 타입 지정 글을 게시하세요.

## 설치 및 설정

어떤 단계를 시작하기 전에 [시작하기 전에](https://supastack.dev/ko/docs/web/before-you-start.md) 및 [터미널 기본 사항](https://supastack.dev/ko/docs/web/terminal-basics.md)을 읽어보세요. 이 지침에서는 VS Code에서 전체 supastack 단일 저장소를 열었다고 가정합니다. 해당 루트 package.json은 저장소 루트를 표시합니다. pnpm 명령에서 작업 영역 패키지는 앱 또는 공유 코드 폴더입니다. 제품에서 작업공간은 팀의 데이터 컨테이너이자 보안 경계입니다. corepack pnpm --filter ... 명령이 해당 루트에서 실행되는 동안 monorepo에서 하나의 패키지를 선택합니다. 동기화된 모바일 또는 데스크톱 폴더만 열었다면 웹 백엔드, Docker 설정 또는 루트 스크립트가 포함되지 않습니다. 이 모노 저장소 또는 연결 가능한 호스팅 서버에서 백엔드를 실행하고 플랫폼 폴더의 자체 스크립트를 사용하세요. 환경 변수는 로컬 .env 파일이나 호스팅 대시보드에 저장된 명명된 설정입니다. 관련 앱을 변경한 후 다시 시작하고, NEXT_PUBLIC_ 및 EXPO_PUBLIC_ 값에서 서버 비밀을 유지하세요.

1. VS Code에서 apps/web/src/resources/content.ts를 열고 시작점으로 주변 기사 전체를 복사합니다. 기사 사본은 게시 대시보드가 ​​아닌 저장소에 있습니다.

2. 기사에 새로운 슬러그, 제목, 카테고리, 날짜, 섹션 및 기존 가이드 슬러그를 제공합니다.

3. 저장소 루트에서 corepack pnpm --filter @supastack/web dev를 실행하고 http://localhost:3000/blog/<your-slug>.를 엽니다. 예상: URL를 공유하기 전에 기사와 관련 가이드 링크가 로컬로 로드됩니다.

블로그 콘텐츠는 src/resources/content.ts 및 blog-posts.ts에 저장됩니다. 이는 저장소 관리 콘텐츠입니다. CMS 게시 서비스가 없습니다. 각 게시물에는 고유한 슬러그, 제목, 설명, 카테고리, 날짜, 관련 가이드 및 섹션이 필요합니다.

```
{
  slug: 'your-article',
  title: 'A specific reader question',
  category: 'Guides',
  date: '2026-09-07',
  guide: 'web/local-setup',
  sections: [{ id: 'start', title: 'Start here', paragraphs: ['Your original text.'] }]
}
```


## 복사 명령

설명을 따라 명령이 실행되는 폴더를 확인하세요. 두 개의 터미널에 레이블이 지정되어 있으면 두 개의 터미널 창을 열고 두 번째 명령을 사용하는 동안 첫 번째 명령을 계속 실행하세요.

```
corepack pnpm --filter @supastack/web dev

# Replace <your-slug> with the article slug:
# http://localhost:3000/blog/<your-slug>
corepack pnpm test -- apps/web/src/resources/content.test.ts
```


## 구현 워크플로

나머지 타입 지정 필드는 기존 완전한 Post 객체를 따르세요. 공유 URL이 계속 작동하도록 게시 후 slug를 안정적으로 유지하세요. 제목에는 목차와 앵커 링크를 위한 고유한 섹션 ID가 필요합니다.

카테고리는 글 카탈로그에서 파생됩니다. 인덱스는 URL 필터링을 사용하고 글 라우트는 콘텐츠에서 메타데이터를 생성합니다. guide 값은 기존 문서 slug와 일치해야 합니다. 관련 콘텐츠는 유용한 다음 단계로 이끌어야 합니다.


## 검증 및 문제 해결

기사가 404를 반환하는 경우 해당 슬러그가 고유하고 apps/web/src/resources/content.ts.의 기사 목록에 추가되었는지 확인하세요. 목차가 아무데도 이동하지 않으면 모든 섹션에 고유 ID를 부여하세요. 콘텐츠 유효성 검사 오류를 확인하려면 루트에서 corepack pnpm test -- apps/web/src/resources/content.test.ts를 실행하세요.

콘텐츠 테스트를 실행하고, 글 라우트를 열고, 관련 가이드를 따라가고, 필터된 인덱스를 확인하세요. 날짜와 주장을 출처와 대조하세요. 플레이스홀더 링크를 게시하거나 글에 등장한다는 이유만으로 통합이 검증되었다고 주장하지 마세요.


## 다음

[프로덕트 문서](https://supastack.dev/ko/docs/web/docs-site.md)