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

translate 3 files into korean #1420

Closed
wants to merge 3 commits into from
Closed

translate 3 files into korean #1420

wants to merge 3 commits into from

Conversation

h01010
Copy link

@h01010 h01010 commented Dec 13, 2020

en :

ref : #910

번역 리뷰 요청드립니다 : @yeonjuan @guyeol @dvlprsh

감사합니다 :)

@github-actions
Copy link
Contributor

Thanks for the PR!

This section of the codebase is owned by @bumkeyy - if they write a comment saying "LGTM" then it will be merged.

translatable: true
---

이 게시물은 TypeScript의 모듈과 namespace를 사용하여 코드를 구성하는 다양한 방법에 관해 설명합니다.
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
이 게시물은 TypeScript의 모듈과 namespace를 사용하여 코드를 구성하는 다양한 방법에 관해 설명합니다.
이번 장에서는 TypeScript 모듈과 namespace를 사용하여 코드를 구성하는 다양한 방법에 대해 설명합니다.

[제안]

---

이 게시물은 TypeScript의 모듈과 namespace를 사용하여 코드를 구성하는 다양한 방법에 관해 설명합니다.
또한 namespace와 모듈을 사용하는 방법의 고급 주제들을 살펴보고, 그것들을 TypeScript에서 사용할 때 주의해야 할 일반적인 함정을 설명할 것입니다.
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
또한 namespace와 모듈을 사용하는 방법의 고급 주제들을 살펴보고, 그것들을 TypeScript에서 사용할 때 주의해야 할 일반적인 함정을 설명할 것입니다.
또한 namespace와 모듈을 사용하는 방법의 고급 주제들을 살펴보고, 그것들을 TypeScript에서 사용할 때 빠지기 쉬운 함정에 대해 설명합니다.

[제안]

ES Module에 대한 자세한 내용은 [Modules](/docs/handbook/modules.html) 설명서를 참고하시길 바랍니다.
TypeScript namespace에 대한 자세한 내용은 [Namespaces](/docs/handbook/namespaces.html) 설명서를 참고하시길 바랍니다.

참고 : TypeScript namespace의 "매우" 예전 버전에서는 'Internal Modules'이라고 불렷으며, JavaScript 모듈 시스템 전 버전이다.
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
참고 : TypeScript namespace의 "매우" 예전 버전에서는 'Internal Modules'이라고 불렷으며, JavaScript 모듈 시스템 전 버전이다.
참고 : TypeScript namespace의 "아주" 오래된 버전에서는 'Internal Modules'이라고 불렸으며, JavaScript 모듈 시스템의 이전 버전입니다.


모듈은 코드와 선언을 모두 포함할 수 있습니다.

모듈은 또한 모듈 로더 (예 : CommonJs/Require.js) 또는 ES Module을 지원하는 런타임에 대한 의존성을 갖습니다.
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
모듈은 또한 모듈 로더 (예 : CommonJs/Require.js) 또는 ES Module을 지원하는 런타임에 대한 의존성을 갖습니다.
또한 모듈은 모듈 로더 (예 : CommonJs/Require.js) 혹은 ES Module을 지원하는 런타임에 의존성을 갖습니다.

[제안]

모듈은 또한 모듈 로더 (예 : CommonJs/Require.js) 또는 ES Module을 지원하는 런타임에 대한 의존성을 갖습니다.
모듈은 더 나은 코드의 재사용, 더 강력한 분리 및 번들링을 위한 더 나은 도구 지원을 제공합니다.

Node.js 어플리케이션의 경우, 모듈이 기본이고 **현대 코드에서는 namespace보다 모듈을 권장한다는 점**도 주목할 필요가 있을 것입니다.
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
Node.js 어플리케이션의 경우, 모듈이 기본이고 **현대 코드에서는 namespace보다 모듈을 권장한다는 점**도 주목할 필요가 있을 것입니다.
Node.js 어플리케이션에서는, 모듈이 기본 설정이며 **현대 코드에서는 namespace보다 모듈을 권장한다는 점**도 주목할 필요가 있습니다.

미래형보다는 현재형이 조금 덜 어색한 것 같아요.

Node.js 어플리케이션의 경우, 모듈이 기본이고 **현대 코드에서는 namespace보다 모듈을 권장한다는 점**도 주목할 필요가 있을 것입니다.

ECMAScript 2015부터, 모듈은 언어의 기본 부분이며, 모든 호환 엔진 구현에서 지원되어야 합니다.
따라서 새 프로젝트의 경우 모듈은 권장되는 코드 구성 매커니즘입니다.
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
따라서 새 프로젝트의 경우 모듈은 권장되는 코드 구성 매커니즘입니다.
따라서 모듈은 새로운 프로젝트에서 권장되는 코드 구성 매커니즘입니다.

[제안]


## Namespaces 사용하기

Namespace는 코드를 구성하는 TypeScript만의 방법입니다.
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
Namespace는 코드를 구성하는 TypeScript만의 방법입니다.
namespace는 코드를 구성하는 TypeScript만의 방법입니다.

## Namespaces 사용하기

Namespace는 코드를 구성하는 TypeScript만의 방법입니다.
Namespcae는 단순히 전역 namespace에서 이름이 지정된 JavaScript 객체입니다.
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
Namespcae는 단순히 전역 namespace에서 이름이 지정된 JavaScript 객체입니다.
namespcae는 단순히 전역 namespace에서 이름이 지정된 JavaScript 객체입니다.


Namespace는 코드를 구성하는 TypeScript만의 방법입니다.
Namespcae는 단순히 전역 namespace에서 이름이 지정된 JavaScript 객체입니다.
이것은 Namespce를 사용하기 매우 간단한 구조로 만듭니다.
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
이것은 Namespce를 사용하기 매우 간단한 구조로 만듭니다.
이것은 namespace를 사용하기 매우 간단한 구조로 만듭니다.

Namespcae는 단순히 전역 namespace에서 이름이 지정된 JavaScript 객체입니다.
이것은 Namespce를 사용하기 매우 간단한 구조로 만듭니다.
모듈과 달리, 여러 파일에 걸쳐있을 수 있으며, `--outFile`를 사용하여 연결할 수 있습니다.
Namespace는 HTML 페이지에 `<script>`로 포함된 모든 의존성을 가진 웹 어플리케이션에서 코드를 구조화하는 좋은 방법이 될 수 있습니다.
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
Namespace는 HTML 페이지에 `<script>`로 포함된 모든 의존성을 가진 웹 어플리케이션에서 코드를 구조화하는 좋은 방법이 될 수 있습니다.
namespace는 HTML 페이지에 `<script>`로 포함된 모든 의존성을 가진 웹 어플리케이션에서 코드를 구조화하는 좋은 방법이 될 수 있습니다.

모듈과 달리, 여러 파일에 걸쳐있을 수 있으며, `--outFile`를 사용하여 연결할 수 있습니다.
Namespace는 HTML 페이지에 `<script>`로 포함된 모든 의존성을 가진 웹 어플리케이션에서 코드를 구조화하는 좋은 방법이 될 수 있습니다.

모든 글로벌 namespace 오염과 마찬가지로, 특히 큰 규모의 어플리케이션에서 구성 요소 의존성을 식별하기가 어려울 수 있습니다.
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
모든 글로벌 namespace 오염과 마찬가지로, 특히 큰 규모의 어플리케이션에서 구성 요소 의존성을 식별하기가 어려울 수 있습니다.
모든 전역 namespace 오염과 마찬가지로, 특히 큰 규모의 어플리케이션에서 구성 요소 의존성을 식별하기가 어려울 수 있습니다.

앞에 번역과 통일하면 좋을 것 같아요. :)


## Namespace와 모듈의 함정

이 섹션에서는 namespcae와 module을 사용할 때 발생하는 다양한 일반적인 함정과, 이를 피하는 방법에 관해 설명할 것입니다.
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
이 섹션에서는 namespcae와 module을 사용할 때 발생하는 다양한 일반적인 함정과, 이를 피하는 방법에 관해 설명할 것입니다.
이 섹션에서는 namespace와 module을 사용할 때 발생하는 다양한 일반적인 함정과, 이를 피하는 방법에 관해 설명할 것입니다.

@bumkeyy
Copy link
Contributor

bumkeyy commented Dec 28, 2020

@syj1198

Namespaces and Modules.md 해당 파일에서
modules는 모듈로 namespace는 원문으로 번역하셨는데, 파일을 다시 읽다보니
하나로 통일되는게 좀 더 일관성 있어 보여요.

전 모듈과 네임스페이스로 전부 번역하는게 괜찮아 보이는데 어떠세요?

다른 분들 의견도 궁금합니다 :)
@yeonjuan @guyeol @dvlprsh

oneline: "Enable error reporting in type-checked JavaScript files."
---

`allowJs`와 함께 작동합니다. `checkJs` 이 사용가능하다면 에러는 JavaScript 파일에 보고됩니다.
Copy link
Contributor

@bumkeyy bumkeyy Dec 28, 2020

Choose a reason for hiding this comment

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

Suggested change
`allowJs`와 함께 작동합니다. `checkJs` 이 사용가능하다면 에러는 JavaScript 파일에 보고됩니다.
`allowJs`와 함께 작동합니다. `checkJs` 가 활성화되어 있다면 오류가 JavaScript 파일에 보고됩니다.

사용 가능이라는 뜻보다 활성화가 더 명확한 뜻 같아요.

---

`allowJs`와 함께 작동합니다. `checkJs` 이 사용가능하다면 에러는 JavaScript 파일에 보고됩니다.
이것은 당신의 프로젝트에 포함된 모든 JavaScript 파일의 제일 위에 `// @ts-check`을 포함하는 것과 동일합니다.
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
이것은 당신의 프로젝트에 포함된 모든 JavaScript 파일의 제일 위에 `// @ts-check`을 포함하는 것과 동일합니다.
이것은 프로젝트에 포함된 모든 JavaScript 파일의 제일 위에 `// @ts-check`을 포함하는 것과 동일합니다.

2인칭 주어는 생략하는게 덜 어색합니다 :)

console.log(pi);
```

당신은 어떠한 에러도 발생시키지 않을 것입니다. 하지만, 만약 당신이 `checkJs` 를 킨다면 당신은 JavaScript 파일로부터 얻을 것입니다.
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
당신은 어떠한 에러도 발생시키지 않을 것입니다. 하지만, 만약 당신이 `checkJs`킨다면 당신은 JavaScript 파일로부터 얻을 것입니다.
위 코드는 어떠한 오류도 발생시키지 않을 것입니다. 하지만, 만약 `checkJs`활성화한다면 JavaScript 파일로부터 오류를 얻게 됩니다.

`allowJs`와 함께 작동합니다. `checkJs` 이 사용가능하다면 에러는 JavaScript 파일에 보고됩니다.
이것은 당신의 프로젝트에 포함된 모든 JavaScript 파일의 제일 위에 `// @ts-check`을 포함하는 것과 동일합니다.

예를 들어, TypeScript와 함께 제공되는 `parseFloat` 에 따르면 이것은 잘못된 JavaScript입니다 :
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
예를 들어, TypeScript와 함께 제공되는 `parseFloat` 따르면 이것은 잘못된 JavaScript입니다 :
예를 들어, TypeScript와 함께 제공되는 `parseFloat` 타입 정의에 따르면 이것은 잘못된 JavaScript입니다 :


> **용어에 대한 참고 사항:**
> 유의할 점은 TypeScript 1.5에서 명칭이 변경되었다는 것입니다.
"Internal modules"은 이제 "namespaces"입니다.
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
"Internal modules"은 이제 "namespaces"입니다.
> "Internal modules"은 이제 "namespaces"입니다.

원문 문법을 맞춰주세요.

> **용어에 대한 참고 사항:**
> 유의할 점은 TypeScript 1.5에서 명칭이 변경되었다는 것입니다.
"Internal modules"은 이제 "namespaces"입니다.
"External modules"은 이제 [ECMAScript 2015](http://www.ecma-international.org/ecma-262/6.0/)'s terminology와 용어를 일치하기 위해 간단히 "moduls"입니다, (이름대로 `module X {`은 현재 선호되는 `namespace X {`와 동일합니다).
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
"External modules"은 이제 [ECMAScript 2015](http://www.ecma-international.org/ecma-262/6.0/)'s terminology와 용어를 일치하기 위해 간단히 "moduls"입니다, (이름대로 `module X {`은 현재 선호되는 `namespace X {`와 동일합니다).
> "External modules"은 이제 [ECMAScript 2015](http://www.ecma-international.org/ecma-262/6.0/)'s terminology와 용어를 일치하기 위해 간단히 "modules"입니다, (이름대로 `module X {`은 현재 선호되는 `namespace X {`와 동일합니다).

"Internal modules"은 이제 "namespaces"입니다.
"External modules"은 이제 [ECMAScript 2015](http://www.ecma-international.org/ecma-262/6.0/)'s terminology와 용어를 일치하기 위해 간단히 "moduls"입니다, (이름대로 `module X {`은 현재 선호되는 `namespace X {`와 동일합니다).

이 게시물은 TypeScript에서 namespaces(이전의 "internal modules")를 사용하여 코드를 작성하는 다양한 방법에 대해서 간략히 설명합니다.
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
게시물은 TypeScript에서 namespaces(이전의 "internal modules")를 사용하여 코드를 작성하는 다양한 방법에 대해서 간략히 설명합니다.
장에서는 TypeScript에서 namespaces(이전의 "internal modules")를 사용하여 코드를 작성하는 다양한 방법에 대해서 간략히 설명합니다.

이 게시물은 TypeScript에서 namespaces(이전의 "internal modules")를 사용하여 코드를 작성하는 다양한 방법에 대해서 간략히 설명합니다.
우리가 용어에 대한 참고사항에 언급했듯이, "internal modules"는 이제 "namespaces"라고 불립니다.
또한 internal modules를 선언할 때 `module` 키워드를 사용한 어디에서나 `namespace` 키워드는 사용될 수 있고 대신 사용해야만 합니다.
이것은 유사하게 명명된 용어의 중복사용으로 인해 새로운 사용자를 혼란스럽게 하는 것을 방지한다.
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
이것은 유사하게 명명된 용어의 중복사용으로 인해 새로운 사용자를 혼란스럽게 하는 것을 방지한다.
이것은 유사하게 명명된 용어의 중복 사용으로 인해 새로운 사용자를 혼란스럽게 하는 것을 방지합니다.


## 첫 번째 단계

이 페이지 전체에서 우리가 예시로 사용할 프로그램을 시작해봅시다.
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
페이지 전체에서 우리가 예시로 사용할 프로그램을 시작해봅시다.
장에서 예시로 사용할 프로그램을 시작해봅시다.

[제안]

## 첫 번째 단계

이 페이지 전체에서 우리가 예시로 사용할 프로그램을 시작해봅시다.
우리는 웹 페이지의 양식에 적힌 사용자의 입력을 확인하거나 외부에서 제공된 데이터 파일의 형식을 확인하기 위해 작성할 수 있는, 간단한 문자열 검증기 세트를 작성하였습니다.
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
우리는 웹 페이지의 양식에 적힌 사용자의 입력을 확인하거나 외부에서 제공된 데이터 파일의 형식을 확인하기 위해 작성할 수 있는, 간단한 문자열 검증기 세트를 작성하였습니다.
우리는 웹 페이지의 양식에 적힌 사용자의 입력을 확인하거나 외부에서 제공된 데이터 파일의 형식을 확인하기 위해 작성할 수 있는, 간단한 문자열 검증기 세트를 작성했습니다.

}
```

## 파일들로 분할하기
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
## 파일들로 분할하기
## 파일로 분할하기


## 파일들로 분할하기

우리의 어플리케이션이 성장함에 따라, 우리는 유지 보수가 용이하도록 코드를 여러 파일로 분할하고 싶을 것이다.
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
우리의 어플리케이션이 성장함에 따라, 우리는 유지 보수가 용이하도록 코드를 여러 파일로 분할하고 싶을 것이다.
어플리케이션의 크기가 증가함에 따라, 유지 보수가 용이하도록 코드를 여러 파일로 분할하고 싶을 것 입니다.

@bumkeyy
Copy link
Contributor

bumkeyy commented Dec 29, 2020

@syj1198

문서의 어투를 경어체로 통일해주세요 :)

@orta
Copy link
Contributor

orta commented Jan 25, 2021

Poke @syj1198 thanks for your PR! - You've still got some time to handle the feedback from @bumkeyy

Otherwise I'll close this PR at the end of the week, because we're moving these PRs into their own repos re: #1480

@orta
Copy link
Contributor

orta commented Feb 1, 2021

Sorry folks - I'm going to close this PR, I'd love to see this get re-created on the new repo though!

https://github.com/microsoft/TypeScript-Website-Localizations

@orta orta closed this Feb 1, 2021
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging this pull request may close these issues.

None yet

3 participants