瀏覽代碼

doc: TypeScript: add placeholder for chinese translation

David Peicho 5 年之前
父節點
當前提交
5a684e05a9
共有 2 個文件被更改,包括 47 次插入0 次删除
  1. 1 0
      docs/list.js
  2. 46 0
      docs/manual/zh/introduction/Typescript-setup.html

+ 1 - 0
docs/list.js

@@ -460,6 +460,7 @@ var list = {
 				"浏览器支持": "manual/zh/introduction/Browser-support",
 				"WebGL兼容性检查": "manual/zh/introduction/WebGL-compatibility-check",
 				"如何在本地运行Three.js": "manual/zh/introduction/How-to-run-things-locally",
+				"Typescript setup": "manual/zh/introduction/Typescript-setup",
 				"如何使用WebGL 2": "manual/zh/introduction/How-to-use-WebGL2",
 				"画线": "manual/zh/introduction/Drawing-lines",
 				"创建文字": "manual/zh/introduction/Creating-text",

+ 46 - 0
docs/manual/zh/introduction/Typescript-setup.html

@@ -0,0 +1,46 @@
+<!DOCTYPE html>
+<html lang="en">
+	<head>
+		<meta charset="utf-8">
+		<base href="../../../" />
+		<script src="list.js"></script>
+		<script src="page.js"></script>
+		<link type="text/css" rel="stylesheet" href="page.css" />
+	</head>
+	<body>
+		<h1>[name]</h1>
+
+		<p>
+			three.js is a JavaScript-based library. However, it's possible to use it in a TypeScript project, as the library
+			exposes [link:https://www.typescriptlang.org/docs/handbook/declaration-files/introduction.html Declaration Files] (*d.ts* files).
+		</p>
+
+		<p>
+			A minimal configuration is required for the TypeScript compiler to
+			discover three.js types.<br>
+			You will need to set the [link:https://www.typescriptlang.org/docs/handbook/module-resolution.html moduleResolution]
+			option to *node*, and the [link:https://www.typescriptlang.org/docs/handbook/compiler-options.html target] option to *es6* or newer.
+		</p>
+
+		<code>
+		// Example of minimal `tsconfig.json` file
+		{
+			"compilerOptions": {
+				"target": "es6",
+				"moduleResolution": "node",
+			},
+			"include": [ "./src/**/*.ts" ],
+		}
+		</code>
+
+		<p>
+			Note: As of today, it's not yet possible to use three.js typings without using those two options.
+		</p>
+
+		<p>
+			Note: It happens that some declarations are incorrect and/or missing.
+			Contributing to Declaration Files is really helpful for the community, making three.js
+			typings better and more accurate.
+		</p>
+	</body>
+</html>