Files
fuwari-blog/docs/README.ko.md
2025-07-18 21:37:37 +08:00

4.4 KiB

🍥Fuwari

Astro로 구축된 정적 블로그 템플릿입니다.

🖥️미리보기 (Vercel)

Preview Image

특징

  • AstroTailwind CSS로 구축됨
  • 부드러운 애니메이션 및 페이지 전환
  • 라이트 모드 / 다크 모드
  • 사용자 정의 가능한 테마 색상 및 배너
  • 반응형 디자인
  • Pagefind를 이용한 검색 기능
  • Markdown 확장 기능
  • 목차
  • RSS 피드

🚀 시작하기

  1. 블로그 저장소를 생성하세요:
    • 이 템플릿에서 새 저장소를 생성하거나 이 저장소를 포크하세요.
    • 또는 다음 명령어 중 하나를 실행하세요:
        npm create fuwari@latest
        yarn create fuwari
        pnpm create fuwari@latest
        bun create fuwari@latest
        deno run -A npm:create-fuwari@latest
    
  2. 로컬에서 블로그를 수정하려면, 저장소를 복제하고 pnpm install을 실행하여 종속성을 설치하세요.
    • pnpm이 설치되어 있지 않다면 npm install -g pnpm을 실행하여 설치하세요.
  3. src/config.ts설정 파일을 수정하여 블로그를 커스터마이징하세요.
  4. pnpm new-post <filename>을 실행하여 새 게시물을 만들고 src/content/posts/에서 수정하세요.
  5. 가이드에 따라 블로그를 Vercel, Netlify, Github Pages 등에 배포하세요. 배포하기 전에 astro.config.mjs에서 사이트 구성을 수정해야 합니다.

⚙️ 게시물의 머리말 설정

---
title: 내 첫 블로그 게시물
published: 2023-09-09
description: 내 새로운 Astro 블로그의 첫 번째 게시물입니다!
image: ./cover.jpg
tags: [Foo, Bar]
category: Front-end
draft: false
lang: jp      # 게시물의 언어가 `config.ts`의 사이트 언어와 다른 경우에만 설정합니다.
---

🧩 마크다운 확장 구문

Astro의 기본 GitHub Flavored Markdown 지원 외에도 몇 가지 추가적인 마크다운 기능이 포함되어 있습니다.

명령어

모든 명령어는 프로젝트 최상단, 터미널에서 실행됩니다:

Command Action
pnpm install 종속성을 설치합니다.
pnpm dev localhost:4321에서 로컬 개발 서버를 시작합니다.
pnpm build ./dist/에 프로덕션 사이트를 구축합니다.
pnpm check 코드에서 오류를 확인합니다.
pnpm format Biome을 사용하여 코드를 포멧합니다.
pnpm preview 배포하기 전에 로컬에서 빌드 미리보기
pnpm new-post <filename> 새 게시물 작성
pnpm astro ... astro add, astro check와 같은 CLI 명령어 실행
pnpm astro --help Astro CLI를 사용하여 도움 받기

✏️ 기여

이 프로젝트에 기여하는 방법에 대한 자세한 내용은 기여 가이드를 확인하세요.

📄 라이선스

이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여됩니다.

FOSSA Status