continued updates for zh (#429)

* Basis Universal format

* sound & mesh

* gamepad event mapping

* admob url

* Minor edit to building blocks intro text

* update gamepad & ios

* project settings

* libffi version

* scaling

* image compression

* update gamepads

* increase memory

* caching assets

* update 2021/10/6

* update 2021/10/16
blend-modes.md

* update 2021/11/12

* allow dynamic transforms update

* Bundle update

* update faq

* bullet & bob

* script properties update

* editor-styling

* build server url

* editor templates

* spine extension update

* Fix typo in the "optimizations" word in Chinese docs

* Update to material.md - Constants buffers

* Verify Graphics Calls

* H5 parameters

* OpenJDK downloads

* cn update corresponds to [pull 259](#259)

* application security

* porting guidelines

* update for 8f1651f

* cn update for 094bf6f

* cn update for 20fdfc5 & 6263317

* cn update for 7/19/2022

* title

* profiling update

* update editor.md

* update bob.md

* update shortcuts

* update fixed update note

* Update properties.md

* Update material.md

* Updates links

* Update bob help with the latest info

* camera & renderer

* Updated android keystore info zh_cn

* bundling.md release vs debug zh_cn

* update bob.md & gui-clipping.md

* contentless bundle

* consoles update

* model animation link

* gamepad & faq

* remove a camera lib

* font shadow render mode fix

* updates about app-manifest and others

* Update script.md

* includes in shaders

* editor scripts

* material updates

* Added dynamic atlas and texture creation

* fixes for atlas and some others

* update screenshots and add explanations (CN)

* add a line about Dynamic Prototype (CN)

* remove "inline" marks in pics

* de-translate the subtitle "Running the debugger" & images fix

* bundle identifier restrictions

* node properties Enabled and Visible (CN)

* release checklist & slice-9

* Update project-settings.md (CN)

* Update camera.md (CN)

* Update project-settings.md (CN)

* culling of meshes (CN)

* Update project-settings.md (CN)

* gltf model file support (CN)

* updates about factory (CN)

* Update bob.md (CN)

* Update bob.jar help (CN)

* Update about renderer and other things

* Update PS4 development and other things

* Dynamic prototype part of the collection factory.

* sync to atlas.md

* sync to design.md

* sync to gpgs.md

* sync to hot-reload.md

* sync to linux.md

* sync to live-update.md

* sync to lua.md

* sync to networking.md

* sync to physics-shapes.md

* sync to push.md

* sync to test.md

* sync to working-offline.md

* update material.md

* update zerobrane.md

* all done

* Splitting .zip archives in live-update.md

* manual for collision events

* Updated sprite documentation to include info about multiple textures

* update editor-scripts.md & physics-events.md

* update buffer.md & physics-shapes.md

* screen blend mode

* Update camera manual for zh with new function.

* Fix texture profile documentation for 1.7.0 zh

* update material.md & render.md

* notice about physics-events

* script-properties notes & PS5

* Clarified collision messages

* Update 3rd party camera list

* Fixed links in live update manual zh

* Update lua.md

* Update html5 manual with new information about CUSTOM_PARAMETERS. zh

* Added note on Apple Privacy Manifests zh

* typo

* Add info about collection proxies for zh

* fix minor mistakes

* typo

* custom resource & physics.set_shape

* Add missing type property in the physics.set_shape for zh

* html5 param & coordinates convertion

* Update install.md for zh

* Added app manifest manual for zh

* Added more info on build variants for zh

docs/zh/manuals/app-manifest.md

@@ -0,0 +1,60 @@
+---
+title: App manifest
+brief: 本教程介绍了如何使用应用清单来去掉引擎的特性.
+---
+
+# App manifest
+
+应用清单控制为引擎加入或去掉功能特性. 推荐为引擎去掉不用的特性因为可以减小游戏包体.
+
+![](images/app_manifest/create-app-manifest.png)
+
+![](images/app_manifest/app-manifest.png)
+
+## Physics
+
+控制使用哪个物理引擎, 或者选择 None 来完全去掉物理引擎.
+
+
+## Exclude Record
+
+从引擎中去掉视频录制功能 (参见手册 [`start_record`](https://defold.com/ref/stable/sys/#start_record) 消息).
+
+
+## Exclude Profiler
+
+从引擎中去掉分析器. 分析器用来收集性能和使用计数器. 参见 [分析器教程](/manuals/profiling/).
+
+
+## Exclude Sound
+
+从引擎中去掉所有声音播放功能.
+
+
+## Exclude Input
+
+从引擎中去掉所有输入处理.
+
+
+## Exclude Live Update
+
+从引擎中去掉 [热更新功能](/manuals/live-update).
+
+
+## Exclude Basis Universal
+
+从引擎中去掉基础通用 [纹理压缩库](/manuals/texture-profiles).
+
+
+## Use Android Support Lib
+
+使用安卓支持库而不使用 Android X. [更多详情参见这里](https://defold.com/manuals/android/#using-androidx).
+
+
+## Graphics
+
+选择使用的图形后端.
+
+* OpenGL - 只包含 OpenGL.
+* Vulkan - 只包含 Vulkan.
+* OpenGL and Vulkan - 同时包含 OpenGL 和 Vulkan. Vulkan 是默认的, Vulkan 不可以时使用 OpenGL.

docs/zh/manuals/extensions-build-variants.md

@@ -3,41 +3,11 @@ title: 原生扩展 - Build variants
 brief: 本教程介绍了 Defold 能创建的各种 Build variants 以及它们如何与原生扩展和引擎交互.
 ---
 
-# 原生扩展 - Build variants
-
-## Build variants
-
-打包游戏时, 需要选择你想用的引擎类型.
-
-  * Debug
-  * Release
-  * Headless
-
-不同类型即是 `Build variants`
-
-::: sidenote
-使用 <kbd>Project ▸ Build</kbd> 时使用的是 debug 版引擎.
-:::
-
-### Debug
-
-此版本保留调试功能, 例如 profiling, logging 和 hot reload. 开发阶段使用此版本.
-
-### Release
-
-此版本移除调试功能. 准备发布到应用商店时使用此版本.
-
-### Headless
-
-此版本没有图像和声音. 也就是说它可以 CI 服务器上进行 unit/smoke 测试, 甚至可以在云端作为服务器程序使用.
+:[Build Variants](../shared/build-variants.md)
 
 ## App Manifest
 
-不但可以为引擎加入原生扩展功能, 还可以从引擎中剔除一些部分. 比如你不需要物理引擎, 就可以从应用中去除.
-
-![](images/app_manifest/create-app-manifest.png)
-
-![](images/app_manifest/app-manifest.png)
+不但可以为引擎加入原生扩展功能, 还可以从引擎中剔除一些部分. 比如你不需要物理引擎, 就可以从应用中去除. 关于如何去除引擎功能参见 [应用清单教程](/manuals/app-manifest).
 
 ### 上下文组合
 
@@ -51,73 +21,70 @@ brief: 本教程介绍了 Defold 能创建的各种 Build variants 以及它们
 
 	manifest = merge(game.appmanifest, build.yml)
 
-### 编辑
-
-目前, 这些文件可以手动编辑, 但是推荐使用 [Manifestation](https://britzl.github.io/manifestation/) 工具生成 app manifest. 最终, app manifest 文件的创建和修改功能会并入编辑器中.
-
 ### 语法
 
-这是 [Manifestation](https://britzl.github.io/manifestation/) 工具生成的一个结构 (很有可能会改变. 不要直接从这里拷贝. 而要使用最新的在线工具):
-
-	platforms:
-	    x86_64-osx:
-	        context:
-	            excludeLibs: []
-	            excludeSymbols: []
-	            libs: []
-	            linkFlags: []
-	    x86_64-linux:
-	        context:
-	            excludeLibs: []
-	            excludeSymbols: []
-	            libs: []
-	            linkFlags: []
-	    js-web:
-	        context:
-	            excludeLibs: []
-	            excludeJsLibs: []
-	            excludeSymbols: []
-	            libs: []
-	            linkFlags: []
-	    wasm-web:
-	        context:
-	            excludeLibs: []
-	            excludeJsLibs: []
-	            excludeSymbols: []
-	            libs: []
-	            linkFlags: []
-	    x86-win32:
-	        context:
-	            excludeLibs: []
-	            excludeSymbols: []
-	            libs: []
-	            linkFlags: []
-	    x86_64-win32:
-	        context:
-	            excludeLibs: []
-	            excludeSymbols: []
-	            libs: []
-	            linkFlags: []
-	    armv7-android:
-	        context:
-	            excludeLibs: []
-	            excludeJars: []
-	            excludeSymbols: []
-	            libs: []
-	            linkFlags: []
-	    armv7-ios:
-	        context:
-	            excludeLibs: []
-	            excludeSymbols: []
-	            libs: []
-	            linkFlags: []
-	    arm64-ios:
-	        context:
-	            excludeLibs: []
-	            excludeSymbols: []
-	            libs: []
-	            linkFlags: []
+这是一个参考示例:
 
+```yml
+platforms:
+    x86_64-osx:
+        context:
+            excludeLibs: []
+            excludeSymbols: []
+            libs: []
+            linkFlags: []
+    x86_64-linux:
+        context:
+            excludeLibs: []
+            excludeSymbols: []
+            libs: []
+            linkFlags: []
+    js-web:
+        context:
+            excludeLibs: []
+            excludeJsLibs: []
+            excludeSymbols: []
+            libs: []
+            linkFlags: []
+    wasm-web:
+        context:
+            excludeLibs: []
+            excludeJsLibs: []
+            excludeSymbols: []
+            libs: []
+            linkFlags: []
+    x86-win32:
+        context:
+            excludeLibs: []
+            excludeSymbols: []
+            libs: []
+            linkFlags: []
+    x86_64-win32:
+        context:
+            excludeLibs: []
+            excludeSymbols: []
+            libs: []
+            linkFlags: []
+    armv7-android:
+        context:
+            excludeLibs: []
+            excludeJars: []
+            excludeSymbols: []
+            libs: []
+            linkFlags: []
+    armv7-ios:
+        context:
+            excludeLibs: []
+            excludeSymbols: []
+            libs: []
+            linkFlags: []
+    arm64-ios:
+        context:
+            excludeLibs: []
+            excludeSymbols: []
+            libs: []
+            linkFlags: []
+```
 
 #### 白名单
 

docs/zh/manuals/project-settings.md

@@ -570,11 +570,7 @@ Google Cloud Messaging Sender Id. 此值由 Google 签发, 设置后才能开启
 ### Native extension
 
 #### _App Manifest_
-如果设置了, 则在自定义引擎编译时使用指定的 manifest. 此设置可以让你移除引擎不必要的部分来减小包体.
-
-![](images/app_manifest/create-app-manifest.png)
-
-![](images/app_manifest/app-manifest.png)
+如果设置了, 则在自定义引擎编译时使用指定的 manifest. 此设置可以让你移除引擎不必要的部分来减小包体. 关于如何去除引擎功能参见 [应用清单教程](/manuals/app-manifest).
 
 ---
 

docs/zh/shared/build-variants.md

@@ -0,0 +1,34 @@
+## Build variants
+
+打包游戏时, 需要选择你想用的引擎类型. 有三个基本类型可以选择:
+
+  * Debug
+  * Release
+  * Headless
+
+这些类型即是 `Build variants`
+
+::: sidenote
+使用 <kbd>Project ▸ Build</kbd> 时使用的是 debug 版引擎.
+:::
+
+### Debug
+
+此版本通常在游戏开发阶段使用, 因为它具有许多有用的调试功能:
+
+* 分析器 - 用于收集性能和使用计数器. 如何使用分析器参见 [分析器教程](/manuals/profiling/).
+* 日志 - 日志开启后引擎会记录系统信息, 警告和错误. 引擎也会通过 Lua `print()` 功能, 原生扩展使用 `dmLogInfo()`, `dmLogError()` 之类的功能记录日志. 如何阅读日志参见 [游戏和系统日志教程](https://defold.com/manuals/debugging-game-and-system-logs/).
+* 热重载 - 热重载是一个强大的功能, 能让开发者在游戏运行时重新载入资源. 如何使用热重载参见 [热重载教程](https://defold.com/manuals/hot-reload/).
+* 引擎服务 - 游戏的调试版本可以连结一些开启的 TCP 端口和服务并与之交互. 这些服务包括热重载功能, 远程日志存取和上述的分析器功能, 以及其他一些各种各样的服务. 关于引擎服务参见 [开发者教程](https://github.com/defold/defold/blob/dev/engine/docs/DEBUG_PORTS_AND_SERVICES.md).
+
+### Release
+
+此版本移除调试功能. 准备发布到应用商店时使用此版本. 基于以下原因不推荐发布包含调试功能的游戏:
+
+* 调试功能会使包体略微变大, [我们应该尽量使发布游戏包体最小](https://defold.com/manuals/optimization/#optimize-application-size).
+* 调试功能也会占用一点 CPU 时长. 这可能使用户的老机型卡顿. 在手机上增加 CPU 使用也会造成过热和电池消耗.
+* 调试功能可能会给用户暴露不应暴露的信息, 无论从安全, 作弊还是欺诈角度.
+
+### Headless
+
+此版本没有图像和声音. 也就是说它可以 CI 服务器上进行 unit/smoke 测试, 甚至可以在云端作为服务器程序使用.

docs/zh/shared/install.md

@@ -42,22 +42,10 @@
   $ ./Defold
   ```
 
+  在 `Help > Create Desktop Entry` 菜单项有一个安装桌面入口的帮助.
+
   如果遇到问题, 请参考 [FAQ 的 Linux 部分](/faq/faq#linux-issues).
 
 ## 安装老版本
 
-### 从 Defold GitHub 发布页下载
-
-Defold 各版本也 [发布在 GitHub 上](https://github.com/defold/defold/releases).
-
-### 从 Defold 下载页下载
-
-下载链接遵循以下模式:
-
-* Windows: https://d.defold.com/archive/%sha1%/stable/editor2/Defold-x86_64-win32.zip
-* macOS: https://d.defold.com/archive/%sha1%/stable/editor2/Defold-x86_64-macos.dmg
-* Linux: https://d.defold.com/archive/%sha1%/stable/editor2/Defold-x86_64-linux.zip
-
-把上面的 `%sha1%` 换成你需要的版本 hash. 这些 hash 可以在 https://d.defold.com/stable/ 上找到 (不要开头 # 号, 只要后面的字符):
-
-![download editor](../shared/images/old_version_sha1.png)
+Defold 的各 beta 和 stable 版本也 [在 GitHub 上](https://github.com/defold/defold/releases).