generate-static-params.mdx by kordobby · Pull Request #375 · Nextjs-kr/Nextjs.kr

kordobby · 2023-07-01T04:35:00Z

기여자용

문서 개선

PR을 열기 전에 pnpm prettier-fix를 실행하여 서식 문제를 해결합니다. - 문서 기여 가이드를 읽고 문서 지침을 따르는지 확인하세요: https://github.com/Nextjs-kr/Nextjs.ko/blob/main/packages/next/README.md

Progress

pnpm prettier-fix
번역 초안 작성 (Draft translation)
공통 스타일 가이드 확인 (Check the common style guide)
모범사례 확인 (Check best practices)
용어 확인 (Check the term)
맞춤법 검사 (Spelling check)
리뷰 반영 (Resolve reviews)

closes #79

devyuriii · 2023-07-02T01:12:47Z

ref #79

chaejunlee

기여해주셔서 감사합니다! 커멘트 확인해주시고 수정해주세요!

chaejunlee · 2023-07-20T15:16:23Z

 ---

-The `generateStaticParams` function can be used in combination with [dynamic route segments](/docs/app/building-your-application/routing/dynamic-routes) to [**statically generate**](/docs/app/building-your-application/rendering/static-and-dynamic-rendering#static-rendering-default) routes at build time instead of on-demand at request time.
+`generateStaticParams` 함수는 요청 타임 대신에 빌드 타임에 [dynamic route segments](/docs/app/building-your-application/routing/dynamic-routes) to [**statically generate**](/docs/app/building-your-application/rendering/static-and-dynamic-rendering#static-rendering-default) routes 와 함께 사용 가능합니다.


Suggested change

`generateStaticParams` 함수는 요청 타임 대신에 빌드 타임에 [dynamic route segments](/docs/app/building-your-application/routing/dynamic-routes) to [**statically generate**](/docs/app/building-your-application/rendering/static-and-dynamic-rendering#static-rendering-default) routes 와 함께 사용 가능합니다.

`generateStaticParams` 함수는 [동적 라우트 세그먼트](/docs/app/building-your-application/routing/dynamic-routes)와 함께 사용하여 요청 시에 실시간으로 라우트를 만드는 것이 아닌 빌드 타임에 라우트를 [**정적으로 생성**](/docs/app/building-your-application/rendering/static-and-dynamic-rendering#static-rendering-default) 할 수 있습니다.

번역 놓치신 부분이 있네요!

chaejunlee · 2023-07-20T15:17:35Z

 ```

-> **Good to know**
+> **알아두면 좋은 점**


Suggested change

> **알아두면 좋은 점**

> **참고**

기여 가이드에 따라 참고로 수정해주세요!

chaejunlee · 2023-07-20T15:19:32Z

-> - During `next build`, `generateStaticParams` runs before the corresponding Layouts or Pages are generated.
-> - During revalidation (ISR), `generateStaticParams` will not be called again.
-> - `generateStaticParams` replaces the [`getStaticPaths`](/docs/pages/api-reference/functions/get-static-paths) function in the Pages Router.
+> - `generateStaticParams`로 생성되지 않은 동적 세그먼트를 조회했을 때 일어나는 것들을 [`dynamicParams`](/docs/app/api-reference/file-conventions/route-segment-config#dynamicparams) 세그먼트 컨피그 옵션을 사용해 제어할 수 있습니다.


Suggested change

> - `generateStaticParams`로 생성되지 않은 동적 세그먼트를 조회했을 때 일어나는 것들을 [`dynamicParams`](/docs/app/api-reference/file-conventions/route-segment-config#dynamicparams) 세그먼트 컨피그 옵션을 사용해 제어할 수 있습니다.

> - `generateStaticParams`로 생성되지 않은 동적 세그먼트를 조회했을 때의 동작을 [`dynamicParams`](/docs/app/api-reference/file-conventions/route-segment-config#dynamicparams) 세그먼트 설정 옵션을 사용해 제어할 수 있습니다.

chaejunlee · 2023-07-20T15:20:04Z

-> - During revalidation (ISR), `generateStaticParams` will not be called again.
-> - `generateStaticParams` replaces the [`getStaticPaths`](/docs/pages/api-reference/functions/get-static-paths) function in the Pages Router.
+> - `generateStaticParams`로 생성되지 않은 동적 세그먼트를 조회했을 때 일어나는 것들을 [`dynamicParams`](/docs/app/api-reference/file-conventions/route-segment-config#dynamicparams) 세그먼트 컨피그 옵션을 사용해 제어할 수 있습니다.
+> - `next dev`가 실행되는 동안, `generateStaticParams` 는 route 로 이동하는 할 때 호출될 것입니다.


Suggested change

> - `next dev`가 실행되는 동안, `generateStaticParams` 는 route 로 이동하는 할 때 호출될 것입니다.

> - `next dev`가 실행되는 동안, `generateStaticParams`는 라우트로 이동할 때 호출됩니다.

chaejunlee · 2023-07-20T15:22:39Z

+> - `generateStaticParams`로 생성되지 않은 동적 세그먼트를 조회했을 때 일어나는 것들을 [`dynamicParams`](/docs/app/api-reference/file-conventions/route-segment-config#dynamicparams) 세그먼트 컨피그 옵션을 사용해 제어할 수 있습니다.
+> - `next dev`가 실행되는 동안, `generateStaticParams` 는 route 로 이동하는 할 때 호출될 것입니다.
+> - `next build`가 실행되는 동안, `generateStaticParams` 는 일치하는 레이아웃 또는 페이지가 생성되기 전에 실행됩니다.
+> - revalidation 이 일어나는 동안(ISR), `generateStaticParams` 는 다시 호출되지 않습니다.


Suggested change

> - revalidation 이 일어나는 동안(ISR), `generateStaticParams` 는 다시 호출되지 않습니다.

> - 재검증(ISR)이 일어나는 동안, `generateStaticParams`는 다시 호출되지 않습니다.

chaejunlee · 2023-07-20T15:34:31Z

+하위 경로 세그먼트의 `generateStaticParams` 함수는 상위 `generateStaticParams`가 생성하는 각 세그먼트에 대해 한 번씩 실행됩니다.

-The child `generateStaticParams` function can use the `params` returned from the parent `generateStaticParams` function to dynamically generate its own segments.
+하위 `generateStaticParams` 함수는 상위 `generateStaticParams` 함수에서 반환된 `params`를 사용해 자체 세그먼트를 동적으로 생성할 수 있습니다.


Suggested change

하위 `generateStaticParams` 함수는 상위 `generateStaticParams` 함수에서 반환된 `params`를 사용해 자체 세그먼트를 동적으로 생성할 수 있습니다.

자식 `generateStaticParams` 함수는 부모 `generateStaticParams` 함수에서 반환된 `params`를 사용해 자체 세그먼트를 동적으로 생성할 수 있습니다.

chaejunlee · 2023-07-20T15:34:45Z

 ```tsx filename="app/products/[category]/[product]/page.tsx" switcher
-// Generate segments for [product] using the `params` passed from
-// the parent segment's `generateStaticParams` function
+// 상위 세그먼트의 `generateStaticParams` 함수에서 전달된 `params`를 사용하여


Suggested change

// 상위 세그먼트의 `generateStaticParams` 함수에서 전달된 `params`를 사용하여

// 부모 세그먼트의 `generateStaticParams` 함수에서 전달된 `params`를 사용하여

chaejunlee · 2023-07-20T15:35:04Z

 ```jsx filename="app/products/[category]/[product]/page.js" switcher
-// Generate segments for [product] using the `params` passed from
-// the parent segment's `generateStaticParams` function
+// 상위 세그먼트의 `generateStaticParams` 함수에서 전달된 `params`를 사용하여


Suggested change

// 상위 세그먼트의 `generateStaticParams` 함수에서 전달된 `params`를 사용하여

// 부모 세그먼트의 `generateStaticParams` 함수에서 전달된 `params`를 사용하여

chaejunlee · 2023-07-20T15:37:40Z

 ```

-> **Good to know**: When rendering a route, Next.js will [automatically deduplicate `fetch` requests](/docs/app/building-your-application/data-fetching#automatic-fetch-request-deduping) for the same data across `generateMetadata`, `generateStaticParams`, Layouts, Pages, and Server Components. React [`cache` can be used](/docs/app/building-your-application/data-fetching/caching#react-cache) if `fetch` is unavailable.
+> **알아두면 좋은 점**: 경로를 렌더링할 때, Next.js 는 `generateMetadata`, `generateStaticParams`, 레이아웃, 페이지와 서버 컴포넌트에서 동일한 데이터에 대한 요청이 있다면 [자동으로 `fetch` 요청에 대해 중복건을 제거](/docs/app/building-your-application/data-fetching#automatic-fetch-request-deduping) 할 것입니다. 리액트에서 `fetch` 가 사용이 불가하다면 [`캐시` 를 사용할 수 있습니다.](/docs/app/building-your-application/data-fetching/caching#react-cache)


Suggested change

> **알아두면 좋은 점**: 경로를 렌더링할 때, Next.js 는 `generateMetadata`, `generateStaticParams`, 레이아웃, 페이지와 서버 컴포넌트에서 동일한 데이터에 대한 요청이 있다면 [자동으로 `fetch` 요청에 대해 중복건을 제거](/docs/app/building-your-application/data-fetching#automatic-fetch-request-deduping) 할 것입니다. 리액트에서 `fetch` 가 사용이 불가하다면 [`캐시` 를 사용할 수 있습니다.](/docs/app/building-your-application/data-fetching/caching#react-cache)

> **참고**: 경로를 렌더링할 때, Next.js 는 `generateMetadata`, `generateStaticParams`, 레이아웃, 페이지와 서버 컴포넌트에 걸쳐서 동일한 데이터에 대한 [`fetch` 요청의 중복을 자동으로 제거](/docs/app/building-your-application/data-fetching#automatic-fetch-request-deduping)합니다. 리액트에서 `fetch`를 사용할 수 없다면 [`cache`를 사용할 수 있습니다.](/docs/app/building-your-application/data-fetching/caching#react-cache)

chaejunlee · 2023-07-20T15:38:20Z

+| 버전       | 변경사항                             |
 | --------- | ---------------------------------- |
-| `v13.0.0` | `generateStaticParams` introduced. |
+| `v13.0.0` | `generateStaticParams` 안내         |


chaejunlee

~~기여해주셔서 감사합니다! 커멘트 확인해주시고 수정해주세요!~~

네트워크 오류로 2번 제출되었네요! 😅

ChanghyeonYoon · 2023-09-06T11:17:14Z

@kordobby 리뷰 이후 작업이 몇일 동안 이뤄지지 않아 9월 13일까지 작업이 없을 경우 이슈를 close하고 새로운 분에게 할당하겠습니다!

translate. kordobby

6d70bc3

kordobby requested a review from ChanghyeonYoon as a code owner July 1, 2023 04:35

ChanghyeonYoon added the documentation 문서 작업 label Jul 1, 2023

devyuriii assigned kordobby Jul 2, 2023

devyuriii mentioned this pull request Jul 2, 2023

🚀New Next.js Docs Translation Progress (Korean) #1

Open

chaejunlee reviewed Jul 20, 2023

View reviewed changes

chaejunlee added the In Review label Jul 20, 2023

	`generateStaticParams` 함수는 요청 타임 대신에 빌드 타임에 [dynamic route segments](/docs/app/building-your-application/routing/dynamic-routes) to [statically generate](/docs/app/building-your-application/rendering/static-and-dynamic-rendering#static-rendering-default) routes 와 함께 사용 가능합니다.
	`generateStaticParams` 함수는 [동적 라우트 세그먼트](/docs/app/building-your-application/routing/dynamic-routes)와 함께 사용하여 요청 시에 실시간으로 라우트를 만드는 것이 아닌 빌드 타임에 라우트를 [정적으로 생성](/docs/app/building-your-application/rendering/static-and-dynamic-rendering#static-rendering-default) 할 수 있습니다.

	> - `generateStaticParams`로 생성되지 않은 동적 세그먼트를 조회했을 때 일어나는 것들을 [`dynamicParams`](/docs/app/api-reference/file-conventions/route-segment-config#dynamicparams) 세그먼트 컨피그 옵션을 사용해 제어할 수 있습니다.
	> - `generateStaticParams`로 생성되지 않은 동적 세그먼트를 조회했을 때의 동작을 [`dynamicParams`](/docs/app/api-reference/file-conventions/route-segment-config#dynamicparams) 세그먼트 설정 옵션을 사용해 제어할 수 있습니다.

	> - `next dev`가 실행되는 동안, `generateStaticParams` 는 route 로 이동하는 할 때 호출될 것입니다.
	> - `next dev`가 실행되는 동안, `generateStaticParams`는 라우트로 이동할 때 호출됩니다.

	> - revalidation 이 일어나는 동안(ISR), `generateStaticParams` 는 다시 호출되지 않습니다.
	> - 재검증(ISR)이 일어나는 동안, `generateStaticParams`는 다시 호출되지 않습니다.

	하위 `generateStaticParams` 함수는 상위 `generateStaticParams` 함수에서 반환된 `params`를 사용해 자체 세그먼트를 동적으로 생성할 수 있습니다.
	자식 `generateStaticParams` 함수는 부모 `generateStaticParams` 함수에서 반환된 `params`를 사용해 자체 세그먼트를 동적으로 생성할 수 있습니다.

	// 상위 세그먼트의 `generateStaticParams` 함수에서 전달된 `params`를 사용하여
	// 부모 세그먼트의 `generateStaticParams` 함수에서 전달된 `params`를 사용하여

	\| `v13.0.0` \| `generateStaticParams` 안내 \|
	\| `v13.0.0` \| `generateStaticParams` 도입 \|

Conversation

kordobby commented Jul 1, 2023 • edited by chaejunlee Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

기여자용

문서 개선

Progress

Uh oh!

devyuriii commented Jul 2, 2023

Uh oh!

chaejunlee left a comment

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

chaejunlee left a comment • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

ChanghyeonYoon commented Sep 6, 2023

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

kordobby commented Jul 1, 2023 •

edited by chaejunlee

Loading

chaejunlee left a comment •

edited

Loading