From 66c04d0ec20d491463036191cdda70dfef34af82 Mon Sep 17 00:00:00 2001 From: neverland Date: Mon, 14 Sep 2026 15:03:57 +0800 Subject: [PATCH] docs: refine homepage command descriptions --- website/i18n.json | 104 +++++++++--------- website/theme/components/Commands.module.scss | 2 +- website/theme/components/Commands.tsx | 6 +- 3 files changed, 56 insertions(+), 56 deletions(-) diff --git a/website/i18n.json b/website/i18n.json index c7d60fd..0f57325 100644 --- a/website/i18n.json +++ b/website/i18n.json @@ -32,120 +32,120 @@ "zh": "从开发到构建，快人一步" }, "appCommandDesc": { - "en": "Start a dev server in an instant and build your app for production. Powered by Rsbuild, with the speed of Rspack at every step.", - "zh": "快速启动开发服务器，轻松构建生产应用。基于 Rsbuild，让 Rspack 的速度贯穿整个开发流程。" + "en": "Powered by Rspack and Rsbuild, start a dev server quickly and build enterprise-grade web applications", + "zh": "基于 Rspack 和 Rsbuild，快速启动开发服务器，构建企业级 Web 应用" }, "appCommandHmr": { - "en": "Fast feedback with hot module replacement", - "zh": "热模块替换（HMR），即时反馈代码变更" + "en": "Build 5–20× faster than webpack", + "zh": "构建速度比 webpack 快 5–20 倍" }, "appCommandProduction": { - "en": "Optimized production builds powered by Rspack", - "zh": "由 Rspack 驱动，生成优化的生产产物" + "en": "Built-in production optimizations for leaner bundles", + "zh": "内置多项生产优化能力，生成精简的产物" }, "appCommandConfig": { - "en": "One app configuration for development and builds", - "zh": "开发与构建，共用一份应用配置" + "en": "A consistent bundling process for development and production", + "zh": "开发与生产采用一致的打包流程" }, "libCommandTitle": { "en": "Your library, ready to ship", "zh": "构建你的库，轻松交付" }, "libCommandDesc": { - "en": "Build JavaScript and TypeScript libraries with Rslib. From reusable utilities to component libraries, bring your code to more projects.", - "zh": "使用 Rslib 构建 JavaScript 和 TypeScript 库。从通用工具到组件库，让你的代码在更多项目中复用。" + "en": "Build reusable JavaScript libraries with Rslib, with the flexibility to develop shared libraries, CLI tools, and components", + "zh": "使用 Rslib 构建可复用的 JavaScript 库，灵活应对公共库、命令行和组件开发需求" }, "libCommandFormats": { - "en": "Flexible output formats, including ESM and CommonJS", - "zh": "灵活的产物格式，支持 ESM 和 CommonJS" + "en": "One configuration for ESM, CJS, Module Federation, and more", + "zh": "一份配置，输出 ESM、CJS 和模块联邦等多种格式" }, - "libCommandTypes": { - "en": "Generate TypeScript declarations with --dts", - "zh": "通过 --dts 生成 TypeScript 类型声明" + "libCommandModes": { + "en": "Choose bundle or bundleless output to suit your needs", + "zh": "按需选择 bundle 或 bundleless 输出模式" }, - "libCommandWatch": { - "en": "Rebuild on every change with --watch", - "zh": "通过 --watch 监听变更，自动重新构建" + "libCommandTypes": { + "en": "Generate type declarations quickly with TypeScript 7", + "zh": "使用 TypeScript 7 快速生成类型声明" }, "testCommandTitle": { - "en": "Test as fast as you build", - "zh": "测试与开发，同样高效" + "en": "Faster tests, instant feedback", + "zh": "更快测试，即时反馈" }, "testCommandDesc": { - "en": "Run your tests with Rstest and keep feedback close to your code. Share your build settings and move from local development to CI with ease.", - "zh": "使用 Rstest 运行测试，及时获得代码反馈。复用构建配置，让测试从本地开发顺畅延伸到 CI。" + "en": "Test JavaScript with Rstest for fast feedback from local development to CI", + "zh": "使用 Rstest 测试 JavaScript 代码，从本地开发到 CI 保持高效反馈" }, "testCommandConfig": { - "en": "Automatically inherit app or library configuration", - "zh": "自动继承应用或库的配置" + "en": "Automatically reuse existing build configuration to reduce maintenance", + "zh": "自动复用已有构建配置，减少维护成本" }, - "testCommandWatch": { - "en": "Rerun related tests as your code changes", - "zh": "代码变更时，自动重新运行相关测试" + "testCommandApi": { + "en": "Familiar Jest APIs", + "zh": "熟悉的 Jest API" }, - "testCommandCoverage": { - "en": "Collect coverage locally or run once in CI", - "zh": "支持覆盖率收集和适用于 CI 的单次运行" + "testCommandPerformance": { + "en": "Rspack-powered tests, over 20% faster than Jest", + "zh": "由 Rspack 加速测试，比 Jest 快 20% 以上" }, "checkCommandTitle": { "en": "Consistent code. One command", "zh": "一个命令，保持代码一致" }, "checkCommandDesc": { - "en": "Run lint and formatting checks together, with optional TypeScript type checking. Keep your existing code style with support for Prettier options and plugins.", - "zh": "一次完成代码检查与格式校验，按需启用 TypeScript 类型检查。兼容 Prettier 的格式化选项与插件，延续现有代码风格。" + "en": "Unify linting and formatting checks while keeping your Prettier options and plugins", + "zh": "统一运行代码检查与格式校验，兼容 Prettier 选项与插件，延续团队代码规范" }, "checkCommandTypes": { - "en": "Type-aware linting, with optional type checking", - "zh": "支持类型感知的代码检查，按需启用类型检查" + "en": "Type-aware linting with optional TypeScript type checking", + "zh": "支持类型感知规则，按需启用 TypeScript 类型检查" }, "checkCommandFormat": { - "en": "Parallel formatting with a persistent cache", - "zh": "并行格式化与持久化缓存，加速重复运行" + "en": "Parallel formatting and persistent caching for faster repeat runs", + "zh": "并行格式化与持久化缓存，加速重复检查" }, "checkCommandFix": { - "en": "Apply lint and formatting fixes with rs check --fix", - "zh": "通过 rs check --fix 自动修复代码与格式问题" + "en": "Fix lint and formatting issues with --fix", + "zh": "通过 --fix 自动修复代码与格式问题" }, "hooksCommandTitle": { "en": "Better code in every commit", "zh": "让每次提交，都经过检查" }, "hooksCommandDesc": { - "en": "Automatically check and format staged files before committing. Reuse lint-staged task configuration and migrate your existing Git Hooks workflow from Husky.", - "zh": "在提交前自动检查和格式化暂存文件。支持 lint-staged 的任务配置，可从 Husky 迁移现有 Git Hooks 工作流。" + "en": "Bring checks into your commit workflow, reuse lint-staged task configuration, and migrate existing Husky hooks", + "zh": "将代码检查融入提交流程，兼容 lint-staged 任务配置，支持迁移现有 Husky hooks" }, "hooksCommandSetup": { - "en": "Manage Git hooks for the whole repository", - "zh": "统一管理整个仓库的 Git Hooks" + "en": "Manage repository-wide Git hooks in one place", + "zh": "统一管理仓库级 Git hooks" }, "hooksCommandStaged": { - "en": "Run checks on staged files before committing", - "zh": "提交前，针对暂存文件运行检查" + "en": "Check and format staged files before each commit", + "zh": "仅检查和格式化暂存文件，聚焦本次提交" }, "hooksCommandTasks": { - "en": "Configure lint, format, and custom tasks by file pattern", - "zh": "按文件模式配置检查、格式化及自定义任务" + "en": "Match files with glob patterns and run custom tasks", + "zh": "按文件模式匹配任务，灵活运行自定义命令" }, "docCommandTitle": { "en": "Great docs, built right in", "zh": "让文档，融入开发流程" }, "docCommandDesc": { - "en": "Turn your content into a documentation site with Rspress. Keep your docs alongside your code, with one configuration for the whole workflow.", - "zh": "使用 Rspress 将内容构建为文档站点。让文档与代码一同维护，通过统一配置串联完整工作流。" + "en": "Build documentation sites with Rspress and maintain docs alongside your code", + "zh": "使用 Rspress 构建文档站点，让项目文档与代码一同开发和维护" }, "docCommandMarkdown": { - "en": "Write in Markdown and add React components with MDX", - "zh": "使用 Markdown 编写文档，通过 MDX 嵌入 React 组件" + "en": "Write Markdown and embed React components with MDX", + "zh": "支持 Markdown 与 MDX，灵活嵌入 React 组件" }, "docCommandFeatures": { "en": "Built-in search and multilingual documentation", "zh": "内置全文搜索，支持多语言文档" }, "docCommandWorkflow": { - "en": "Develop, build, and preview with one CLI", - "zh": "通过统一命令行完成开发、构建与预览" + "en": "One CLI for development, production builds, and local previews", + "zh": "统一完成文档开发、生产构建与本地预览" }, "guide": { "en": "Guide", diff --git a/website/theme/components/Commands.module.scss b/website/theme/components/Commands.module.scss index a5651b1..f6c5be1 100644 --- a/website/theme/components/Commands.module.scss +++ b/website/theme/components/Commands.module.scss @@ -74,7 +74,7 @@ .description { margin: 1.25rem 0 0; color: var(--command-text); - font-size: 1rem; + font-size: 0.925rem; line-height: 1.75; } diff --git a/website/theme/components/Commands.tsx b/website/theme/components/Commands.tsx index 683c2ed..1e3cdb5 100644 --- a/website/theme/components/Commands.tsx +++ b/website/theme/components/Commands.tsx @@ -161,8 +161,8 @@ export function Commands() {

{t('libCommandDesc')}

@@ -192,9 +192,9 @@ export function Commands() {

{t('testCommandTitle')}

{t('testCommandDesc')}