docs: add commands guide (#2062)

* chore(create-dumi): add preview scripts * docs: add commands doc * Update docs/config/commands.md Co-authored-by: Peach <scdzwyxst@gmail.com> * chore: update * chore: update category --------- Co-authored-by: Peach <scdzwyxst@gmail.com>
umijs · Mar 30, 2024 · 6072519 · 6072519
1 parent 59c0f02
commit 6072519
Show file tree

Hide file tree

Showing 7 changed files with 53 additions and 1 deletion.
diff --git a/docs/guide/commands.md b/docs/guide/commands.md
@@ -0,0 +1,43 @@
+---
+toc: content
+group: 其他
+order: 1
+---
+
+# 命令行
+
+## `dumi dev`
+
+启动本地开发服务器，进行项目的开发与调试。
+
+## `dumi build`
+
+构建 dumi 文档产物，适用于生产环境的部署。
+
+## `dumi preview`
+
+在本地启动一个静态 Web 服务器，将 docs-dist 文件夹运行在 http://127.0.0.1:4172, 用于预览构建后产物。
+
+你可以通过 `--port` 参数来配置服务的运行端口。
+
+```bash
+dumi preview --port 9527
+```
+
+现在 `preview` 命令会将服务器运行在 http://127.0.0.1:9527
+
+## `dumi setup`
+
+初始化项目，会做临时文件的生成等操作。通常在 package.json 的 `scripts.prepare` 里设置。
+
+```json
+{
+  "scripts": {
+    "prepare": "dumi setup"
+  }
+}
+```
+
+## `dumi version`
+
+查看 dumi 版本，等同于 `dumi -v`。
diff --git a/docs/guide/faq.md b/docs/guide/faq.md
@@ -1,6 +1,6 @@
 ---
 group: 其他
-order: 2
+order: 3
 ---
 
 # 常见问题

diff --git a/docs/guide/upgrading.md b/docs/guide/upgrading.md
@@ -2,6 +2,7 @@
 group:
   title: 其他
   order: 3
+order: 2
 ---
 
 # 从 dumi 1.x 升级

diff --git a/suites/boilerplate/templates/react/README.md.tpl b/suites/boilerplate/templates/react/README.md.tpl
@@ -31,6 +31,9 @@ $ {{ npmClient }} run build:watch
 # build docs
 $ {{ npmClient }} run docs:build
 
+# Locally preview the production build.
+$ {{ npmClient }} run docs:preview
+
 # check your project for potential problems
 $ {{ npmClient }} run doctor
 ```

diff --git a/suites/boilerplate/templates/react/package.json.tpl b/suites/boilerplate/templates/react/package.json.tpl
@@ -10,6 +10,7 @@
     "build": "father build",
     "build:watch": "father dev",
     "docs:build": "dumi build",
+    "docs:preview: "dumi preview",
     "prepare": "husky install && dumi setup",
     "doctor": "father doctor",
     "lint": "npm run lint:es && npm run lint:css",

diff --git a/suites/boilerplate/templates/site/README.md.tpl b/suites/boilerplate/templates/site/README.md.tpl
@@ -13,6 +13,9 @@ $ {{ npmClient }} start
 
 # build docs
 $ {{ npmClient }} run build
+
+# Locally preview the production build
+$ {{ npmClient }} run preview
 ```
 
 ## LICENSE

diff --git a/suites/boilerplate/templates/site/package.json.tpl b/suites/boilerplate/templates/site/package.json.tpl
@@ -6,6 +6,7 @@
     "start": "npm run dev",
     "dev": "dumi dev",
     "build": "dumi build",
+    "preview: "dumi preview",
     "prepare": "husky install && dumi setup"
   },
   "authors": [{{#author}}