[Blog] Astro 블로그 레포 생성 및 초기 설정

[hadevyi]

[Blog] Astro 블로그 레포 생성 및 초기 설정

설명

별도 레포 blog 생성. ssafynity.github.io/blog로 배포. 운영진만 작성.

작업 내용

• Astro 프로젝트 생성
• @astrojs/tailwind, @astrojs/sitemap 설치
• Pretendard 폰트 적용
• GitHub Pages 배포 워크플로우 설정
• base path /blog 설정
• .gitignore AI 에이전트 항목 포함 확인

[hadevyi]

1. Astro 프로젝트 생성

npm create astro@latest . -- --template minimal --typescript strict --no-install
npm install

[hadevyi]

2. @astrojs/tailwind, @astrojs/sitemap 설치

npx astro add tailwind sitemap

astro.config.mjs:

import { defineConfig } from 'astro/config';
import tailwind from '@astrojs/tailwind';
import sitemap from '@astrojs/sitemap';

export default defineConfig({
  site: 'https://ssafynity.github.io',
  base: '/blog',
  integrations: [tailwind(), sitemap()],
});

[hadevyi]

3. Pretendard 폰트 적용

npm install pretendard

src/styles/global.css:

@import 'pretendard/dist/web/static/pretendard.css';
body { font-family: 'Pretendard', sans-serif; }

[hadevyi]

4. GitHub Pages 배포 워크플로우 설정

.github/workflows/deploy.yml:

name: Deploy
on:
  push:
    branches: [main]
jobs:
  deploy:
    runs-on: ubuntu-latest
    permissions:
      contents: read
      pages: write
      id-token: write
    environment:
      name: github-pages
      url: ${{ steps.deployment.outputs.page_url }}
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with:
          node-version: 20
      - run: npm ci
      - run: npm run build
      - uses: actions/configure-pages@v4
      - uses: actions/upload-pages-artifact@v3
        with:
          path: dist
      - uses: actions/deploy-pages@v4
        id: deployment

[hadevyi]

5. base path /blog 설정

astro.config.mjs의 base: '/blog' 확인.
내부 링크에 import.meta.env.BASE_URL 접두어 필수.

[hadevyi]

6. .gitignore AI 에이전트 항목 포함 확인

.claude/
CLAUDE.md
AGENTS.md
.codex/
.cursor/
*.cursorrules