diff options
Diffstat (limited to 'docs/_zh_CN/pages')
| -rw-r--r-- | docs/_zh_CN/pages/1-getting-started.md (renamed from docs/_zh_CN/pages/2-getting-started.md) | 9 | ||||
| -rw-r--r-- | docs/_zh_CN/pages/1-intro.md | 32 |
2 files changed, 8 insertions, 33 deletions
diff --git a/docs/_zh_CN/pages/2-getting-started.md b/docs/_zh_CN/pages/1-getting-started.md index 62eb94b..2961464 100644 --- a/docs/_zh_CN/pages/2-getting-started.md +++ b/docs/_zh_CN/pages/1-getting-started.md @@ -44,13 +44,20 @@ use mingling::prelude::*; fn main() { let mut program = ThisProgram::new(); - + program.exec_and_exit(); } gen_program!(); ``` +> [!IMPORTANT] +> 文档中几乎所有 Rust 代码块都已在 CI 流程中编译通过,可以保证可用性。 +> +> 但以 `// NOT VERIFIED` 开头的代码块 **未被验证**。 +> +> 想确认哪些 `*.md` 文件被编译过?请看 [`verified-docs.toml`](https://github.com/mingling-rs/mingling/blob/main/verified-docs.toml) + ## 编译验证 ```plaintext diff --git a/docs/_zh_CN/pages/1-intro.md b/docs/_zh_CN/pages/1-intro.md deleted file mode 100644 index 7210d2e..0000000 --- a/docs/_zh_CN/pages/1-intro.md +++ /dev/null @@ -1,32 +0,0 @@ -<h1 align="center">介绍</h1> - -如果你正被这些问题困扰—— - -1. 子命令一多,`main.rs` 就迅速膨胀; -2. Handler 中的逻辑与副作用混杂在一起; -3. 日志、鉴权等横切关注点难以无侵入地插入; -4. 为多个平台维护 shell 补全脚本令人心力交瘁; -5. 全局资源到处都是,测试非常困难。 - -…… 那么,你来对地方了。 - -当然,如果只是对「怎么用 Rust 写出好维护的 CLI」这件事感兴趣,那你更来对地方了 —— 它会很有意思的。 - -## 什么是 Mingling? - -> **Mìng Lìng** 是中文 **命令** 的汉语拼音, -> 对应的英文单词是 **Command**。 - -Mingling 是一个用 Rust 构建的 CLI 框架。它免费、开源,且使用宽松的 MIT / Apache 2.0 开源协议。 - -Mingling 的设计目标: - -- **可扩展**:从 3 个子命令到 30 个,同一套模式,不换框架 -- **解耦**:参数解析写一次,业务逻辑写一次,输出格式写一次。各不相干 -- **类型驱动**:整个流水线上传递的是清晰、类型化的数据,而非 `Vec<String>` -- **轻量依赖**:核心功能依赖少,引入负担低;按需启用高级特性,不拖慢编译 -- **高效**:编译期生成分发逻辑,运行时没有不必要的开销 - ---- - -好了,想来试试么? |
