Skip to content

Commit

Permalink
docs(typo): fix typo bundle bundler bundling linted by textlint (#1080)
Browse files Browse the repository at this point in the history
* docs(typo): fix typo bundle bundler bundling linted by textlint

* docs(typo): fix typo bundle bundler bundling linted by textlint
  • Loading branch information
lumirlumir authored Oct 14, 2024
1 parent 5f9486b commit 31262c8
Show file tree
Hide file tree
Showing 8 changed files with 37 additions and 7 deletions.
Original file line number Diff line number Diff line change
Expand Up @@ -21,7 +21,7 @@ React Labs 게시글에는 활발히 연구 개발 중인 프로젝트에 대한

React 서버 컴포넌트(React Server Components, 또는 RSC)는 React 팀에서 설계한 새로운 애플리케이션 아키텍처입니다.

우리는 먼저 [소개 발표](/blog/2020/12/21/data-fetching-with-react-server-components)[RFC](https://github.com/reactjs/rfcs/pull/188)에서 RSC에 대한 연구를 공유했습니다. 그 내용을 요약하면, 미리 실행하고 JavaScript bundle에서 제외할 수 있는 새로운 종류의 컴포넌트인 서버 컴포넌트를 소개하고 있습니다. 서버 컴포넌트는 빌드 중에 실행되어 파일 시스템에서 읽거나 정적 콘텐츠를 가져올 수 있습니다. 또한 서버에서 실행할 수 있어 API를 빌드할 필요 없이 데이터 계층에 접근할 수 있습니다. props를 통해 서버 컴포넌트에서 상호작용하는 브라우저의 클라이언트 컴포넌트로 데이터를 전달할 수 있습니다.
우리는 먼저 [소개 발표](/blog/2020/12/21/data-fetching-with-react-server-components)[RFC](https://github.com/reactjs/rfcs/pull/188)에서 RSC에 대한 연구를 공유했습니다. 그 내용을 요약하면, 미리 실행하고 JavaScript 번들에서 제외할 수 있는 새로운 종류의 컴포넌트인 서버 컴포넌트를 소개하고 있습니다. 서버 컴포넌트는 빌드 중에 실행되어 파일 시스템에서 읽거나 정적 콘텐츠를 가져올 수 있습니다. 또한 서버에서 실행할 수 있어 API를 빌드할 필요 없이 데이터 계층에 접근할 수 있습니다. props를 통해 서버 컴포넌트에서 상호작용하는 브라우저의 클라이언트 컴포넌트로 데이터를 전달할 수 있습니다.

RSC는 서버 중심의 멀티 페이지 애플리케이션의 간단한 "요청/응답" 멘탈 모델에 클라이언트 중심의 싱글 페이지 애플리케이션의 원활한 상호작용을 결합하여 양쪽의 장점을 모두 제공합니다.

Expand Down
4 changes: 2 additions & 2 deletions src/content/blog/2023/05/03/react-canaries.md
Original file line number Diff line number Diff line change
Expand Up @@ -57,7 +57,7 @@ Canaries 채널을 통한 롤링 릴리즈를 통해 더욱 긴밀한 피드백

기술적으로는 [Experimental releases](/community/versioning-policy#canary-channel)를 사용*할 수* 있지만, 실험적 API는 안정화 과정에서 중대한 변경이 있을 수 있으므로(또는 심지어 완전히 제거될 수도 있으므로) 프로덕션 환경에서 사용하지 않는 것이 좋습니다. Canaries에도 실수가 있을 수 있지만(다른 릴리즈와 마찬가지로), 앞으로는 Canaries에 중대한 변경 사항이 있으면 블로그에 공지할 계획입니다. Canaries는 Meta가 내부적으로 실행하는 코드에 가장 가깝기 때문에 일반적으로 비교적 안정적일 것으로 기대할 수 있습니다. 하지만 버전을 고정*하고* 고정된 커밋 사이를 업데이트할 때는 GitHub 커밋 로그를 수동으로 스캔해야 합니다.

**프레임워크와 같이 엄선된 환경 밖에서 React를 사용하는 대부분 사람은 Stable 릴리즈를 계속 사용하기를 원할 것으로 예상합니다.** 하지만 프레임워크를 구축하는 경우 특정 커밋에 고정된 React의 Canary 버전을 bundle로 묶어 원하는 속도로 업데이트하는 것을 고려할 수 있습니다. 이 방법의 장점은 지난 몇 년 동안 React Native가 해왔던 방식과 유사하게, 완성된 개별 React 기능 및 버그 수정을 사용자에게 더 일찍, 자체 릴리즈 일정에 맞춰 제공할 수 있다는 것입니다. 단점은 어떤 React 커밋을 가져오는지 검토하고 릴리즈에 어떤 React 변경 사항이 포함되었는지 사용자에게 알리는 추가적인 책임을 져야 한다는 것입니다.
**프레임워크와 같이 엄선된 환경 밖에서 React를 사용하는 대부분 사람은 Stable 릴리즈를 계속 사용하기를 원할 것으로 예상합니다.** 하지만 프레임워크를 구축하는 경우 특정 커밋에 고정된 React의 Canary 버전을 번들로 묶어 원하는 속도로 업데이트하는 것을 고려할 수 있습니다. 이 방법의 장점은 지난 몇 년 동안 React Native가 해왔던 방식과 유사하게, 완성된 개별 React 기능 및 버그 수정을 사용자에게 더 일찍, 자체 릴리즈 일정에 맞춰 제공할 수 있다는 것입니다. 단점은 어떤 React 커밋을 가져오는지 검토하고 릴리즈에 어떤 React 변경 사항이 포함되었는지 사용자에게 알리는 추가적인 책임을 져야 한다는 것입니다.

프레임워크 작성자로서 이 접근 방식을 시도해 보고 싶다면, 저희에게 연락해 주세요.

Expand All @@ -77,7 +77,7 @@ Canary 릴리즈는 특정 시점에 다음 안정된 React 릴리즈에 포함

지난 [3월에 발표했듯이](/blog/2023/03/22/react-labs-what-we-have-been-working-on-march-2023#react-server-components) React Server 컴포넌트 컨벤션은 확정되었으며, 사용자 대면 API 계약과 관련된 중대한 변경 사항은 없을 것으로 예상됩니다. 그러나 서로 얽혀 있는 여러 프레임워크 전용 기능([에셋 로딩](/blog/2023/03/22/react-labs-what-we-have-been-working-on-march-2023#asset-loading)과 같은)에 대한 작업이 진행 중이며, 더 많은 변경 사항이 있을 것으로 예상되기 때문에 아직 안정된 버전의 React에서 React Server 컴포넌트에 대한 지원을 릴리즈할 수는 없습니다.

즉, React Server 컴포넌트가 프레임워크에 채택될 준비가 되었다는 뜻입니다. 그러나 다음 주요 React 릴리즈가 나올 때까지 프레임워크가 이를 채택할 수 있는 유일한 방법은 고정된 Canary 버전의 React를 출시하는 것입니다. (두 개의 React 복사본이 bundle로 제공되는 것을 피하고자, 이를 원하는 프레임워크는 프레임워크와 함께 제공하는 고정된 Canary에 `react``react-dom`의 해결 방법을 적용하고 사용자에게 이를 설명해야 합니다. 예를 들어, 이것이 Next.js App Router가 하는 일입니다.)
즉, React Server 컴포넌트가 프레임워크에 채택될 준비가 되었다는 뜻입니다. 그러나 다음 주요 React 릴리즈가 나올 때까지 프레임워크가 이를 채택할 수 있는 유일한 방법은 고정된 Canary 버전의 React를 출시하는 것입니다. (두 개의 React 복사본이 번들로 제공되는 것을 피하고자, 이를 원하는 프레임워크는 프레임워크와 함께 제공하는 고정된 Canary에 `react``react-dom`의 해결 방법을 적용하고 사용자에게 이를 설명해야 합니다. 예를 들어, 이것이 Next.js App Router가 하는 일입니다.)

## Stable 및 Canary 버전 모두에 대해 라이브러리 테스트하기 {/*testing-libraries-against-both-stable-and-canary-versions*/}

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -75,7 +75,7 @@ Canary는 React의 개발 방식을 변경하는 것입니다. 이전에는 기

React 서버 컴포넌트, 에셋 불러오기, 문서 메타데이터 및 액션 모두 React Canary에 도입되었으며, 이러한 기능에 대한 문서를 react.dev에 추가했습니다.

- **지시어**: [`"use client"`](/reference/rsc/use-client)[`"use server"`](/reference/rsc/use-server)는 풀스택 React 프레임워크를 위해 설계한 bundler 기능입니다. 이들은 두 환경 사이의 "분할점"을 나타냅니다. "use client"는 [Astro Islands](https://docs.astro.build/en/concepts/islands/#creating-an-island)처럼 bundler에 `<script>` 태그를 생성하도록 지시합니다. 반면 `"use server"`[tRPC Mutations](https://trpc.io/docs/concepts)처럼 bundler에 POST 엔드포인트를 생성하도록 지시합니다. 두 지시어를 함께 사용하여 클라이이언트 측의 상호작용을 서버 측의 로직과 결합하는 재사용 가능한 컴포넌트를 작성할 수 있습니다.
- **지시어**: [`"use client"`](/reference/rsc/use-client)[`"use server"`](/reference/rsc/use-server)는 풀스택 React 프레임워크를 위해 설계한 번들러 기능입니다. 이들은 두 환경 사이의 "분할점"을 나타냅니다. "use client"는 [Astro Islands](https://docs.astro.build/en/concepts/islands/#creating-an-island)처럼 번들러에 `<script>` 태그를 생성하도록 지시합니다. 반면 `"use server"`[tRPC Mutations](https://trpc.io/docs/concepts)처럼 번들러에 POST 엔드포인트를 생성하도록 지시합니다. 두 지시어를 함께 사용하여 클라이이언트 측의 상호작용을 서버 측의 로직과 결합하는 재사용 가능한 컴포넌트를 작성할 수 있습니다.

- **문서 메타데이터**: 우리는 컴포넌트 트리 어디에서든 [`<title>`](/reference/react-dom/components/title), [`<meta>`](/reference/react-dom/components/meta) 및 메타데이터 [`<link>`](/reference/react-dom/components/link) 태그를 렌더링하는 내장 지원을 추가했습니다. 이는 완전한 클라이언트 측 코드, SSR 및 RSC를 포함한 모든 환경에서 동일하게 작동합니다. 이는 [React Helmet](https://github.com/nfl/react-helmet)과 같은 라이브러리가 이미 제공하던 기능을 내장 지원으로 제공합니다.

Expand Down
2 changes: 1 addition & 1 deletion src/content/learn/describing-the-ui.md
Original file line number Diff line number Diff line change
Expand Up @@ -546,7 +546,7 @@ React 렌더 트리 예시

</Diagram>

의존성 트리는 종종 빌드 도구에 의해 클라이언트가 다운로드하고 렌더링하는 데 필요한 모든 관련 자바스크립트 코드를 bundle 하는 데에 사용됩니다. 큰 bundle 크기는 React 앱의 사용자 경험을 저하합니다. 모듈 의존성 트리를 이해하는 것은 이러한 문제를 디버깅하는 데 도움이 됩니다.
의존성 트리는 종종 빌드 도구에 의해 클라이언트가 다운로드하고 렌더링하는 데 필요한 모든 관련 자바스크립트 코드를 번들하는 데에 사용됩니다. 큰 번들 크기는 React 앱의 사용자 경험을 저하합니다. 모듈 의존성 트리를 이해하는 것은 이러한 문제를 디버깅하는 데 도움이 됩니다.

<LearnMore path="/learn/understanding-your-ui-as-a-tree">

Expand Down
2 changes: 1 addition & 1 deletion src/content/reference/react/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -17,7 +17,7 @@ React의 프로그래밍 기능.
* [Hooks](/reference/react/hooks) - 컴포넌트에서 다양한 React 기능을 사용하세요.
* [컴포넌트](/reference/react/components) - JSX에서 사용할 수 있는 내장 컴포넌트입니다.
* [API](/reference/react/apis) - 컴포넌트 정의에 유용한 API들을 다룹니다.
* [지시어](/reference/rsc/directives) - React 서버 컴포넌트와 호환되는 Bundler에게 지시를 제공합니다.
* [지시어](/reference/rsc/directives) - React 서버 컴포넌트와 호환되는 번들러에게 지시를 제공합니다.

## React DOM {/*react-dom*/}

Expand Down
2 changes: 1 addition & 1 deletion src/content/reference/rsc/directives.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,7 @@ canary: true

<Intro>

지시어는 [React 서버 컴포넌트와 호환되는 bundlers](/learn/start-a-new-react-project#bleeding-edge-react-frameworks)에게 지시사항을 제공합니다.
지시어는 [React 서버 컴포넌트와 호환되는 번들러](/learn/start-a-new-react-project#bleeding-edge-react-frameworks)에게 지시사항을 제공합니다.

</Intro>

Expand Down
27 changes: 27 additions & 0 deletions textlint/data/rules/translateGlossary.js
Original file line number Diff line number Diff line change
Expand Up @@ -430,6 +430,33 @@ module.exports = {
note: '',
},
},
{
sources: [/\bBundles?\b/],
target: '번들',
meta: {
term: 'Bundle',
discussions: [829],
note: '',
},
},
{
sources: [/\bBundlers?\b/],
target: '번들러',
meta: {
term: 'Bundler',
discussions: [829],
note: '',
},
},
{
sources: [/\bBundling\b/],
target: '번들링',
meta: {
term: 'Bundling',
discussions: [829],
note: '',
},
},
],
others: [
{
Expand Down
3 changes: 3 additions & 0 deletions wiki/translate-glossary.md
Original file line number Diff line number Diff line change
Expand Up @@ -55,6 +55,9 @@ Full-Stack|`/\bFull[-\s]?Stack\b/`|풀스택|[#569](https://github.com/reactjs/k
Browser|`/\bBrowser\b/`|브라우저|[#610](https://github.com/reactjs/ko.react.dev/issues/610)||
Extension|`/\bExtension\b/`, `/확장프로그램/`|확장 프로그램|[#610](https://github.com/reactjs/ko.react.dev/issues/610)||
Escape Hatches|`/\bEscape[-\s]?Hatches\b/`|탈출구|[#738](https://github.com/reactjs/ko.react.dev/issues/738)||
Bundle|`/\bBundles?\b/`|번들|[#829](https://github.com/reactjs/ko.react.dev/issues/829)||
Bundler|`/\bBundlers?\b/`|번들러|[#829](https://github.com/reactjs/ko.react.dev/issues/829)||
Bundling|`/\bBundling\b/`|번들링|[#829](https://github.com/reactjs/ko.react.dev/issues/829)||

### Others

Expand Down

0 comments on commit 31262c8

Please sign in to comment.