翻译 snippets.md

Author: dcloud-wandl

en/Tutorial/Language/Snippets.md

@@ -1,61 +1,62 @@
-# 代码块
+# Snippets
 
-## 概述
+## Overview
 
-代码块是快速开发的利器。简单的敲几个字母，回车，就能生成大段代码。
+Snippets are a powerful tool for rapid development. Simply type a few letters and press Enter to generate a large piece of code.
 
-比如我们经常会敲if...else结构，在HBuilderX中，只需敲`ife`回车，就能直接生成相应的代码结构。
+For example, we often type the `if...else` structure. In HBuilderX, you can directly generate the corresponding code structure by hitting `ife` and enter.
 
-敲`ife`
+input `ife`
 
 <img src="/static/snapshots/tutorial/snippets_3.png" style="zoom: 90%;" />
 
-回车后生成if结构体
+Generate if structure after carriage return.
 
 <img src="/static/snapshots/tutorial/snippets_4.png" style="zoom: 90%;" />
 
-## 常用代码块列表
+## List of commonly used code blocks
 
-**通用js代码块**
+**JavaScript Snippets**
 
-- iff ：简单if
-- forr ：for循环结构体
-- fori ：for循环结构体并包含i
-- funn：函数
-- funa：匿名函数
-- clog：打印日志
-- clogvar：打印变量命名和值
+- iff
+- forr ：for loop structure
+- fori ：for loop structure and contains i
+- funn: function
+- funa: anonymous function
+- clog: print log
+- clogvar: print variable name and value
 
-**dom代码块**
+**dom Snippets**
 
 - dg ：document.getElementById
 - dl ：$("")
 
-**vue代码块**
+**vue Snippets**
 
-敲v，即可拉出各种vue代码块
+Enter `v`, You can pull out various vue Snippets.
 
-**uni-app代码块**
+**uni-app Snippets**
 
-敲u，即可拉出各种uni-app代码块
-还有ifios、ifandroid，这2个平台判断代码块（HBuilderX 1.9.10+）
+Enter `u`, You can pull out various uniapp Snippets.
 
-## 代码块设置
+## Snippets settings
 
-HBuilderX已经内置了大量常用的代码块，熟悉这些代码块，对于提高编程效率有重要帮助。
+HBuilderX has built-in a large number of commonly used Snippets. Familiarity with these Snippets is important to improve programming efficiency.
 
-查看内建的代码块，点击菜单-工具-代码块设置，选择你要查看的语言的代码块。
+To view the built-in Snippets, click [Menu-Tools-Snippets Settings], and select the Snippets of the language you want to view.
 
-<img src="/static/snapshots/tutorial/snippets_1.png" style="zoom: 90%;" />
+<img src="/static/snapshots/tutorial/menu_tool/menu_snippets_en.png" class="hd-img" />
 
-打开的界面中，左侧即是预置的代码块，右侧是开发者可以自己扩展代码块的地方。
+In the opened interface, the left side is the preset Snippets, and the right side is the place where developers can extend the Snippets by themselves.
 
-<img src="/static/snapshots/tutorial/snippets_2.png" style="zoom: 80%;" />
+<img src="/static/snapshots/tutorial/menu_tool/snippets_custom_en.png" class="hd-img" />
 
 
-## 自定义代码块
+## Custom Snippets
 
-自定义代码块都是配置json文件中的，直接来一个js例子吧，上述`ife`代码块的配置如下：
+Custom Snippets are in the configuration json file.
+
+js Snippets example: the configuration of the above `ife` Snippets is as follows:
 
 ```json
 {
@@ -73,50 +74,50 @@ HBuilderX已经内置了大量常用的代码块，熟悉这些代码块，对
 }
 ```  
 
-### 代码块配置格式说明
+### Snippets Format description
 
-HBuilderX使用json定义代码块的格式，兼容vscode的代码块格式，也就是你可以把vscode里已经配置的自定义代码块方便的挪到HBuilderX中使用。
+HBuilderX uses json to define the format of the Snippets, which is compatible with the Snippets format of vscode, that is, you can easily move the custom Snippets that has been configured in vscode to HBuilderX for use.
 
 
-|配置项			|说明																																																																													|
-|--				|--																																																																														|
-|key			|代码块显示名称，显示在代码助手列表中的名字。key是不能重复的。上面例子中`"if ... else"`就是一个`key`。																																																					|
-|prefix			|代码块的触发字符，就是敲什么字母可以激活这个代码块。																																																																	|
-|body			|代码块的内容																																																																											|
-|triggerAssist	|为`true`表示该代码块输入到文档后立即在第一个`tabstop`上触发代码提示，拉出代码助手，默认为`false`。																																																						|
-| project		|将代码块控制在指定项目类型下生效。可取值有：`uni-app`、`Web`、`App`、`Wap2App`。<br/>`Web`指普通项目，`App`指5+App项目。如果不设置，则该代码块在所有项目类型下均生效。<br/>比如：`"project": "uni-app"`，代表这个代码块仅在uni-app项目下生效。<br/>如需设置多种项目类型，用逗号分隔。比如：`"project": "uni-app,App"`	|
+|Configuration item	|Description																																													|
+|--									|--																																																		|
+|key								|Snippets display name, the name displayed in the code assistant list. The key cannot be repeated.|
+|prefix							|Trigger character of Snippets																								|
+|body								|The content of the Snippets.																																					|
+|triggerAssist			|True means that the code prompt is triggered on the first tabtop immediately after the code block is entered into the document, and the code assistant is pulled out. The default is false.	|
+|project		|Control the code block to take effect under the specified project type. Possible values are: `uni-app`, `Web`, `App`, `Wap2App`.<br/>To set multiple item types, separate them with commas. For example: `"project": "uni-app,App"`	|
 
-**配置项body详细说明:**
+**Body description:**
 
-- `$1` 表示代码块输入后光标的所在位置。如需要多光标，就在多个地方配置`$1`；如该位置有预置数据且需要选中，则写法是`${1:selectedtext}`；这里还支持下拉候选菜单，多选项即下拉候选列表使用`${1:foo1/foo2/foo3}`
-- `$2` 表示代码块输入后再次按tab后光标的切换位置`tabstops`（代码块展开后按tab可以跳到下一个`tabstop`，在HBuilderX中看到类似绿色光标的不闪的竖线，就可以按tab或回车跳转光标过去）
-- `$0`代表代码块输入后最终光标的所在位置（也可以按回车直接跳过去）。
+- `$1` The position of the cursor after the code block is entered. If you need multiple cursors, configure `$1` in multiple places; if there are preset data at this location and need to be selected, the writing method is `${1:selectedtext}`; here also supports drop-down candidate menus, multiple options are drop-down candidates The list uses `${1:foo1/foo2/foo3}`
+- `$2` After the code block is entered, the cursor switch position after pressing tab again.
+- `$0` The final cursor position after the code block is entered.
 
-特别说明：
-1. **双引号使用`\"`转义**
-2. **换行使用多个数组表示，每个行一个数组，用`双引号`包围，并用`逗号`分隔**
-3. **缩进需要用`\t`表示，不能直接输入缩进或空格！**
+Remark：
+1. **Double quotes are escaped with `\"`**
+2. **Line breaks are represented by multiple arrays, one array per line, surrounded by `double quotes` and separated by `commas`**
+3. **The indentation needs to be indicated by `\t`, you cannot directly enter the indentation or spaces! **
 
 
-### 注意事项
+### Matters needing attention
 
-1. 每个代码块以`key`为主键，多个代码块需要`逗号`分隔。
-2. 如果json语法不合法，编辑器状态栏会弹出错误信息，json中会画出红波浪线，请注意修正。
+1. Each code block uses `key` as the main key, and multiple code blocks need to be separated by `commas`.
+2. If the json syntax is illegal, an error message will pop up in the editor status bar, and a red wavy line will be drawn in the json, please pay attention to the correction.
 
-## 注释模板同步时间
+## Comment template For Datetime
 
-> HBuilderX 2.7.5+版本起，支持主持注释模板同步时间
+> From HBuilderX 2.7.5+ version, it supports the synchronization time of host annotation template
 
-点击菜单【工具】【代码块设置】【javascript代码块】，输入如下内容：
+Click the menu [Tools - Snippets settings - javascript snippets], and enter the following:
 
 ```
 {  
     "method-annotation": {  
         "prefix": "anno",  
         "body": [  
             "/**",  
-            " * 方法说明",  
-            " * author: 佚名",  
+            " * Method description",  
+            " * author: author name",  
             " * description: ",  
             " * @param $1",  
             " * @return $2",  

en/_sidebar.md

@@ -29,7 +29,8 @@
     * [External Commands](/Tutorial/UserGuide/externalCommands.md)
 * Languages
     * [Overview](/Tutorial/Language/Overview.md)
-    * [CodeAssistant](/Tutorial/Language/CodeAssistant.md)
+    * [CodeAssistant](/Tutorial/Language/CodeAssistant.md)
+    * [Snippets](/Tutorial/Language/Snippets.md)
     * [Emmet](/Tutorial/Language/emmet)
     * [Vue](/Tutorial/Language/vue.md)
     * [Vue3](/Tutorial/Language/vue-next.md)