From 9745b3cb5918284f9265b88687bf1dc44353e95c Mon Sep 17 00:00:00 2001 From: Junseong Park Date: Sat, 18 Oct 2025 21:58:54 +0900 Subject: [PATCH] i18n(ko-KR): update `bun.mdx` --- src/content/docs/ko/recipes/bun.mdx | 86 ++++++++--------------------- 1 file changed, 24 insertions(+), 62 deletions(-) diff --git a/src/content/docs/ko/recipes/bun.mdx b/src/content/docs/ko/recipes/bun.mdx index 626e744c9f254..eb7d5948014cd 100644 --- a/src/content/docs/ko/recipes/bun.mdx +++ b/src/content/docs/ko/recipes/bun.mdx @@ -19,24 +19,15 @@ Bun을 사용하면서 문제가 발생하면, [Bun의 Github 저장소에서 ## Bun으로 새 Astro 프로젝트 생성 -다음 `create-astro` 명령어를 사용하여 Bun으로 새 Astro 프로젝트를 생성하세요. +다음 `create-astro` 명령어를 사용하여 Bun으로 새 Astro 프로젝트를 생성하세요. ```bash -bunx create-astro@latest my-astro-project-using-bun +bun create astro my-astro-project-using-bun ``` -:::tip -`--template` 플래그를 사용하여 [기존 Astro GitHub 저장소에서 새로운 Astro 프로젝트를 생성](/ko/install-and-setup/#cli-마법사로-설치)할 수도 있습니다: -```bash -bunx create-astro@latest my-astro-project-using-bun --template eliancodes/brutal -``` -::: - ## 종속성 설치 -`bunx create-astro` 명령어를 사용하여 새 프로젝트를 시작하는 경우, CLI는 Bun을 사용하여 종속성을 설치하므로 이 단계를 건너뛸 수 있습니다. - -그렇지 않은 경우, Bun을 사용하여 종속성을 설치해야 합니다. +CLI 마법사에서 "Install dependencies?" 단계를 건너뛴 경우, 계속하기 전에 반드시 의존성을 설치하세요. ```bash bun install @@ -52,79 +43,50 @@ Bun은 [`@types/bun`](https://www.npmjs.com/package/@types/bun) 패키지를 제 bun add -d @types/bun ``` -## Astro 통합 사용 - -`astro add` 명령어를 통해 모든 공식 Astro 통합을 사용할 수 있습니다: - -```bash -bunx astro add react -``` - -## Bun으로 Astro 실행 - -:::note -Node 대신 Bun의 자체 런타임을 사용하기 위해, 모든 `astro` 명령어 앞에 [`--bun` CLI 플래그](https://bun.sh/docs/cli/bunx#shebangs)를 사용하세요. -::: +## CLI 설치 플래그 -### 개발 서버 실행 +### 통합 사용하기 -Bun을 런타임으로 사용하여 개발 서버를 실행하려면 다음 명령어를 사용하세요. +`astro add` 명령어를 통해 모든 공식 Astro 통합을 사용할 수 있습니다. ```bash -bunx --bun astro dev +bun astro add react ``` -### Bun으로 사이트 빌드 +### 테마 또는 시작 템플릿 사용하기 -Bun을 런타임으로 사용하여 사이트를 빌드하려면 다음 명령어를 사용하세요. +`create astro` 명령에 `--template` 인수를 전달하여 [공식 예제](https://github.com/withastro/astro/tree/main/examples) 또는 GitHub 저장소의 메인 브랜치를 기반으로 새로운 Astro 프로젝트를 시작할 수 있습니다. -```bash -bunx --bun astro build -``` - -Astro는 `dist/` 디렉터리에 빌드 결과를 생성합니다. 그러면 `preview` 명령어를 사용하여 사이트를 제공할 수 있습니다. +터미널에서 공식 Astro 시작 템플릿 이름이나 사용하려는 테마의 GitHub 사용자 이름 및 리포지토리 이름으로 대체하여 다음 명령어를 실행하세요. ```bash -bunx --bun astro preview +# 공식 예제를 사용하여 새 프로젝트를 생성합니다. +bun create astro@latest --template +# GitHub 저장소의 메인 브랜치를 기반으로 새 프로젝트를 생성합니다. +bun create astro@latest --template / ``` -## Bun으로 SSR 추가 +## 개발 및 빌드하기 -Bun은 [Node.js API 호환성](https://bun.sh/docs/runtime/nodejs-apis)을 제공하므로 Astro 프로젝트의 [요청 시 렌더링](/ko/guides/on-demand-rendering/)을 위한 모든 Astro 어댑터를 사용할 수 있습니다: +개발 서버를 실행하려면 다음 명령어를 사용하세요. ```bash -bunx astro add vercel +bun run dev ``` -## Bun에서 테스팅 - -Bun은 `bun test` 명령어로 실행할 수 있는 강력한 성능을 가진 Jest 호환 내장 테스트 러너를 제공합니다. 이를 사용하려면 [`bun test` 문서](https://bun.sh/docs/cli/test)를 참조하세요. - -그러나 현대적인 방법으로 웹 앱을 테스팅하기 위해 Cypress 또는 Playwright를 사용하는 것도 가능합니다. - -### Cypress +### 사이트 빌드 및 미리보기 -Cypress는 "즐거운 테스팅 경험과 개발자를 행복하게 하는 것"을 목표로 하는 프런트엔드 테스팅 도구입니다. 이 도구를 사용하여 Astro 사이트에서 end-to-end 테스트를 작성할 수 있습니다. - -다음 명령어를 사용하여 Cypress를 설치합니다. +사이트를 빌드하려면 다음 명령어를 사용하세요. ```bash -bun add cypress --dev +bun run build ``` -나머지 구성 및 첫 번째 테스트를 시작하려면 [Astro 테스팅 가이드](/ko/guides/testing/#구성)의 Cypress 나머지 과정을 따르세요. - -### Playwright - -Playwright는 Chromium, WebKit, Firefox를 포함한 모든 최신 렌더링 엔진에서 Astro 코드를 테스트할 수 있는 end-to-end 테스팅 프레임워크입니다. +빌드가 완료되면 터미널에서 적절한 미리보기 명령어(예: `bun run preview`)를 실행하세요. 그러면 동일한 브라우저 미리보기 창에서 빌드된 버전의 사이트를 로컬에서 직접 확인할 수 있습니다. -다음 명령어를 사용하여 Playwright를 설치합니다. - -```bash -bun create playwright -``` +## 테스팅 -첫 번째 Playwright 테스트를 생성하려면 [Astro 테스팅 가이드](/ko/guides/testing/#첫-playwright-테스트-생성)의 나머지 Playwright 과정에 대한 지침을 따르세요. +Bun은 [`bun test` 명령어](https://bun.sh/docs/cli/test)를 통해 Jest와 호환되는 빠른 내장 테스트 실행기를 제공합니다. 또한 다른 [Astro용 테스트 도구](/ko/guides/testing/)를 사용할 수도 있습니다. ## 공식 리소스 @@ -132,7 +94,7 @@ bun create playwright ## 커뮤니티 리소스 -Astro와 Bun을 함께 사용하고 계신가요? 이 페이지에 여러분의 블로그 게시물이나 동영상을 추가하세요! +Astro와 Bun을 함께 사용하고 계신가요? 이 페이지에 여러분의 블로그 게시물이나 동영상을 추가하세요! - [Bun을 사용하여 Cloudflare Pages 사이트 빌드](https://blog.otterlord.dev/posts/hello-from-bun/) - 블로그 게시물 - [Astro 및 Cloudflare Pages와 함께 Bun 사용하기](https://handerson.hashnode.dev/using-bun-with-astro-and-cloudflare-pages) - 블로그 게시물