add translation for getting-started.md

11 years ago · fce4ee48f9
1 changed files with 120 additions and 0 deletions
--- a/docs/getting-started.zh-CN.md
+++ b/docs/getting-started.zh-CN.md
@ -0,0 +1,120 @@
+---
+id: getting-started-zh-CN
+title: 开始
+layout: docs
+next: tutorial.html
+---
+
+## JSFiddle
+
+开始 Hack React 的最简单的方法是用下面 JSFiddle 的Hello Worlds
+
+ * **[React JSFiddle](http://jsfiddle.net/vjeux/kb3gN/)**
+ * [React JSFiddle without JSX](http://jsfiddle.net/vjeux/VkebS/)
+
+## 新手教程包 (Starter Kit)
+
+开始先下载新手教程包
+
+<div class="buttons-unit downloads">
+  <a href="/react/downloads/react-{{site.react_version}}.zip" class="button">
+    下载新手教程包 {{site.react_version}}
+  </a>
+</div>
+
+在新手教程包的根目录，创建一个含有下面代码的`helloworld.html`
+
+```html
+<!DOCTYPE html>
+<html>
+  <head>
+    <script src="build/react.js"></script>
+    <script src="build/JSXTransformer.js"></script>
+  </head>
+  <body>
+    <div id="example"></div>
+    <script type="text/jsx">
+      /** @jsx React.DOM */
+      React.renderComponent(
+        <h1>Hello, world!</h1>,
+        document.getElementById('example')
+      );
+    </script>
+  </body>
+</html>
+```
+
+在 JavaScript 代码里写着 XML 格式的代码称为 JSX；可以去 [JSX 语法](/react/docs/jsx-in-depth.html) 里学习更多 JSX 相关的知识。为了把 JSX 转成标准的 JavaScript，我们用 `<script type="text/jsx">` 标签包裹着含有 JSX 的代码，然后引入 `JSXTransformer.js` 库来实现在浏览器里的代码转换。
+
+### 分离文件
+
+你的 React JSX 代码文件可以写在另外的文件里。新建下面的 `src/helloworld.js`。
+
+```javascript
+/** @jsx React.DOM */
+React.renderComponent(
+  <h1>Hello, world!</h1>,
+  document.getElementById('example')
+);
+```
+
+然后在 `helloworld.html` 引用该文件：
+ 
+```html{10}
+<script type="text/jsx" src="src/helloworld.js"></script>
+```
+
+### 离线转换
+
+先安装命令行工具（依赖 [npm](http://npmjs.org/)）：
+
+```
+npm install -g react-tools
+```
+
+然后把你的 `src/helloworld.js` 文件转成标准的 JavaScript:
+
+```
+jsx --watch src/ build/
+
+```
+
+只要你修改了， `build/helloworld.js` 文件会自动生成。
+
+```javascript{3}
+/** @jsx React.DOM */
+React.renderComponent(
+  React.DOM.h1(null, 'Hello, world!'),
+  document.getElementById('example')
+);
+```
+
+> 注意:
+>
+> 目前注释解析器还是非常严格；为了让它能够找出 `@jsx` 修饰符，有两个限制是必须的。`@jsx` 注释块必须是代码文件第一个注释。注释必须以 `/**` (`/*` 和 `//` 不起作用) 开头。如果解析器找不到 `@jsx` 注释，它就不会转换代码，直接原样输出到文件。
+
+对照下面更新你的 HTML 代码
+
+```html{6,10}
+<!DOCTYPE html>
+<html>
+  <head>
+    <title>Hello React!</title>
+    <script src="build/react.js"></script>
+    <!-- No need for JSXTransformer! -->
+  </head>
+  <body>
+    <div id="example"></div>
+    <script src="build/helloworld.js"></script>
+  </body>
+</html>
+```
+
+## 想用 CommonJS？
+
+如果你想在一个模块系统里使用 React，[fork 我们的代码](http://github.com/facebook/react)， `npm install` 然后运行 `grunt`。一个漂亮的 CommonJS 模块集将会被生成。我们的 `jsx` 转换工具可以很轻松的集成到大部分打包系统里（不仅仅是 CommonJS）。
+
+## 下一步
+
+去看看[入门教程](/react/docs/tutorial.html)，然后学习其他在 `/examples` 目录里的示例代码。祝你好运，欢迎来到 React 的世界。
+