Add files from old Korean repo to ko

Author: jihoon-seo

docs/documentation/ko/declaration-files/templates/module-class.d.ts.md

@@ -0,0 +1,83 @@
+---
+title: "Module: Class"
+layout: docs
+permalink: /ko/docs/handbook/declaration-files/templates/module-class-d-ts.html
+---
+
+<!--
+TODO:
+
+1. Not clear why UMD is thrown in here.
+2. Give both commonjs and ES module examples.
+-->
+
+예를 들어 다음과 같은 자바스크립트 코드를 다루는 경우를 가정합시다.
+
+```ts
+const Greeter = require("super-greeter");
+
+const greeter = new Greeter();
+greeter.greet();
+```
+
+UMD 또는 일반 모듈을 임포팅하는 두 가지 경우 모두에 대해 대응하려면 다음을 참고합니다.
+
+```ts
+// Type definitions for [~라이브러리 이름~] [~선택적 버전 숫자~]
+// Project: [~프로젝트 이름~]
+// Definitions by: [~내 이름~] <[~내 URL~]>
+
+/*~ 클래스 모듈을 위한 모듈 템플릿 입니다.
+ *~ 이름을 index.d.ts로 변경하고, 모듈 이름의 폴더에 배치해야 합니다.
+ *~ 예를 들어, "super-greeter" 파일을 작성하는 경우
+ *~ 이 파일은 'super-greeter/index.d.ts'가 되어야 합니다.
+ */
+
+// ES6 모듈은 직접 클래스 객체를 export할 수 없습니다.
+// 이 파일은 CommonJS-style을 사용해서 import 해야 합니다.
+//   import x = require('[~THE MODULE~]');
+//
+// 또한, --allowSyntheticDefaultImports 나
+// --esModuleInterop 옵션을 활성화한다면,
+// default import로 import할 수 있습니다:
+//   import x from '[~THE MODULE~]';
+//
+// ES6 모듈의 제한에 대한 일반적인 해결 방법을 이해하려면
+// https://www.typescriptlang.org/docs/handbook/modules.html#export--and-import--require
+// 에서 TypeScript 문서를 참고하세요.
+
+/*~ 전역 변수 'myClassLib'을 노출하는 UMD 모듈을
+ *~ 모듈 로더 환경 외부에서 로드하려면, 여기에서 전역으로 선언하세요.
+ *~ 그렇지 않으면, 이 선언을 제거하세요.
+ */
+export as namespace "super-greeter";
+
+/*~ 이 선언은 클래스 생성자 함수를
+ *~ 파일에서 export된 객체로 지정합니다.
+ */
+export = Greeter;
+
+/*~ 이 클래스에서 모듈 메서드와 프로퍼티를 지정합니다. */
+declare class Greeter {
+  constructor(customGreeting?: string);
+
+  greet: void;
+
+  myMethod(opts: MyClass.MyClassMethodOptions): number;
+}
+
+/*~ 모듈에서 타입을 노출하려면
+ *~ 이 블록 안에 위치시키세요.
+ *~
+ *~ 네임스페이스를 포함할 경우,
+ *~ --esModuleInterop 이 설정되어 있지 않으면,
+ *~ 모듈을 네임 스페이스 객체로 잘못 import 할 수 있습니다:
+ *~   import * as x from '[~THE MODULE~]'; // 오류! 이렇게 하지 마세요!
+ */
+declare namespace MyClass {
+  export interface MyClassMethodOptions {
+    width?: number;
+    height?: number;
+  }
+}
+```

docs/documentation/ko/declaration-files/templates/module-function.d.ts.md

@@ -0,0 +1,85 @@
+---
+title: "Module: Function"
+layout: docs
+permalink: /ko/docs/handbook/declaration-files/templates/module-function-d-ts.html
+---
+
+예를 들어 다음과 같은 자바스크립트 코드를 다루는 경우를 가정합시다.
+
+```ts
+import greeter from "super-greeter";
+
+greeter(2);
+greeter("Hello world");
+```
+
+UMD 또는 일반 모듈을 임포팅하는 두 가지 경우 모두에 대해 대응하려면 다음을 참고합니다.
+
+```ts
+// Type definitions for [~라이브러리 이름~] [~선택적 버전 숫자~]
+// Project: [~프로젝트 이름~]
+// Definitions by: [~내 이름~] <[~내 URL~]>
+
+/*~ 함수 모듈을 위한 모듈 템플릿 입니다.
+ *~ 이름을 index.d.ts로 변경하고, 모듈과 같은 이름의 폴더 안에 배치해야 합니다.
+ *~ 예를 들어, "super-greeter" 파일을 작성하는 경우
+ *~ 이 파일은 'super-greeter/index.d.ts'가 되어야 합니다.
+ */
+
+// ES6 모듈은 클래스 객체를 직접 export할 수 없습니다.
+// 이 파일은 CommonJS-스타일을 사용해서 import 해야 합니다:
+//   import x = require('[~THE MODULE~]');
+//
+// 또한, --allowSyntheticDefaultImports 나
+// --esModuleInterop 옵션을 활성화한다면,
+// default import로 import할 수 있습니다:
+//   import x from '[~THE MODULE~]';
+//
+// ES6 모듈의 제한에 대한 일반적인 해결방법을 이해하려면
+// https://www.typescriptlang.org/docs/handbook/modules.html#export--and-import--require
+// 에서 TypeScript 문서를 참고하세요.
+
+/*~ 전역 변수 'myFuncLib'을 노출하는 UMD 모듈을
+ *~ 모듈 로더 환경 외부에서 로드하려면, 여기에서 전역으로 선언하세요.
+ *~ 그렇지 않으면, 이 선언을 제거하세요.
+ */
+export as namespace myFuncLib;
+
+/*~ 이 선언은 함수를
+ *~ 파일에서 export된 객체로 지정합니다.
+ */
+export = Greeter;
+
+/*~ 이 예제는 함수에 대한 여러 오버로드하는 방법을 보여줍니다 */
+declare function Greeter(name: string): Greeter.NamedReturnType;
+declare function Greeter(length: number): Greeter.LengthReturnType;
+
+/*~ 모듈에서 타입을 노출하고 싶다면,
+ *~ 이 블록 안에 위치시키세요. 종종 함수 반환 타입의 형태를
+ *~ 기술하고 싶을 수 있습니다; 그 타입은
+ *~ 이 예제처럼 여기에 선언하세요.
+ *~
+ *~ 네임스페이스를 포함할 경우,
+ *~ 모듈을 네임스페이스 객체로 잘못 import 할 수 있습니다.
+ *~ --esModuleInterop 옵션을 활성화하세요:
+ *~   import * as x from '[~THE MODULE~]'; // 오류! 이렇게 하지 마세요!
+ */
+declare namespace Greeter {
+  export interface LengthReturnType {
+    width: number;
+    height: number;
+  }
+  export interface NamedReturnType {
+    firstName: string;
+    lastName: string;
+  }
+
+  /*~ 모듈이 프로퍼티를 갖고 있다면, 여기에 선언하세요. 예를 들어
+   *~ 이 선언은 이 코드가 합법적임을 의미합니다:
+   *~   import f = require('super-greeter');
+   *~   console.log(f.defaultName);
+   */
+  export const defaultName: string;
+  export let defaultLength: number;
+}
+```