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
Conversation
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를 사용하여 코드를 구성하는 다양한 방법에 관해 설명합니다. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
이 게시물은 TypeScript의 모듈과 namespace를 사용하여 코드를 구성하는 다양한 방법에 관해 설명합니다. | |
이번 장에서는 TypeScript 모듈과 namespace를 사용하여 코드를 구성하는 다양한 방법에 대해 설명합니다. |
[제안]
--- | ||
|
||
이 게시물은 TypeScript의 모듈과 namespace를 사용하여 코드를 구성하는 다양한 방법에 관해 설명합니다. | ||
또한 namespace와 모듈을 사용하는 방법의 고급 주제들을 살펴보고, 그것들을 TypeScript에서 사용할 때 주의해야 할 일반적인 함정을 설명할 것입니다. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
또한 namespace와 모듈을 사용하는 방법의 고급 주제들을 살펴보고, 그것들을 TypeScript에서 사용할 때 주의해야 할 일반적인 함정을 설명할 것입니다. | |
또한 namespace와 모듈을 사용하는 방법의 고급 주제들을 살펴보고, 그것들을 TypeScript에서 사용할 때 빠지기 쉬운 함정에 대해 설명합니다. |
[제안]
ES Module에 대한 자세한 내용은 [Modules](/docs/handbook/modules.html) 설명서를 참고하시길 바랍니다. | ||
TypeScript namespace에 대한 자세한 내용은 [Namespaces](/docs/handbook/namespaces.html) 설명서를 참고하시길 바랍니다. | ||
|
||
참고 : TypeScript namespace의 "매우" 예전 버전에서는 'Internal Modules'이라고 불렷으며, JavaScript 모듈 시스템 전 버전이다. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
참고 : TypeScript namespace의 "매우" 예전 버전에서는 'Internal Modules'이라고 불렷으며, JavaScript 모듈 시스템 전 버전이다. | |
참고 : TypeScript namespace의 "아주" 오래된 버전에서는 'Internal Modules'이라고 불렸으며, JavaScript 모듈 시스템의 이전 버전입니다. |
|
||
모듈은 코드와 선언을 모두 포함할 수 있습니다. | ||
|
||
모듈은 또한 모듈 로더 (예 : CommonJs/Require.js) 또는 ES Module을 지원하는 런타임에 대한 의존성을 갖습니다. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
모듈은 또한 모듈 로더 (예 : CommonJs/Require.js) 또는 ES Module을 지원하는 런타임에 대한 의존성을 갖습니다. | |
또한 모듈은 모듈 로더 (예 : CommonJs/Require.js) 혹은 ES Module을 지원하는 런타임에 의존성을 갖습니다. |
[제안]
모듈은 또한 모듈 로더 (예 : CommonJs/Require.js) 또는 ES Module을 지원하는 런타임에 대한 의존성을 갖습니다. | ||
모듈은 더 나은 코드의 재사용, 더 강력한 분리 및 번들링을 위한 더 나은 도구 지원을 제공합니다. | ||
|
||
Node.js 어플리케이션의 경우, 모듈이 기본이고 **현대 코드에서는 namespace보다 모듈을 권장한다는 점**도 주목할 필요가 있을 것입니다. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Node.js 어플리케이션의 경우, 모듈이 기본이고 **현대 코드에서는 namespace보다 모듈을 권장한다는 점**도 주목할 필요가 있을 것입니다. | |
Node.js 어플리케이션에서는, 모듈이 기본 설정이며 **현대 코드에서는 namespace보다 모듈을 권장한다는 점**도 주목할 필요가 있습니다. |
미래형보다는 현재형이 조금 덜 어색한 것 같아요.
Node.js 어플리케이션의 경우, 모듈이 기본이고 **현대 코드에서는 namespace보다 모듈을 권장한다는 점**도 주목할 필요가 있을 것입니다. | ||
|
||
ECMAScript 2015부터, 모듈은 언어의 기본 부분이며, 모든 호환 엔진 구현에서 지원되어야 합니다. | ||
따라서 새 프로젝트의 경우 모듈은 권장되는 코드 구성 매커니즘입니다. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
따라서 새 프로젝트의 경우 모듈은 권장되는 코드 구성 매커니즘입니다. | |
따라서 모듈은 새로운 프로젝트에서 권장되는 코드 구성 매커니즘입니다. |
[제안]
|
||
## Namespaces 사용하기 | ||
|
||
Namespace는 코드를 구성하는 TypeScript만의 방법입니다. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Namespace는 코드를 구성하는 TypeScript만의 방법입니다. | |
namespace는 코드를 구성하는 TypeScript만의 방법입니다. |
## Namespaces 사용하기 | ||
|
||
Namespace는 코드를 구성하는 TypeScript만의 방법입니다. | ||
Namespcae는 단순히 전역 namespace에서 이름이 지정된 JavaScript 객체입니다. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Namespcae는 단순히 전역 namespace에서 이름이 지정된 JavaScript 객체입니다. | |
namespcae는 단순히 전역 namespace에서 이름이 지정된 JavaScript 객체입니다. |
|
||
Namespace는 코드를 구성하는 TypeScript만의 방법입니다. | ||
Namespcae는 단순히 전역 namespace에서 이름이 지정된 JavaScript 객체입니다. | ||
이것은 Namespce를 사용하기 매우 간단한 구조로 만듭니다. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
이것은 Namespce를 사용하기 매우 간단한 구조로 만듭니다. | |
이것은 namespace를 사용하기 매우 간단한 구조로 만듭니다. |
Namespcae는 단순히 전역 namespace에서 이름이 지정된 JavaScript 객체입니다. | ||
이것은 Namespce를 사용하기 매우 간단한 구조로 만듭니다. | ||
모듈과 달리, 여러 파일에 걸쳐있을 수 있으며, `--outFile`를 사용하여 연결할 수 있습니다. | ||
Namespace는 HTML 페이지에 `<script>`로 포함된 모든 의존성을 가진 웹 어플리케이션에서 코드를 구조화하는 좋은 방법이 될 수 있습니다. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Namespace는 HTML 페이지에 `<script>`로 포함된 모든 의존성을 가진 웹 어플리케이션에서 코드를 구조화하는 좋은 방법이 될 수 있습니다. | |
namespace는 HTML 페이지에 `<script>`로 포함된 모든 의존성을 가진 웹 어플리케이션에서 코드를 구조화하는 좋은 방법이 될 수 있습니다. |
모듈과 달리, 여러 파일에 걸쳐있을 수 있으며, `--outFile`를 사용하여 연결할 수 있습니다. | ||
Namespace는 HTML 페이지에 `<script>`로 포함된 모든 의존성을 가진 웹 어플리케이션에서 코드를 구조화하는 좋은 방법이 될 수 있습니다. | ||
|
||
모든 글로벌 namespace 오염과 마찬가지로, 특히 큰 규모의 어플리케이션에서 구성 요소 의존성을 식별하기가 어려울 수 있습니다. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
모든 글로벌 namespace 오염과 마찬가지로, 특히 큰 규모의 어플리케이션에서 구성 요소 의존성을 식별하기가 어려울 수 있습니다. | |
모든 전역 namespace 오염과 마찬가지로, 특히 큰 규모의 어플리케이션에서 구성 요소 의존성을 식별하기가 어려울 수 있습니다. |
앞에 번역과 통일하면 좋을 것 같아요. :)
|
||
## Namespace와 모듈의 함정 | ||
|
||
이 섹션에서는 namespcae와 module을 사용할 때 발생하는 다양한 일반적인 함정과, 이를 피하는 방법에 관해 설명할 것입니다. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
이 섹션에서는 namespcae와 module을 사용할 때 발생하는 다양한 일반적인 함정과, 이를 피하는 방법에 관해 설명할 것입니다. | |
이 섹션에서는 namespace와 module을 사용할 때 발생하는 다양한 일반적인 함정과, 이를 피하는 방법에 관해 설명할 것입니다. |
oneline: "Enable error reporting in type-checked JavaScript files." | ||
--- | ||
|
||
`allowJs`와 함께 작동합니다. `checkJs` 이 사용가능하다면 에러는 JavaScript 파일에 보고됩니다. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
`allowJs`와 함께 작동합니다. `checkJs` 이 사용가능하다면 에러는 JavaScript 파일에 보고됩니다. | |
`allowJs`와 함께 작동합니다. `checkJs` 가 활성화되어 있다면 오류가 JavaScript 파일에 보고됩니다. |
사용 가능이라는 뜻보다 활성화가 더 명확한 뜻 같아요.
--- | ||
|
||
`allowJs`와 함께 작동합니다. `checkJs` 이 사용가능하다면 에러는 JavaScript 파일에 보고됩니다. | ||
이것은 당신의 프로젝트에 포함된 모든 JavaScript 파일의 제일 위에 `// @ts-check`을 포함하는 것과 동일합니다. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
이것은 당신의 프로젝트에 포함된 모든 JavaScript 파일의 제일 위에 `// @ts-check`을 포함하는 것과 동일합니다. | |
이것은 프로젝트에 포함된 모든 JavaScript 파일의 제일 위에 `// @ts-check`을 포함하는 것과 동일합니다. |
2인칭 주어는 생략하는게 덜 어색합니다 :)
console.log(pi); | ||
``` | ||
|
||
당신은 어떠한 에러도 발생시키지 않을 것입니다. 하지만, 만약 당신이 `checkJs` 를 킨다면 당신은 JavaScript 파일로부터 얻을 것입니다. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
당신은 어떠한 에러도 발생시키지 않을 것입니다. 하지만, 만약 당신이 `checkJs` 를 킨다면 당신은 JavaScript 파일로부터 얻을 것입니다. | |
위 코드는 어떠한 오류도 발생시키지 않을 것입니다. 하지만, 만약 `checkJs` 를 활성화한다면 JavaScript 파일로부터 오류를 얻게 됩니다. |
`allowJs`와 함께 작동합니다. `checkJs` 이 사용가능하다면 에러는 JavaScript 파일에 보고됩니다. | ||
이것은 당신의 프로젝트에 포함된 모든 JavaScript 파일의 제일 위에 `// @ts-check`을 포함하는 것과 동일합니다. | ||
|
||
예를 들어, TypeScript와 함께 제공되는 `parseFloat` 에 따르면 이것은 잘못된 JavaScript입니다 : |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
예를 들어, TypeScript와 함께 제공되는 `parseFloat` 에 따르면 이것은 잘못된 JavaScript입니다 : | |
예를 들어, TypeScript와 함께 제공되는 `parseFloat` 타입 정의에 따르면 이것은 잘못된 JavaScript입니다 : |
|
||
> **용어에 대한 참고 사항:** | ||
> 유의할 점은 TypeScript 1.5에서 명칭이 변경되었다는 것입니다. | ||
"Internal modules"은 이제 "namespaces"입니다. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
"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 {`와 동일합니다). |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
"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")를 사용하여 코드를 작성하는 다양한 방법에 대해서 간략히 설명합니다. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
이 게시물은 TypeScript에서 namespaces(이전의 "internal modules")를 사용하여 코드를 작성하는 다양한 방법에 대해서 간략히 설명합니다. | |
이 장에서는 TypeScript에서 namespaces(이전의 "internal modules")를 사용하여 코드를 작성하는 다양한 방법에 대해서 간략히 설명합니다. |
이 게시물은 TypeScript에서 namespaces(이전의 "internal modules")를 사용하여 코드를 작성하는 다양한 방법에 대해서 간략히 설명합니다. | ||
우리가 용어에 대한 참고사항에 언급했듯이, "internal modules"는 이제 "namespaces"라고 불립니다. | ||
또한 internal modules를 선언할 때 `module` 키워드를 사용한 어디에서나 `namespace` 키워드는 사용될 수 있고 대신 사용해야만 합니다. | ||
이것은 유사하게 명명된 용어의 중복사용으로 인해 새로운 사용자를 혼란스럽게 하는 것을 방지한다. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
이것은 유사하게 명명된 용어의 중복사용으로 인해 새로운 사용자를 혼란스럽게 하는 것을 방지한다. | |
이것은 유사하게 명명된 용어의 중복 사용으로 인해 새로운 사용자를 혼란스럽게 하는 것을 방지합니다. |
|
||
## 첫 번째 단계 | ||
|
||
이 페이지 전체에서 우리가 예시로 사용할 프로그램을 시작해봅시다. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
이 페이지 전체에서 우리가 예시로 사용할 프로그램을 시작해봅시다. | |
이 장에서 예시로 사용할 프로그램을 시작해봅시다. |
[제안]
## 첫 번째 단계 | ||
|
||
이 페이지 전체에서 우리가 예시로 사용할 프로그램을 시작해봅시다. | ||
우리는 웹 페이지의 양식에 적힌 사용자의 입력을 확인하거나 외부에서 제공된 데이터 파일의 형식을 확인하기 위해 작성할 수 있는, 간단한 문자열 검증기 세트를 작성하였습니다. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
우리는 웹 페이지의 양식에 적힌 사용자의 입력을 확인하거나 외부에서 제공된 데이터 파일의 형식을 확인하기 위해 작성할 수 있는, 간단한 문자열 검증기 세트를 작성하였습니다. | |
우리는 웹 페이지의 양식에 적힌 사용자의 입력을 확인하거나 외부에서 제공된 데이터 파일의 형식을 확인하기 위해 작성할 수 있는, 간단한 문자열 검증기 세트를 작성했습니다. |
} | ||
``` | ||
|
||
## 파일들로 분할하기 |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
## 파일들로 분할하기 | |
## 파일로 분할하기 |
|
||
## 파일들로 분할하기 | ||
|
||
우리의 어플리케이션이 성장함에 따라, 우리는 유지 보수가 용이하도록 코드를 여러 파일로 분할하고 싶을 것이다. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
우리의 어플리케이션이 성장함에 따라, 우리는 유지 보수가 용이하도록 코드를 여러 파일로 분할하고 싶을 것이다. | |
어플리케이션의 크기가 증가함에 따라, 유지 보수가 용이하도록 코드를 여러 파일로 분할하고 싶을 것 입니다. |
@syj1198 문서의 어투를 경어체로 통일해주세요 :) |
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 |
en :
ref : #910
번역 리뷰 요청드립니다 : @yeonjuan @guyeol @dvlprsh
감사합니다 :)