Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

02-app > 01-building-your-application > 06-configuring > 11-draft-mode.mdx #401

Merged
merged 5 commits into from
Sep 14, 2023

Conversation

CaesiumY
Copy link
Contributor

@CaesiumY CaesiumY commented Jul 3, 2023

issue #163

기여자용

문서 개선

Progress


딱딱한 직역 스타일로 진행했는데 부드러운 의역 스타일을 원하신다면 언제든지 말씀해주세요!

@haileyport
Copy link
Contributor

ref #163

Copy link
Contributor

@YuriKwon YuriKwon left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

고생 많으셨습니다! 👍🏻
리뷰 확인 및 수정 부탁드립니다:)

@@ -1,20 +1,24 @@
---
title: Draft Mode
description: Next.js has draft mode to toggle between static and dynamic pages. You can learn how it works with App Router here.
title: 초안 모드
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
title: 초안 모드
title: 드래프트 모드

다른 문서에서 draftMode를 '드래프트 모드'로 번역한 부분이 있습니다!

통일을 위해 초안 모드 -> 드래프트 모드로 변경 부탁드립니다:)
이 부분 외에도 전체적으로 적용 부탁드려요!

title: Draft Mode
description: Next.js has draft mode to toggle between static and dynamic pages. You can learn how it works with App Router here.
title: 초안 모드
description: Next.js에는 정적 페이지와 동적 페이지 사이를 전환할 수 있는 초안 모드가 있습니다. 이 문서에서 App Router와 함께 작동하는 방법을 알아볼 수 있습니다.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
description: Next.js에는 정적 페이지와 동적 페이지 사이를 전환할 수 있는 초안 모드가 있습니다. 이 문서에서 App Router와 함께 작동하는 방법을 알아볼 수 있습니다.
description: Next.js에는 정적 페이지와 동적 페이지를 전환할 수 있는 드래프트 모드가 있습니다. 이 문서에서 드래프트 모드가 App Router와 함께 작동하는 방법을 알아볼 수 있습니다.

---

Static rendering is useful when your pages fetch data from a headless CMS. However, it’s not ideal when you’re writing a draft on your headless CMS and want to view the draft immediately on your page. You’d want Next.js to render these pages at **request time** instead of build time and fetch the draft content instead of the published content. You’d want Next.js to to switch to [dynamic rendering](/docs/app/building-your-application/rendering/static-and-dynamic-rendering) only for this specific case.
정적 렌더링은 페이지가 Headless CMS에서 데이터를 가져올 때 유용합니다.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
정적 렌더링은 페이지가 Headless CMS에서 데이터를 가져올 때 유용합니다.
정적 렌더링은 페이지가 헤드리스 CMS에서 데이터를 가져올 때 유용합니다.

이 부분도 마찬가지로 전체적으로 적용 부탁드립니다!

Comment on lines 6 to 10
정적 렌더링은 페이지가 Headless CMS에서 데이터를 가져올 때 유용합니다.
하지만 Headless CMS에서 초안을 작성하고 페이지에서 초안을 바로 확인하려는 경우에는 이런 방식이 적합하지 않습니다.
이럴 때는 페이지를 빌드 시간이 아닌 **요청 시간**에 렌더링하고,
게시된 콘텐츠 대신 초안 콘텐츠를 가져오는 것이 Next.js에게 필요한 기능일 것입니다.
또한 이러한 특정 경우에만 Next.js가 [동적 렌더링](/docs/app/building-your-application/rendering/static-and-dynamic-rendering)으로 전환하기를 원할 것입니다.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

6~10번 라인이 기존에 줄 바꿈 없이 한 줄 안에(6번 라인에) 들어가 있는 듯해요!
원문 스타일 유지를 위해 줄 바꿈 없이 작성 부탁드립니다!

---

Static rendering is useful when your pages fetch data from a headless CMS. However, it’s not ideal when you’re writing a draft on your headless CMS and want to view the draft immediately on your page. You’d want Next.js to render these pages at **request time** instead of build time and fetch the draft content instead of the published content. You’d want Next.js to to switch to [dynamic rendering](/docs/app/building-your-application/rendering/static-and-dynamic-rendering) only for this specific case.
정적 렌더링은 페이지가 Headless CMS에서 데이터를 가져올 때 유용합니다.
하지만 Headless CMS에서 초안을 작성하고 페이지에서 초안을 바로 확인하려는 경우에는 이런 방식이 적합하지 않습니다.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
하지만 Headless CMS에서 초안을 작성하고 페이지에서 초안을 바로 확인하려는 경우에는 이런 방식이 적합하지 않습니다.
하지만 Headless CMS에서 초안을 작성하고 페이지에서 초안을 바로 확인하려고 하는 경우에는 정적 렌더링 방식이 적합하지 않습니다.

import { draftMode } from 'next/headers'
import { redirect } from 'next/navigation'

export async function GET(request) {
// Parse query string parameters
// 매개 변수로 들어온 쿼리 스트링을 파싱합니다
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
// 매개 변수로 들어온 쿼리 스트링을 파싱합니다
// 매개변수로 들어온 쿼리 스트링을 파싱합니다


```tsx filename="app/page.tsx" switcher
// page that fetches data
// 데이터를 가져오는 페이지 컴포넌트
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
// 데이터를 가져오는 페이지 컴포넌트
// 데이터를 가져오는 페이지

원문에 component라는 단어가 없어서, 이렇게 수정하면 어떨까요? 의견 부탁드립니다!

@@ -172,7 +176,7 @@ export default async function Page() {
```

```jsx filename="app/page.js" switcher
// page that fetches data
// 데이터를 가져오는 페이지 컴포넌트
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

(이전 리뷰와 동일 내용)

Comment on lines 206 to 207
끝입니다! 이제 Headless CMS를 통하거나 수동으로 초안 모드가 활성화된 라우트 핸들러에 접근하면(비밀 토큰과 `slug` 필요) 초안의 내용을 볼 수 있습니다.
그리고 게시하지 않고도 업데이트된 초안 내용을 볼 수 있게 됩니다.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
끝입니다! 이제 Headless CMS를 통하거나 수동으로 초안 모드가 활성화된 라우트 핸들러에 접근하면(비밀 토큰과 `slug` 필요) 초안의 내용을 볼 수 있습니다.
그리고 게시하지 않고도 업데이트된 초안 내용을 볼 수 있게 됩니다.
끝입니다! 이제 Headless CMS를 통하거나 수동으로 초안 모드가 활성화된 라우트 핸들러에 접근하면(비밀 토큰과 `slug` 필요) 초안의 내용을 볼 수 있습니다. 또한 초안을 게시하지 않고도 업데이트한 초안 내용을 볼 수 있습니다.


> **Good to know**: To test Draft Mode locally over HTTP, your browser will need to allow third-party cookies and local storage access.
> **알아두면 좋은 정보**: HTTP를 통해 로컬에서 초안 모드를 테스트하려면 브라우저에서 서드파티 쿠키 및 로컬 스토리지 접근을 허용해야 합니다.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
> **알아두면 좋은 정보**: HTTP를 통해 로컬에서 초안 모드를 테스트하려면 브라우저에서 서드파티 쿠키 및 로컬 스토리지 접근을 허용해야 합니다.
> **참고**: HTTP를 통해 로컬에서 초안 모드를 테스트하려면, 브라우저에서 서드파티 쿠키 및 로컬 스토리지 접근을 허용해야 합니다.

Good to know는 참고 로 번역합니다!
(https://github.com/Nextjs-kr/Nextjs.kr/wiki/Translate-Glossary)

@ChanghyeonYoon
Copy link
Contributor

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

@CaesiumY
Copy link
Contributor Author

깜빡하고 있다가 보게 돼서 급하게 올립니다😓

말씀해주신 부분 수정과 다시 읽다가 불분명한 부분을 수정했습니다.

추가로 질문 사항이 있는데
'초안 모드' 를 '드래프트 모드' 로 일괄 수정했습니다만 그냥 '초안' 도 '드래프트' 로 바꾸어야 할까요?

감사합니다! 👍👍👍

@yoo-jimin127
Copy link
Contributor

@CaesiumY 님 안녕하세요!
드래프트 모드가 아닌 경우 초안으로 번역하셔도 될 것 같습니다!

Copy link
Contributor

@yoo-jimin127 yoo-jimin127 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM! 기여해주셔서 감사합니다 :)
추가 논의 사항으로 올려주신 "초안"의 경우 타 공식 문서에서도 "초안"으로 사용하고 있는 경우가 많아 유지해도 될 것으로 판단되어 어프루브 후 머지 진행하겠습니다.
추가적으로 번역 희망하시는 챕터의 경우 이슈에 작성 부탁드립니다! ☺️

@yoo-jimin127 yoo-jimin127 merged commit 94df39a into Nextjs-kr:main Sep 14, 2023
@yoo-jimin127 yoo-jimin127 mentioned this pull request Sep 14, 2023
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Projects
None yet
Development

Successfully merging this pull request may close these issues.

5 participants