From 8e67775b4d4e63d40076295126b61c79421dde78 Mon Sep 17 00:00:00 2001
From: linchen1987 <linchen.1987@foxmail.com>
Date: Fri, 11 Nov 2022 14:17:48 +0800
Subject: [PATCH 1/2] doc: polish blocklet cli doc

---
 CHANGELOG.md                                  |   4 +
 developer/docs/blocklet.yml                   |   2 +-
 .../pages/reference/blocklet-cli/index.md     |  61 +++++---
 .../pages/reference/blocklet-cli/index.zh.md  | 135 ++++++++++--------
 developer/pages/blocklet.yml                  |   2 +-
 version                                       |   2 +-
 website/docs/blocklet.yml                     |   2 +-
 website/pages/blocklet.yml                    |   2 +-
 8 files changed, 122 insertions(+), 88 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 51a2259..0b35825 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,3 +1,7 @@
+## 0.1.100 (November 11, 2022)
+
+- docs: polish blocklet cli
+
 ## 0.1.99 (November 07, 2022)
 
 - feat: added FAQ for storage chapter
diff --git a/developer/docs/blocklet.yml b/developer/docs/blocklet.yml
index aca5801..75c6414 100644
--- a/developer/docs/blocklet.yml
+++ b/developer/docs/blocklet.yml
@@ -14,7 +14,7 @@ repository:
   type: git
   url: git+https://github.com/blocklet/blocklet-site.git
 specVersion: 1.2.7
-version: 0.1.99
+version: 0.1.100
 logo: logo.png
 files:
   - hooks/post-start.js
diff --git a/developer/docs/pages/reference/blocklet-cli/index.md b/developer/docs/pages/reference/blocklet-cli/index.md
index 81d6534..f08ef49 100644
--- a/developer/docs/pages/reference/blocklet-cli/index.md
+++ b/developer/docs/pages/reference/blocklet-cli/index.md
@@ -7,7 +7,7 @@ layout: documentation
 Blocklet CLI provides `blocklet` command-line tool for controlling and administering Blocklets. Use the following syntax to run `blocklet` commands from your terminal:
 
 ```bash
-blocklet [options] [command]
+$ blocklet [options] [command]
 ```
 
 You can use the `-h` or `--help` to determine the full list of supported commands.
@@ -36,19 +36,34 @@ $ blocklet create
 Develop blocklet from current directory
 
 ```bash
-blocklet dev
+$ blocklet dev
+
+ℹ Try to dev blocklet from xxxxxxxx
+
+ℹ Node DID from config xxxxxx
+ℹ Node config from xxxxxx
+✔ Installing blocklet-developer-docs@0.1.0... Done in 0.31s
+✔ Blocklet blocklet-developer-docs@0.1.0 was successfully installed
+
+...
+
+✔ Blocklet blocklet-developer-docs@0.1.0 was successfully started
+
+ℹ You can access with the following URL
+
+- http://xxxxxx-xxxxxxxxxxxxxxxxxxxx.did.abtnet.io
 ```
 
 Open the browser after blocklet had been started
 
 ```bash
-blocklet dev --open
+$ blocklet dev --open
 ```
 
 Develop blocklet as a component
 
 ```bash
-blocklet dev --app-id <blocklet-app-id> --mount-point /xxx
+$ blocklet dev --app-id <blocklet-app-id> --mount-point /xxx
 ```
 
 - `blocklet-app-id` can be viewed in the blocklet details page
@@ -59,7 +74,7 @@ blocklet dev --app-id <blocklet-app-id> --mount-point /xxx
 Execute script in blocklet running context
 
 ```bash
-blocklet exec <script>
+$ blocklet exec <script>
 ```
 
 ## Meta
@@ -77,7 +92,7 @@ $ blocklet meta
 Add component to blocklet.yml
 
 ```bash
-Usage: blocklet add <name> --store <store> --title <title> --mount-point <mount-point>
+$ blocklet add <name> --store <store> --title <title> --mount-point <mount-point>
 ```
 
 - `name`: the id of the component in the store
@@ -92,7 +107,7 @@ You can see the command to add a component in the component details page of any
 Remove component from blocklet.yml
 
 ```bash
-blocklet remove <name>
+$ blocklet remove <name>
 ```
 
 ## Config Blocklet CLI
@@ -102,22 +117,22 @@ blocklet remove <name>
 Manage the configuration for Blocklet CLI
 
 ```bash
-blocklet config set [key] [value]    # Set config value
-blocklet config get [key]            # Get config value
-blocklet config delete [key]         # Delete config value
-blocklet config list              # List config value
+$ blocklet config set [key] [value]    # Set config value
+$ blocklet config get [key]            # Get config value
+$ blocklet config delete [key]         # Delete config value
+$ blocklet config list              # List config value
 ```
 
 你可为配置项设置不同的 profile
 
 ```bash
-blocklet config set key value # set key in default profile
-blocklet config set key value1  --profile profile1 # set key in profile1
-blocklet config set key value2  --profile profile2 # set key in profile2
+$ blocklet config set key value # set key in default profile
+$ blocklet config set key value1  --profile profile1 # set key in profile1
+$ blocklet config set key value2  --profile profile2 # set key in profile2
 
-blocklet config get key # get key in default prifle
-blocklet config get key --profile profile1 # get key in default prifle1
-blocklet config get key --profile profile2 # get key in default prifle2
+$ blocklet config get key # get key in default prifle
+$ blocklet config get key --profile profile1 # get key in default prifle1
+$ blocklet config get key --profile profile2 # get key in default prifle2
 ```
 
 ### Connect
@@ -125,13 +140,13 @@ blocklet config get key --profile profile2 # get key in default prifle2
 Connect to blocklet store. This command will set store configuration by `blocklet config`
 
 ```bash
-blocklet connect <store-url>
+$ blocklet connect <store-url>
 ```
 
 Set store configuration to specific profile
 
 ```bash
-blocklet connect <store-url> --profile <profile>
+$ blocklet connect <store-url> --profile <profile>
 ```
 
 After executing the command, the component information will be removed from `blocklet.yml`.
@@ -149,7 +164,7 @@ $ blocklet version  1.1.0
 
 ### Bundle
 
-Packages the Blocklet.
+Packages the Blocklet. See the detail in [Blocklet Bundle](/how-to/bundle)
 
 ```bash
 $ blocklet bundle
@@ -196,12 +211,12 @@ Components are not automatically added to the navigation when they are deployed
 $ blocklet deploy <blocklet-bundle-folder> --app-id xxx --navigation
 ```
 
-### Upload
+### Upload to Store
 
-Upload the blocklet release to store, see the detail in [publish blocklet](../publish)
+Upload the blocklet release to store. See the detail in [Publish Blocklet](../publish)
 
 ```bash
-blocklet upload [options] [metafile]
+$ blocklet upload [options] [metafile]
 ```
 
 ## Help
diff --git a/developer/docs/pages/reference/blocklet-cli/index.zh.md b/developer/docs/pages/reference/blocklet-cli/index.zh.md
index d1e4f24..bf8b827 100644
--- a/developer/docs/pages/reference/blocklet-cli/index.zh.md
+++ b/developer/docs/pages/reference/blocklet-cli/index.zh.md
@@ -4,138 +4,153 @@ description: Blocklet CLI
 layout: documentation
 ---
 
-Blocklet CLI provides `blocklet` command-line tool for controlling and administering Blocklets. Use the following syntax to run `blocklet` commands from your terminal:
+Blocklet CLI 提供了用于控制和管理 Blocklet 的 `blocklet` 命令行工具。 使用以下语法从终端运行 `blocklet` 命令：
 
 ```bash
-blocklet [options] [command]
+$ blocklet [options] [command]
 ```
 
-You can use the `-h` or `--help` to determine the full list of supported commands.
+您可以使用 `-h` 或 `--help` 来确定支持的命令的完整列表。
 
-## Version
+## 版本
 
-Shows the current Blocklet CLI version.
+显示当前的 Blocklet CLI 版本。
 
 ```bash
 $ blocklet -V
 1.4.4
 ```
 
-## Create Blocklet Project
+## 创建 Blocklet 项目
 
-Bootstraps an Blocklet project. The command use [create-blocklet](https://www.createblocklet.dev/docs) to generate a project.
+创建一个 Blocklet 项目。 该命令使用 [create-blocklet](https://www.createblocklet.dev/docs) 生成项目。详见 [Create Blocklet](https://www.createblocklet.dev/docs)
 
 ```bash
 $ blocklet create
 ```
 
-## Development a blocklet
+## 开发 blocklet
 
-### Develop
+### 开发
 
-Develop blocklet from current directory
+从当前目录开发 Blocklet
 
 ```bash
-blocklet dev
+$ blocklet dev
+
+ℹ Try to dev blocklet from xxxxxxxx
+
+ℹ Node DID from config xxxxxx
+ℹ Node config from xxxxxx
+✔ Installing blocklet-developer-docs@0.1.0... Done in 0.31s
+✔ Blocklet blocklet-developer-docs@0.1.0 was successfully installed
+
+...
+
+✔ Blocklet blocklet-developer-docs@0.1.0 was successfully started
+
+ℹ You can access with the following URL
+
+- http://xxxxxx-xxxxxxxxxxxxxxxxxxxx.did.abtnet.io
 ```
 
-Open the browser after blocklet had been started
+在 Blocklet 启动后打开浏览器
 
 ```bash
-blocklet dev --open
+$ blocklet dev --open
 ```
 
-Develop blocklet as a component
+开发 Blocklet 组件
 
 ```bash
-blocklet dev --app-id <blocklet-app-id> --mount-point /xxx
+$ blocklet dev --app-id <blocklet-app-id> --mount-point /xxx
 ```
 
-- `blocklet-app-id` can be viewed in the blocklet details page
-- `mount-point` the mount point of the component
+- `blocklet-app-id` 可以在 blocklet 详情页面查看
+- `mount-point` 组件的挂载点
 
-### Exec script
+### 执行脚本
 
-Execute script in blocklet running context
+在 blocklet 运行上下文中执行脚本
 
 ```bash
-blocklet exec <script>
+$ blocklet exec <script>
 ```
 
-## Meta
+## 元信息
 
-This is an informational command which prints meta information for a Blocklet.
+这是一个信息命令，用于打印 Blocklet 的元信息。
 
 ```bash
 $ blocklet meta
 ```
 
-## Manage components in blocklet.yml
+## 管理 blocklet.yml 中的组件
 
-### Add
+### 添加
 
-Add component to blocklet.yml
+将组件添加到 blocklet.yml
 
 ```bash
-Usage: blocklet add <name> --store <store> --title <title> --mount-point <mount-point>
+$ blocklet add <name> --store <store> --title <title> --mount-point <mount-point>
 ```
 
-- `name`: the id of the component in the store
-- `--store`: which store the component is in
-- `--title`: you can customize different names for components
-- `--mount-point`: the mount point of the component. If you fill in '/my-prefix', then all requests prefixed with it will be forwarded to the configured component
+- `name`：商店中组件的 id
+- `--store`：组件在哪个商店
+- `--title`：可以为组件自定义不同的名称
+- `--mount-point`：组件的挂载点。 如果填写'/my-prefix'，那么所有以它为前缀的请求都会被转发到配置的组件
 
-You can see the command to add a component in the component details page of any store. For example, if you want to add DID Comments, you can go to its [details page](https://store.blocklet.dev/blocklets/z8ia1WEiBZ7hxURf6LwH21Wpg99vophFwSJdu) Find the command `blocklet add did-comments --store=https://store.blocklet.dev`
+您可以在任何商店的组件详细信息页面中看到添加组件的命令。 比如要添加 DID Comments，可以到它的 [详情页](https://store.blocklet.dev/blocklets/z8ia1WEiBZ7hxURf6LwH21Wpg99vophFwSJdu) 找到命令 `blocklet add did-comments --store=https://store.blocklet.dev`
 
-### Remove
+### 删除
 
-Remove component from blocklet.yml
+从 blocklet.yml 中移除组件
 
 ```bash
-blocklet remove <name>
+$ blocklet remove <name>
 ```
 
-## Config Blocklet CLI
+执行命令后，组件信息将从 `blocklet.yml` 中删除。
 
-### Config
+## 配置 Blocklet CLI
 
-Manage the configuration for Blocklet CLI
+### 配置
+
+管理 Blocklet CLI 的配置
 
 ```bash
-blocklet config set [key] [value]    # Set config value
-blocklet config get [key]            # Get config value
-blocklet config delete [key]         # Delete config value
-blocklet config list              # List config value
+$ blocklet config set [key] [value]    # Set config value
+$ blocklet config get [key]            # Get config value
+$ blocklet config delete [key]         # Delete config value
+$ blocklet config list              # List config value
 ```
 
 你可为配置项设置不同的 profile
 
 ```bash
-blocklet config set key value # set key in default profile
-blocklet config set key value1  --profile profile1 # set key in profile1
-blocklet config set key value2  --profile profile2 # set key in profile2
+$ blocklet config set key value # set key in default profile
+$ blocklet config set key value1  --profile profile1 # set key in profile1
+$ blocklet config set key value2  --profile profile2 # set key in profile2
 
-blocklet config get key # get key in default prifle
-blocklet config get key --profile profile1 # get key in default prifle1
-blocklet config get key --profile profile2 # get key in default prifle2
+$ blocklet config get key # get key in default prifle
+$ blocklet config get key --profile profile1 # get key in default prifle1
+$ blocklet config get key --profile profile2 # get key in default prifle2
 ```
 
-### Connect
+### 连接
 
-Connect to blocklet store. This command will set store configuration by `blocklet config`
+连接到 Blocklet 商店。 此命令将通过 `blocklet config` 设置存储配置
 
 ```bash
-blocklet connect <store-url>
+$ blocklet connect <store-url>
 ```
 
-Set store configuration to specific profile
+在指定的 profile 中设置商店
 
 ```bash
-blocklet connect <store-url> --profile <profile>
+$ blocklet connect <store-url> --profile <profile>
 ```
 
-After executing the command, the component information will be removed from `blocklet.yml`.
-
 ## Build and Publish your blocklet
 
 ### Update Version
@@ -149,7 +164,7 @@ $ blocklet version  1.1.0
 
 ### Bundle
 
-Packages the Blocklet.
+将 Blocklet 打包。详见 [Blocklet Bundle](/how-to/bundle)
 
 ```bash
 $ blocklet bundle
@@ -196,17 +211,17 @@ $ blocklet deploy <blocklet-bundle-folder> --endpoint xxxxxx --access-key xxxxxx
 $ blocklet deploy <blocklet-bundle-folder> --app-id xxx --navigation
 ```
 
-### Upload
+### 上传到商店
 
-Upload the blocklet release to store, see the detail in [publish blocklet](../publish)
+上传 Blocklet 到商店，详见 [Publish Blocklet](../publish)
 
 ```bash
-blocklet upload [options] [metafile]
+$ blocklet upload [options] [metafile]
 ```
 
-## Help
+## 帮助
 
-The help command is useful to determine information for a particular command. Optionally you can also pass the `-h` option to the sub-command for the same purpose.
+help 命令用于获取指定命令的帮助信息。 您也可以将 `-h` 选项传递给子命令以获得帮助信息。
 
 ```bash
 $ blocklet help meta
diff --git a/developer/pages/blocklet.yml b/developer/pages/blocklet.yml
index f419be3..2562f2a 100644
--- a/developer/pages/blocklet.yml
+++ b/developer/pages/blocklet.yml
@@ -13,7 +13,7 @@ repository:
   type: git
   url: git+https://github.com/blocklet/blocklet-site.git
 specVersion: 1.2.7
-version: 0.1.99
+version: 0.1.100
 logo: logo.png
 files: []
 interfaces:
diff --git a/version b/version
index 5c5330a..71fb8a1 100644
--- a/version
+++ b/version
@@ -1 +1 @@
-0.1.99
+0.1.100
diff --git a/website/docs/blocklet.yml b/website/docs/blocklet.yml
index 0a9ac82..7f05210 100644
--- a/website/docs/blocklet.yml
+++ b/website/docs/blocklet.yml
@@ -14,7 +14,7 @@ repository:
   type: git
   url: git+https://github.com/blocklet/blocklet-site.git
 specVersion: 1.2.7
-version: 0.1.99
+version: 0.1.100
 logo: logo.png
 files: []
 interfaces:
diff --git a/website/pages/blocklet.yml b/website/pages/blocklet.yml
index 03ecd6b..66909ba 100644
--- a/website/pages/blocklet.yml
+++ b/website/pages/blocklet.yml
@@ -13,7 +13,7 @@ repository:
   type: git
   url: git+https://github.com/blocklet/blocklet-site.git
 specVersion: 1.2.7
-version: 0.1.99
+version: 0.1.100
 logo: logo.png
 files: []
 interfaces:

From 625816e4fd7537285e6ef41791f2632fdfd87fdd Mon Sep 17 00:00:00 2001
From: linchen1987 <linchen.1987@foxmail.com>
Date: Mon, 14 Nov 2022 08:07:23 +0800
Subject: [PATCH 2/2] bump version

---
 CHANGELOG.md                 | 4 ++++
 developer/docs/blocklet.yml  | 2 +-
 developer/pages/blocklet.yml | 2 +-
 version                      | 2 +-
 website/docs/blocklet.yml    | 2 +-
 website/pages/blocklet.yml   | 2 +-
 6 files changed, 9 insertions(+), 5 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 049536c..b4a61db 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,3 +1,7 @@
+## 0.1.101 (November 14, 2022)
+
+- docs: polish blocklet cli
+
 ## 0.1.100 (November 10, 2022)
 
 - docs: Part send notification document content, add code and screenshots
diff --git a/developer/docs/blocklet.yml b/developer/docs/blocklet.yml
index 75c6414..3125ca1 100644
--- a/developer/docs/blocklet.yml
+++ b/developer/docs/blocklet.yml
@@ -14,7 +14,7 @@ repository:
   type: git
   url: git+https://github.com/blocklet/blocklet-site.git
 specVersion: 1.2.7
-version: 0.1.100
+version: 0.1.101
 logo: logo.png
 files:
   - hooks/post-start.js
diff --git a/developer/pages/blocklet.yml b/developer/pages/blocklet.yml
index 2562f2a..6d9eff7 100644
--- a/developer/pages/blocklet.yml
+++ b/developer/pages/blocklet.yml
@@ -13,7 +13,7 @@ repository:
   type: git
   url: git+https://github.com/blocklet/blocklet-site.git
 specVersion: 1.2.7
-version: 0.1.100
+version: 0.1.101
 logo: logo.png
 files: []
 interfaces:
diff --git a/version b/version
index 71fb8a1..3234805 100644
--- a/version
+++ b/version
@@ -1 +1 @@
-0.1.100
+0.1.101
diff --git a/website/docs/blocklet.yml b/website/docs/blocklet.yml
index 7f05210..f140f73 100644
--- a/website/docs/blocklet.yml
+++ b/website/docs/blocklet.yml
@@ -14,7 +14,7 @@ repository:
   type: git
   url: git+https://github.com/blocklet/blocklet-site.git
 specVersion: 1.2.7
-version: 0.1.100
+version: 0.1.101
 logo: logo.png
 files: []
 interfaces:
diff --git a/website/pages/blocklet.yml b/website/pages/blocklet.yml
index 66909ba..938a95e 100644
--- a/website/pages/blocklet.yml
+++ b/website/pages/blocklet.yml
@@ -13,7 +13,7 @@ repository:
   type: git
   url: git+https://github.com/blocklet/blocklet-site.git
 specVersion: 1.2.7
-version: 0.1.100
+version: 0.1.101
 logo: logo.png
 files: []
 interfaces: