Skip to content

Commit a6ed5cd

Browse files
committed
fix(docs): revise docs based on review
1 parent 94bba67 commit a6ed5cd

29 files changed

+66
-66
lines changed

.vitepress/theme/components/SponsorBanner.vue

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -68,16 +68,16 @@ function dismiss() {
6868
<p class="vt-banner-text">
6969
<span class="vt-main">ViteConf 2025</span>
7070
<span class="vt-tagline">
71-
· First time <span style="font-weight: 900">in-person</span></span
71+
· <span style="font-weight: 900">오프라인</span> 컨퍼런스</span
7272
>
73-
<span class="vt-place"> · Amsterdam</span>
73+
<span class="vt-place"> · 암스테르담</span>
7474
<span class="vt-date"> · Oct 09-10</span>
7575
<a
7676
target="_blank"
7777
class="vt-primary-action"
7878
href="https://viteconf.amsterdam/?utm_source=vite&utm_content=top_banner"
7979
>
80-
Register
80+
등록하기
8181
</a>
8282
</p>
8383
<button aria-label="close" @click="dismiss">

blog/announcing-vite5-1.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -45,7 +45,7 @@ Vite를 처음 사용하신다면, 먼저 [시작하기](/guide/) 및 [기능](/
4545

4646
## Vite Runtime API {#vite-runtime-api}
4747

48-
Vite 5.1은 새로운 Vite Runtime API에 대한 실험적 지원을 추가합니다. 이는 Vite 플러그인으로 먼저 처리하여 모든 코드를 실행할 수 있게 해줍니다. 런타임 구현이 서버에서 분리되어 있기 때문에 `server.ssrLoadModule`과는 다릅니다. 이를 통해 라이브러리와 프레임워크 작성자들이 서버와 런타임 간에 자체적인 통신 계층을 구현할 수 있습니다. 이 새로운 API는 안정화되면 Vite의 현재 SSR 프리미티브를 대체할 예정입니다.
48+
Vite 5.1은 새로운 Vite Runtime API에 대한 실험적 지원을 추가합니다. 이는 Vite 플러그인으로 먼저 처리하여 모든 코드를 실행할 수 있게 해줍니다. 런타임 구현이 서버에서 분리되어 있기 때문에 `server.ssrLoadModule`과는 다릅니다. 이를 통해 라이브러리와 프레임워크 개발자들이 서버와 런타임 간에 자체적인 통신 계층을 구현할 수 있습니다. 이 새로운 API는 안정화되면 Vite의 현재 SSR 프리미티브를 대체할 예정입니다.
4949

5050
새로운 API는 많은 이점을 제공합니다:
5151

blog/announcing-vite5.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -33,7 +33,7 @@ _2023년 11월 16일_
3333

3434
Vite 4가 거의 1년 전에 [릴리스되었고](./announcing-vite4.md), 생태계에 견고한 기반을 제공했습니다. 프로젝트들이 공유 인프라를 기반으로 계속 구축하면서 주간 npm 다운로드 수는 250만 건에서 750만 건으로 급증했습니다. 프레임워크들은 지속적으로 혁신을 이어갔으며, [Astro](https://astro.build/), [Nuxt](https://nuxt.com/), [SvelteKit](https://kit.svelte.dev/), [Solid Start](https://www.solidjs.com/blog/introducing-solidstart), [Qwik City](https://qwik.builder.io/qwikcity/overview/) 등을 비롯해 새로운 프레임워크들이 합류하여 생태계를 더욱 강화했습니다. [RedwoodJS](https://redwoodjs.com/)와 [Remix](https://remix.run/)가 Vite로 전환하면서 React 생태계에서의 추가 도입 가능성을 열었습니다. [Vitest](https://vitest.dev)는 Vite보다도 빠른 속도로 성장을 지속했습니다. Vitest 팀은 열심히 작업하고 있으며 곧 [Vitest 1.0을 릴리스할 예정](https://github.com/vitest-dev/vitest/issues/3596)입니다. [Storybook](https://storybook.js.org), [Nx](https://nx.dev), [Playwright](https://playwright.dev)와 같은 다른 도구들과 함께 사용할 때의 Vite 경험은 계속 개선되었고, [Deno](https://deno.com)와 [Bun](https://bun.sh)에서 Vite 개발이 작동하는 등 환경 면에서도 마찬가지였습니다.
3535

36-
한 달 전에 [StackBlitz](https://stackblitz.com)가 주최한 [ViteConf](https://viteconf.org/23/replay) 두 번째 에디션이 개최되었습니다. 작년과 마찬가지로 생태계의 대부분 프로젝트들이 모여서 아이디어를 공유하고 공통 기반을 계속 확장하기 위해 연결되었습니다. 또한 [Volar](https://volarjs.dev/)[Nitro](https://nitro.build/)같이 메타 프레임워크 도구 벨트를 보완하는 새로운 요소들도 등장하고 있습니다. Rollup 팀은 같은 날 [Rollup 4](https://rollupjs.org)를 릴리스했는데, 이는 Lukas가 작년에 시작한 전통입니다.
36+
한 달 전에 [StackBlitz](https://stackblitz.com)가 주최한 [ViteConf](https://viteconf.org/23/replay) 두 번째 에디션이 개최되었습니다. 작년과 마찬가지로 아이디어를 공유하고 공통 기반을 계속 확장하기 위해 생태계 내 프로젝트 대부분이 모였습니다. 또한 [Volar](https://volarjs.dev/)[Nitro](https://nitro.build/)같은 메타 프레임워크 공구 벨트(Tool Belt)를 보완하는 새로운 요소들도 등장하고 있습니다. Rollup 팀은 같은 날 [Rollup 4](https://rollupjs.org)를 릴리스했는데, 이는 Lukas가 작년에 시작한 전통입니다.
3737

3838
6개월 전 Vite 4.3이 [릴리스되었습니다](./announcing-vite4.md). 이 릴리스는 개발 서버 성능을 크게 개선했습니다. 하지만 여전히 개선할 여지가 충분합니다. ViteConf에서 [Evan You는 호환 가능한 API를 가진 Rollup의 Rust 포트인 Rolldown 작업에 대한 Vite의 장기 계획을 공개했습니다](https://www.youtube.com/watch?v=hrdwQHoAp0M). 준비가 되면 Vite 코어에서 이를 사용하여 Rollup과 esbuild의 작업을 모두 담당할 예정입니다. 이는 빌드 성능 향상(그리고 나중에는 Vite 자체의 성능에 민감한 부분을 Rust로 이동하면서 개발 성능도)과 개발과 빌드 간의 불일치를 크게 줄이는 것을 의미합니다. Rolldown은 현재 초기 단계에 있으며 팀은 연말 이전에 코드베이스를 오픈소스화할 준비를 하고 있습니다. 기대해 주세요!
3939

@@ -93,7 +93,7 @@ Vite 5는 또한 시작 시간을 개선하는 새로운 기능인 [server.warmu
9393
- [`--https` 플래그와 `https: true` 제거](/guide/migration#remove-https-flag-and-https-true)
9494
- [`resolvePackageEntry``resolvePackageData` API 제거](/guide/migration#remove-resolvepackageentry-and-resolvepackagedata-apis)
9595
- [이전에 더 이상 사용되지 않는 API 제거](/guide/migration#removed-deprecated-apis)
96-
- [플러그인과 도구 작성자에게 영향을 주는 고급 변경사항에 대해 자세히 읽어보기](/guide/migration#advanced)
96+
- [플러그인 및 툴 개발자에게 영향을 주는 고급 변경사항에 대해 자세히 읽어보기](/guide/migration#advanced)
9797

9898
## Vite 5로 마이그레이션 {#migrating-to-vite-5}
9999

@@ -105,6 +105,6 @@ Vite 코어의 전체 변경사항 목록이 포함된 저수준 분석은 [Vite
105105

106106
## 감사의 말 {#acknowledgments}
107107

108-
Vite 5는 우리 커뮤니티의 기여자들, 다운스트림 메인테이너들, 플러그인 작성자들, 그리고 [Vite 팀](/team)의 오랜 시간에 걸친 작업의 결과입니다. 이번 메이저 릴리스 과정을 이끌어준 [Bjorn Lu](https://twitter.com/bluwyoo)에게 큰 박수를 보냅니다.
108+
Vite 5는 우리 커뮤니티의 기여자들, 다운스트림 메인테이너들, 플러그인 개발자들, 그리고 [Vite 팀](/team)의 오랜 시간에 걸친 작업의 결과입니다. 이번 메이저 릴리스 과정을 이끌어준 [Bjorn Lu](https://twitter.com/bluwyoo)에게 큰 박수를 보냅니다.
109109

110110
또한 Vite 개발을 후원하는 개인과 회사들에게도 감사드립니다. [StackBlitz](https://stackblitz.com/), [Nuxt Labs](https://nuxtlabs.com/), [Astro](https://astro.build)는 Vite 팀 멤버를 고용하여 Vite에 지속적으로 투자하고 있습니다. [Vite의 GitHub Sponsors](https://github.com/sponsors/vitejs), [Vite의 Open Collective](https://opencollective.com/vite), [Evan You의 GitHub Sponsors](https://github.com/sponsors/yyx990803)의 후원자들에게 박수를 보냅니다. Vite로 전환한 후 골드 후원자가 되어 다시 기여해준 [Remix](https://remix.run/)에 특별한 감사를 표합니다.

blog/announcing-vite6.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -82,11 +82,11 @@ Vite 6는 Vite 5와 유사하게 Node.js 18, 20, 22+를 지원합니다. Node.js
8282

8383
## 실험적 Environment API {#experimental-environment-api}
8484

85-
Vite는 새로운 Environment API로 더욱 유연해지고 있습니다. 이러한 새로운 API를 통해 프레임워크 작성자들은 프로덕션에 더 가까운 개발 경험을 제공하고 생태계가 새로운 빌딩 블록을 공유할 수 있게 됩니다. SPA를 구축하는 경우에는 아무것도 변경되지 않습니다. 단일 클라이언트 환경에서 Vite를 사용할 때는 모든 것이 이전과 같이 작동합니다. 그리고 커스텀 SSR 앱의 경우에도 Vite 6는 하위 호환성을 유지합니다. Environment API의 주요 대상 사용자는 프레임워크 작성자들입니다.
85+
Vite는 새로운 Environment API로 더욱 유연해지고 있습니다. 이러한 새로운 API를 통해 프레임워크 개발자들은 프로덕션에 더 가까운 개발 경험을 제공하고 생태계가 새로운 빌딩 블록을 공유할 수 있게 됩니다. SPA를 구축하는 경우에는 아무것도 변경되지 않습니다. 단일 클라이언트 환경에서 Vite를 사용할 때는 모든 것이 이전과 같이 작동합니다. 그리고 커스텀 SSR 앱의 경우에도 Vite 6는 하위 호환성을 유지합니다. Environment API의 주요 대상 사용자는 프레임워크 개발자들입니다.
8686

8787
궁금한 최종 사용자들을 위해, [Sapphi](https://github.com/sapphi-red)가 훌륭한 [Environment API 소개](https://green.sapphi.red/blog/increasing-vites-potential-with-the-environment-api) 가이드를 작성했습니다. 이는 시작하기에 좋은 곳이며 저희가 왜 Vite를 더욱 유연하게 만들려고 하는지 이해할 수 있습니다.
8888

89-
프레임워크 작성자이거나 Vite 플러그인 유지보수자이고 새로운 API를 활용하고 싶으시다면, [Environment API 가이드](https://main.vite.dev/guide/api-environment)에서 더 자세히 알아보실 수 있습니다.
89+
프레임워크 개발자이거나 Vite 플러그인 유지보수자이고 새로운 API를 활용하고 싶으시다면, [Environment API 가이드](https://main.vite.dev/guide/api-environment)에서 더 자세히 알아보실 수 있습니다.
9090

9191
새로운 API를 정의하고 구현하는 데 참여한 모든 분들에게 감사드립니다. 이 이야기는 [Rich Harris](https://github.com/Rich-Harris)와 [SvelteKit](https://svelte.dev/docs/kit) 팀이 개척한 언번들드 SSR 개발 스킴을 Vite 2가 채택하면서 시작됩니다. 그 후 Vite의 SSR 변환이 [Anthony Fu](https://github.com/antfu/)와 [Pooya Parsa](https://github.com/pi0)가 vite-node를 만들고 [Nuxt의 Dev SSR 스토리](https://antfu.me/posts/dev-ssr-on-nuxt)를 개선할 수 있게 해주었습니다. Anthony는 vite-node를 사용하여 [Vitest](https://vitest.dev)를 구동했고, [Vladimir Sheremet](https://github.com/sheremet-va)는 Vitest 유지보수 작업의 일환으로 계속 개선했습니다. 2023년 초, Vladimir는 vite-node를 Vite Core로 업스트림하는 작업을 시작했고, 1년 후 Vite 5.1에서 Runtime API로 출시했습니다. 생태계 파트너들(특히 Cloudflare 팀에게 감사드립니다)의 피드백은 저희가 Vite의 환경에 대해 더욱 야심찬 재작업을 하도록 이끌었습니다. 이 이야기에 대해 더 자세히 알아보려면 [Patak의 ViteConf 24 발표](https://www.youtube.com/watch?v=WImor3HDyqU?si=EZ-rFJn4pDW3tUvp)를 참조하세요.
9292

@@ -112,4 +112,4 @@ Vite 팀의 모든 구성원이 새로운 API 정의에 참여했으며, 이는
112112

113113
## 감사의 말 {#acknowledgments}
114114

115-
Vite 6는 기여자 커뮤니티, 다운스트림 유지보수자들, 플러그인 작성자들, 그리고 [Vite 팀](/team)의 오랜 작업 시간의 결과입니다. Vite 개발을 후원하는 개인과 기업들에게 감사드립니다. Vite는 [StackBlitz](https://stackblitz.com/), [Nuxt Labs](https://nuxtlabs.com/), [Astro](https://astro.build)와의 파트너십으로 [VoidZero](https://voidzero.dev)에서 제공합니다. [Vite의 GitHub Sponsors](https://github.com/sponsors/vitejs)[Vite의 Open Collective](https://opencollective.com/vite)의 후원자들에게 감사드립니다.
115+
Vite 6는 기여자 커뮤니티, 다운스트림 유지보수자들, 플러그인 개발자들, 그리고 [Vite 팀](/team)의 오랜 작업 시간의 결과입니다. Vite 개발을 후원하는 개인과 기업들에게 감사드립니다. Vite는 [StackBlitz](https://stackblitz.com/), [Nuxt Labs](https://nuxtlabs.com/), [Astro](https://astro.build)와의 파트너십으로 [VoidZero](https://voidzero.dev)에서 제공합니다. [Vite의 GitHub Sponsors](https://github.com/sponsors/vitejs)[Vite의 Open Collective](https://opencollective.com/vite)의 후원자들에게 감사드립니다.

blog/announcing-vite7.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -92,4 +92,4 @@ Vite 7은 Vite 6에서 원활한 업데이트가 되어야 합니다. 저희는
9292

9393
## 감사의 말 {#acknowledgments}
9494

95-
Vite 7은 광범위한 기여자 커뮤니티, 다운스트림 유지보수자들, 플러그인 작성자들의 도움으로 [Vite 팀](/team)이 제작했습니다. `rolldown-vite`와 이번 릴리스에 대한 놀라운 작업을 해준 [sapphi-red](https://github.com/sapphi-red)에게 특별히 감사드립니다. Vite는 [Bolt](https://bolt.new/)[Nuxt Labs](https://nuxtlabs.com/)와의 파트너십으로 [VoidZero](https://voidzero.dev)에서 제공합니다. 또한 [Vite의 GitHub Sponsors](https://github.com/sponsors/vitejs)[Vite의 Open Collective](https://opencollective.com/vite)의 후원자들에게도 감사드립니다.
95+
Vite 7은 광범위한 기여자 커뮤니티, 다운스트림 유지보수자들, 플러그인 개발자들의 도움으로 [Vite 팀](/team)이 제작했습니다. `rolldown-vite`와 이번 릴리스에 대한 놀라운 작업을 해준 [sapphi-red](https://github.com/sapphi-red)에게 특별히 감사드립니다. Vite는 [Bolt](https://bolt.new/)[Nuxt Labs](https://nuxtlabs.com/)와의 파트너십으로 [VoidZero](https://voidzero.dev)에서 제공합니다. 또한 [Vite의 GitHub Sponsors](https://github.com/sponsors/vitejs)[Vite의 Open Collective](https://opencollective.com/vite)의 후원자들에게도 감사드립니다.

changes/hotupdate-hook.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@
99
영향을 받는 범위: `Vite 플러그인 개발자`
1010

1111
::: warning 지원 중단
12-
`hotUpdate``v6.0`에서 처음 도입되었습니다. `handleHotUpdate`의 지원 중단은 향후 메이저 버전에서 계획되어 있습니다. 아직은 `handleHotUpdate`에서 벗어나는 것을 권장하지 않습니다. 실험해보고 피드백을 주고 싶다면, Vite 설정에서 `future.removePluginHookHandleHotUpdate``"warn"`으로 설정할 수 있습니다.
12+
`hotUpdate``v6.0`에서 처음 도입되었습니다. `handleHotUpdate`의 지원 중단은 향후 메이저 버전에서 계획되어 있기에, 아직은 `handleHotUpdate`에서 벗어나는 것을 권장하지 않습니다. 실험해보고 피드백을 주고 싶다면, Vite 설정에서 `future.removePluginHookHandleHotUpdate``"warn"`으로 설정할 수 있습니다.
1313
:::
1414

1515
## 배경 {#motivation}

changes/index.md

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -6,21 +6,21 @@ API 지원 중단, 제거, 그리고 변경 사항을 포함한 Vite 주요 변
66

77
이러한 변경 사항들은 Vite의 다음 메이저 버전에서 적용될 예정입니다. 가능한 경우 지원 중단 또는 사용 관련 경고를 통해 안내할 예정이며, 프레임워크와 플러그인 개발자, 그리고 사용자들에게 이러한 변경 사항을 적용하도록 요청하고 있습니다.
88

9-
- [`this.environment` in Hooks](/changes/this-environment-in-hooks)
10-
- [HMR `hotUpdate` Plugin Hook](/changes/hotupdate-hook)
11-
- [SSR Using `ModuleRunner` API](/changes/ssr-using-modulerunner)
9+
- [훅에서 `this.environment` 사용하기](/changes/this-environment-in-hooks)
10+
- [HMR `hotUpdate` 플러그인 훅](/changes/hotupdate-hook)
11+
- [`ModuleRunner` API를 사용하는 SSR](/changes/ssr-using-modulerunner)
1212

1313
## 검토 중인 변경 사항 {#considering}
1414

1515
아래 변경 사항들은 현재 검토 중이며, 대부분 사용 패턴을 개선하기 위한 실험적인 API입니다. 여기에 나열되지 않은 변경 사항도 있으므로, 전체 목록은 [Vite GitHub Discussions의 Experimental 레이블](https://github.com/vitejs/vite/discussions/categories/feedback?discussions_q=label%3Aexperimental+category%3AFeedback)을 확인해 주세요.
1616

1717
그리고 아직은 전환하는 것을 권장하지 않습니다. 이러한 API들은 피드백을 수집하기 위해 Vite에 포함되었습니다. 제안을 확인하고, 여러분의 사용 사례에서는 어떻게 동작하는지 GitHub Discussions에서 알려주시기 바랍니다.
1818

19-
- [Move to Per-environment APIs](/changes/per-environment-apis)
20-
- [Shared Plugins During Build](/changes/shared-plugins-during-build)
19+
- [환경별 API로 마이그레이션](/changes/per-environment-apis)
20+
- [빌드 중 공유되는 플러그인](/changes/shared-plugins-during-build)
2121

2222
## 과거 변경 사항 {#past}
2323

24-
아래 변경 사항들은 이미 완료되었거나 되돌려졌습니다. 현재 주요 버전에서는 더 이상 관련이 없습니다.
24+
아래 변경 사항들은 이미 완료되었거나 되돌려졌습니다. 현재 메이저 버전에서는 더 이상 관련이 없습니다.
2525

2626
- _아직 과거 변경 사항이 없습니다_

changes/per-environment-apis.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@
99
영향을 받는 범위: `Vite 플러그인 개발자`
1010

1111
::: warning 지원 중단
12-
`Environment` 인스턴스는 `v6.0`에서 처음 도입되었습니다. `server.moduleGraph` 및 현재 환경에 있는 다른 메서드들에 대한 지원 중단은 향후 메이저 버전에서 계획되어 있습니다. 아직은 서버 메서드에서 벗어나는 것을 권장하지 않습니다. 사용 현황을 확인하려면 Vite 설정에서 다음과 같이 설정하세요.
12+
`Environment` 인스턴스는 `v6.0`에서 처음 도입되었습니다. `server.moduleGraph` 및 현재 환경에 있는 다른 메서드들에 대한 지원 중단은 향후 메이저 버전에서 계획되어 있습니다. 따라서 아직은 서버 메서드에서 벗어나는 것을 권장하지 않습니다. 사용 현황을 확인하려면 Vite 설정에서 다음과 같이 설정하세요.
1313

1414
```ts
1515
future: {

0 commit comments

Comments
 (0)