Update Chinese translation.

src/docs/asciidoc/zh-Hans-CN/documentation.adoc

@@ -1,8 +1,7 @@
 = jMonkeyEngine 说明文档
 :author: yanmaoyuan
-:revnumber:
+:revnumber: 1.0
 :revdate: 2018/01/15 16:41
-:relfileprefix: ../
 :imagesdir: ../
 :keywords: documentation, sdk, install
 ifdef::env-github,env-browser[:outfilesuffix: .adoc]
@@ -10,12 +9,11 @@ ifdef::env-github,env-browser[:outfilesuffix: .adoc]
 
 本wiki页面包含jME3的安装和配置指南、jME3编程教程以及其他一些能够帮助你开发游戏项目的资料，请善用本页右上方的搜索框来检索整个wiki中的内容。
 
-本文翻译自英文版<<documentation#,jME文档>>，受编者水平所限，难免存在各种各样的问题。如果您在阅读的过程中发现任何错误，非常欢迎您直接修正错误的内容。编辑此页面需要link:http://hub.jmonkeyengine.org[官方论坛]账号，然后点击本页右上角的“Tools → Login登录。登录后点击右上角“Tools → Edit this page或者每个段落后面的“Edit按钮，即可编辑此页面。
-
+TIP: This is an Admonition. You will see many of these scattered throughout the Wiki. See the <<wiki/admonitions#,Admonition Definitions>> for the meaning of this and all the other Admonitions.
 
 == 下载和安装
 
-*在安装之前，请查阅<<bsd_license#,许可证>>、<<jme3/features_zh#,jME3功能说明>>和<<jme3/requirements_zh#,开发需求>>，* 然后选择其中一个选项：
+*在安装之前，请查阅<<bsd_license#,许可证>>、<<jme3/features#,jME3功能说明>>和<<install/requirements#,开发需求>>，* 然后选择其中一个选项：
 [cols="4", options="header"]
 |===
 
@@ -40,11 +38,19 @@ a| Latest stable binary build, sources, javadoc.
 a| Sources
 
 a| 更多学习内容…
-a| <<sdk_zh#,学习使用SDK>> +<<sdk/project_creation#,使用SDK创建工程>> +
-image::sdk/jme3-jmonkeyplatform.png[jme3-jmonkeyplatform.png,width="144",height="90",align="center"]
-
-a| <<jme3/maven_zh#,在任何兼容maven的IDE中集成JME3>> * +<<jme3/setting_up_netbeans_and_jme3_zh#,在NetBeans中集成JME3>> * +<<jme3/setting_up_jme3_in_eclipse#,在Eclipse中集成JME3>> * +<<jme3/eclipse_jme3_android_jnindk_zh#,在Eclipse(含Android及JNI/NDK)中集成JME3>> *
-a| <<jme3/build_from_sources_zh#,编译JME3源码>> +<<jme3/build_jme3_sources_with_netbeans#,在NetBeans中编译JME3源码>> +<<jme3/simpleapplication_from_the_commandline#,在(Linux)命令行下开发JME3>>
+a| * <<sdk/index#,学习使用SDK>> +
+* <<sdk/create_project#,使用SDK创建工程>> +
+
+a| 在下列环境中集成JME3： +
+* <<getting-start/gradle#,Gradle>> +
+* <<getting-start/maven#,Maven>> +
+* <<getting-start/netbeans#,NetBeans>> +
+* <<getting-start/eclipse#, Eclipse>> +
+* <<getting-start/android_studio#,Android Studio>> +
+* <<getting-start/intellij_idea#,Intellij IDEA>>
+a| * <<install/build_from_sources#,编译JME3源码>> +
+* <<jme3/build_jme3_sources_with_netbeans#,在NetBeans中编译JME3源码>> +
+* <<jme3/simpleapplication_from_the_commandline#,在(Linux)命令行下开发JME3>>
 
 |===
 
@@ -53,7 +59,7 @@ a| <<jme3/build_from_sources_zh#,编译JME3源码>> +<<jme3/build_jme3_sources_w
 
 == 创建jME工程
 
-下载安装jME之后，请把这个<<jme3_zh#,jME教程>>加入您的书签，然后动手开发您的第一个游戏吧！
+下载安装jME之后，请把这个<<jme3,jME教程>>加入您的书签，然后动手开发您的第一个游戏吧！
 [cols="3", options="header"]
 |===
 
@@ -61,15 +67,15 @@ a| 教程
 a| jMonkeyEngine SDK
 a| 其他文档
 
-a| <<jme3_zh#初级教程,jME3初级教程>>
-a| <<sdk_zh#,jMonkeyEngine SDK 文档和视频教程>>
+a| <<jme3/beginners/index#,jME3初级教程>>
+a| <<sdk/index#,jMonkeyEngine SDK 文档和视频教程>>
 a| link:http://javadoc.jmonkeyengine.org/[Full API JavaDoc]
 
-a| <<jme3_zh#中级教程,jME3中级教程>>
+a| <<jme3/advanced/index#,jME3中级教程>>
 a| <<sdk/comic#,jMonkeyEngine SDK - 漫画 :-)>>
 a| <<jme3/external/blender#,Blender建模指南>>
 
-a| <<jme3#进阶教程,jME3进阶教程>>
+a| <<jme3/senior/index#,jME3进阶教程>>
 <a|
 a| <<jme3/faq#,FAQ>>
 
@@ -81,32 +87,25 @@ a| <<jme3/faq#,FAQ>>
 想给jME3贡献新的特性和功能吗？如果你是一名熟练的Java开发者，请看下列页面：
 
 *  了解已有的<<jme3/contributions#,贡献>>
-*  link:http://hub.jmonkeyengine.org/introduction/contributors-handbook/[阅读贡献者手册]
-*  link:http://hub.jmonkeyengine.org/[加入官方论坛的讨论]
-*  <<jme3/jme3_source_structure_zh#,学习jME3源码架构>>
-*  <<sdk_zh#development,开发jME SDK插件以及可视化编辑器>>
-*  <<report_bugs_zh#,报告bug &amp; 提交补丁>>
-
+*  link:https://github.com/jMonkeyEngine/jmonkeyengine/blob/master/CONTRIBUTING.md[阅读贡献者手册]
+*  link:https://github.com/jMonkeyEngine/wiki[称为维基编辑者]
+*  link:http://hub.jmonkeyengine.org/c/contribution-depot-jme3[加入官方社区的讨论]
+*  <<jme3/jme3_source_structure#,学习jME3源码架构>>
+*  <<sdk#development,开发jME SDK插件以及可视化编辑器>>
+*  <<report_bugs#,报告bug &amp; 提交补丁>>
 
 == 联系我们
 
-欢迎您的贡献和咨询：请通过mailto:&#x63;&#x6f;&#x6e;&#x74;&#x61;&#x63;&#x74;&#x40;&#x6a;&#x6d;&#x6f;&#x6e;&#x6b;&#x65;&#x79;&#x65;&#x6e;&#x67;&#x69;&#x6e;&#x65;&#x2e;&#x63;&#x6f;&#x6d;[电子邮箱]联系link:http://jmonkeyengine.org/team/[开发团队]，或者在 link:http://hub.jmonkeyengine.org/[官方论坛]发帖提问。
+欢迎您的贡献和咨询：请联系 link:https://hub.jmonkeyengine.org/badges/103/core-developer[开发者]，或者在 link:http://hub.jmonkeyengine.org/[官方论坛]发帖提问。
 
-*  mailto:&#x63;&#x6f;&#x6e;&#x74;&#x61;&#x63;&#x74;&#x40;&#x6a;&#x6d;&#x6f;&#x6e;&#x6b;&#x65;&#x79;&#x65;&#x6e;&#x67;&#x69;&#x6e;&#x65;&#x2e;&#x63;&#x6f;&#x6d;[联系jME团队]
-**  link:http://jmonkeyengine.org/team/[核心团队 - 我们是谁？]
+* link:https://hub.jmonkeyengine.org/badges/103/core-developer[联系JME3开发团队]
+**  <<team#,[核心团队 - 我们是谁？]>>
 
-*  <<report_bugs#,发现bug>>
+*  <<report_bugs#,报告BUG>>
 *  link:http://hub.jmonkeyengine.org/c/documentation-jme3[发现文档内容含糊或文档不存在]
 
-
-== 本页的多国语言版
-
-<<documentation#,英文原版>> +
-<<документация#,俄语版>> +
-<<documentacao#,葡萄牙语>> +
-<<documentation_zh#,中文版>>
-
-
 == 中文开发者讨论群
 
 本群不是jME的官方QQ群，而是由一群国内的jME爱好者聚集的讨论群，欢迎加入讨论，群号：423979787。
+
+中文网站： http://www.jmecn.net/

src/docs/asciidoc/zh-Hans-CN/install/overview.adoc → src/docs/asciidoc/zh-Hans-CN/getting-start/netbeans.adoc

@@ -1,4 +1,4 @@
-= OVERVIEW
+= NetBeans
 :author: yanmaoyuan
 :revnumber:
 :revdate: 2018/01/15 16:29

src/docs/asciidoc/zh-Hans-CN/install/source_code.adoc → src/docs/asciidoc/zh-Hans-CN/install/build_from_sources.adoc

@@ -1,4 +1,4 @@
-= SOURCE CODE
+= 编译jMonkeyEngine3源代码
 :author: yanmaoyuan
 :revnumber:
 :revdate: 2018/01/15 16:29

src/docs/asciidoc/zh-Hans-CN/install/index.adoc

@@ -0,0 +1,50 @@
+= 安装 jMonkeyEngine3
+:author: yanmaoyuan
+:revnumber: 1.0
+:revdate: 2018/01/15 16:29
+:keywords:
+ifdef::env-github,env-browser[:outfilesuffix: .adoc]
+
+jMonkeyEngine3(简称jME3) 是一款纯Java开发的开源3D游戏引擎。它的核心是一套模块化的Java类库，同时还为提供了名为 `jMonkenEngine3 SDK` 的集成开发环境。
+
+本文将介绍如何下载、安装 jMonkeyEngine3。
+
+== 开发需求
+
+jME3 是一个3D游戏引擎，这意味着开发者和用户都需要性能足够好的CPU和GPU。
+
+详细： link:requirements.html[jMonkeyEngine开发需求]
+
+== jMonkeyEngine3
+
+jME3 本质上是一个第三方Java类库，它的本体是一套 jar 文件。只需要在Java/Android项目中引用这些 jar文件，就可以开发3D游戏。jME3 基于模块法开发，用户可以根据需要来使用这些 jar 文件的一个子集。也就是说，你不需要全部的 jar 文件，就可以用 jME3 来开发3D程序。
+
+jME3 下载地址： https://github.com/jMonkeyEngine/jmonkeyengine/releases
+
+更多内容，请查阅：link:engine.html[jME3 简介]
+
+== jMonkeyEngine3 SDK
+
+jMonkeyEngine3 SDK(简称SDK) 是基于 NetBeans 平台开发的 jME3 集成开发环境(IDE)。SDK 包含地形制作、预览3D模型、材质编辑器、粒子编辑器等诸多可视化开发功能。
+
+SDK 下载地址： https://github.com/jMonkeyEngine/sdk/releases
+
+更多内容，请查阅： link:sdk.html[SDK 简介]
+
+== 源代码
+
+jMonkeyEngine3 的源代码托管于 github.com，你可以通过下面的链接找到它的全部源代码。
+
+https://github.com/jMonkeyEngine/jmonkeyengine
+
+jMonkeyEngine3 还有大量用户贡献源代码，可以通过下面的连接找到他们。
+
+https://github.com/jMonkeyEngine-Contributions/
+
+更多内容，请查阅： link:source_code.html[jME3 源代码]
+
+== 许可证
+
+jMonkeyEngine3 遵循 BSD 许可证，这意味着你几乎可以用它做任何事情，包括开发商业游戏。
+
+许可证： link:../../bsd_license.html[BSD_LICENSE]

src/docs/asciidoc/zh-Hans-CN/install/requirements.adoc

@@ -1,9 +1,8 @@
 = jMonkeyEngine3 开发需求
 :author: yanmaoyuan
-:revnumber:
+:revnumber: 1.0
 :revdate: 2018/01/15 16:29
-:relfileprefix: ../../
-:imagesdir: ../../
+:relfileprefix: ../
 ifdef::env-github,env-browser[:outfilesuffix: .adoc]
 
 本文分别从游戏开发者和用户的2种视角，分别介绍使用jMonkeyEngine3所需的软硬件需求。
@@ -27,11 +26,13 @@ a|显卡
 a|AMD/ATI Radeon 9500, NVIDIA GeForce 5 FX, Intel GMA 4500, 或者更高性能的显卡 +最好支持OpenGL 2.0(你下载jMonkeyEngine SDK中包含本地运行库)
 
 a|JDK
-a|JDK 6 或更高 +你的开发团队可以从 link:http://www.java.com[http://www.java.com] 免费下载JDK； 对于 Mac +++<abbr title="Operating System">OS</abbr>+++ 开发者, 请访问link:http://support.apple.com/kb/DL1421[apple.com]. +使用jMonkeyEngine SDK开发游戏，要求至少具备Java中级开发水准。 
+a|JDK 7 或更高 +
+你的开发团队可以从 link:http://www.java.com[http://www.java.com] 免费下载JDK； 对于 Mac +++<abbr title="Operating System">OS</abbr>+++ 开发者, 请访问link:http://support.apple.com/kb/DL1421[apple.com]. +
+使用jMonkeyEngine SDK开发游戏，要求至少具备Java中级开发水准。 
 
 |===
 
-我们推荐开发者使用<<sdk#,jMonkeyEngine SDK>>作为游戏开发IDE。但是你也可以选择自己熟悉的第三方IDE来集成jMonkeyEngine框架进行开发，甚至可以使用记事本写代码然后在命令行下编译。对于第三方IDE的软硬件需求，请查看对应IDE的文档。
+我们推荐开发者使用<<sdk/index#,jMonkeyEngine SDK>>作为游戏开发IDE。但是你也可以选择自己熟悉的第三方IDE来集成jMonkeyEngine框架进行开发，甚至可以使用记事本写代码然后在命令行下编译。对于第三方IDE的软硬件需求，请查看对应IDE的文档。
 
 
 == 用户
@@ -56,7 +57,9 @@ a|link:http://jmonkeyengine.org/groups/android/forum/topic/does-my-phone-meet-th
 a|(玩手游需要) Android 2.2 +++<abbr title="Operating System">OS</abbr>+++, 支持OpenGL 2的显卡
 
 a|Java 运行环境
-a|Java 5 及以上 +你需要JVM来运行jME游戏. +JVM通常需要提前安装。如果你的用户没有安装的话，可以通过 link:http://www.java.com[http://www.java.com] 免费下载； Mac +++<abbr title="Operating System">OS</abbr>+++ 用户请访问link:http://support.apple.com/kb/DL1421[apple.com]. 
+a|Java 5 及以上 +
+你需要JVM来运行jME游戏. +
+JVM通常需要提前安装。如果你的用户没有安装的话，可以通过 link:http://www.java.com[http://www.java.com] 免费下载； Mac +++<abbr title="Operating System">OS</abbr>+++ 用户请访问link:http://support.apple.com/kb/DL1421[apple.com]. 
 
 |===
 

src/docs/asciidoc/zh-Hans-CN/jme3/beginners/index.adoc

@@ -0,0 +1,37 @@
+= 初级教程
+:author: yanmaoyuan
+:revnumber: 1.0
+:revdate: 2018/01/15 16:29
+:experimental:
+:keywords:
+ifdef::env-github,env-browser[:outfilesuffix: .adoc]
+
+
+初级教程将介绍一些常见的游戏开发实例，并解释一些基本概念。在正式学习前，请确认自己是否了解<<jme3/terminology#,3D游戏开发的一些基本概念>>，例如<<jme3/the_scene_graph#,场景图>>。如果你不太了解的话，建议先学习“<<jme3/math_for_dummies#,3D数学基础知识>>”以及“<<jme3/scenegraph_for_dummies#,3D场景图的基本概念>>”。
+
+link:https://github.com/jMonkeyEngine/jmonkeyengine/tree/master/jme3-examples/src/main/java/jme3test[所有示例代码]均已包含在jMonkeyEngine SDK中（yan：通过github搜索jMonkeyEngine也能找到源码），你只需要在创建工程时选择`JmeTests`模板，即可查阅这些代码。如果你要自己开发游戏的话，建议在创建工程时选择`BasicGame`模板。
+
+建议读者在学习的过程中把所有的示例代码都编写运行一遍，并且尝试着去修改这些代码，有助于加深对本教程的理解。
+
+
+[IMPORTANT]
+====
+ * 使用<<sdk#,jMonkeyEngine SDK>>开发项目时，按F1键可以搜索并浏览本wiki的一份副本，帮助文档的内容与你所使用的SDK版本同步。本wiki随link:https://github.com/jMonkeyEngine/jmonkeyengine[jME3最新版本]同步更新。* 
+====
+
+image::jme3/beginner/beginner-physics.png[beginner-physics.png,with="360",height="291",align="right"]
+
+.  <<jme3/beginner/hello_simpleapplication#,第一个JME3程序>> – 实现一个简单的程序
+.  <<jme3/beginner/hello_node#,节点(Node)>> – 在场景图中改变几何体和节点属性
+.  <<jme3/beginner/hello_asset#,资源(Assets)>> – 加载三维模型、场景和其他的资源
+.  <<jme3/beginner/hello_loop#,事件循环(Loop)>> – 在事件循环中实现事件控制功能
+.  <<jme3/beginner/hello_input#,输入(Input)>> – 对于键盘和鼠标的输入作出响应
+.  <<jme3/beginner/hello_material#,材质(Material)>> – 设置材质、纹理、透明度
+.  <<jme3/beginner/hello_animation#,动画(Animation)>> – 控制动画模型
+.  <<jme3/beginner/hello_picking#,拣选(Picking)>> – 射击、压下按钮、选择、捡起选项
+.  <<jme3/beginner/hello_collision#,碰撞(Collision)>> – 建造墙壁和固体地板
+.  <<jme3/beginner/hello_terrain#,地形(Terrain)>> – 使用贴图创建小山的风景
+.  <<jme3/beginner/hello_audio#,音效(Audio)>> – 按照位置和事件来实现三维音效
+.  <<jme3/beginner/hello_effects#,特效(Effects)>> – 创建粒子特效，比如：火焰、爆炸、魔法
+.  <<jme3/beginner/hello_physics#,物理(Physics)>> – 撞球和坠落的砖头
+.  <<jme3/beginner/hello_vector#,向量(Vector)>> – 可视化向量与向量操作

src/docs/asciidoc/zh-Hans-CN/jme3/beginners/overview.adoc → src/docs/asciidoc/zh-Hans-CN/sdk/index.adoc

@@ -1,6 +1,6 @@
-= OVERVIEW
+= jMonkeyEngine3 SDK
 :author: yanmaoyuan
-:revnumber:
+:revnumber: 1.0
 :revdate: 2018/01/15 16:29
 :experimental:
 :keywords:

src/docs/asciidoc/zh-Hans-CN/sdk/overview.adoc

@@ -1,7 +0,0 @@
-= OVERVIEW
-:author: yanmaoyuan
-:revnumber:
-:revdate: 2018/01/15 16:29
-:experimental:
-:keywords:
-ifdef::env-github,env-browser[:outfilesuffix: .adoc]