Skip to content

translation_standard.md

Latest commit

 

History

History
85 lines (66 loc) · 5.92 KB

translation_standard.md

File metadata and controls

85 lines (66 loc) · 5.92 KB
Raw

WarpNav 极速手册 - 全站速查表汉化与质量控制规范 (Translation Standard)

为了保证 WarpNav 极速手册 (qr.warpnav.com) 全站 200+ 个速查表卡片在汉化过程中零遗漏、零死角、高专业度且中英体验统一，特制定本质量控制与汉化标准指南。

一、 核心汉化原则 (Core Principles)

  1. 零死角全量汉化：禁止“半翻译半保留”或“仅翻译前两段”。Markdown 文件从第一行 Frontmatter 到最后一行，所有自然语言说明必须 100% 汉化。
  2. 严禁破坏代码与指令：所有可执行的代码块、命令行指令、Flag 参数、环境变量及国际通用计量单位100% 保留英文原样。
  3. 消除模板硬编码死角：清理所有 EJS 模板和逻辑中遗留的英文硬编码后缀（如将 cheatsheet 替换为 速查备忘单）。
  4. 技术术语标准化：对于容易混淆的专有名词，采用“中文名称 (英文原词)”双语对照规范。

二、 元素分类与翻译界限判定矩阵 (Matrix)

页面元素类型 汉化策略 示例与规范 (Before ➔ After) 规则说明
模板大标题后缀 100% 汉化 <%- title %> cheatsheet ➔ <%- title %> 速查备忘单 干掉顶栏及标题旁所有浅灰色英文 cheatsheet 单词
文章 Frontmatter Intro 100% 汉化 intro: A quick reference for... ➔ intro: ...极速参考备忘单。 卡片顶部导言简介全量汉化为自然流畅的中文
一级/二级大标题 (# / ##) 100% 汉化 # Getting Started (Getting Started) ➔ # 入门指南
## Built-in Data Types ➔ ## 内置数据类型		 彻底去除括号内冗余的英文后缀，保持大标题干练
卡片 Badge 标签 (###) 中文优先 / 推荐双语 ### Comments ➔ ### 代码注释 (Comments)
### Strings ➔ ### 字符串 (Strings)
### Variables ➔ ### 变量声明 (Variables)		 重中之重：Markdown 中的 ### 标题直接映射为卡片顶部紫色 Badge 标签，推荐使用 中文翻译 (英文原文) 或 纯中文 格式，保持专业与直观
表格表头 (Table Headers) 100% 汉化 Command | Alias | Status | Description
➔ 命令 | 别名 | 状态 | 功能描述		 提升表格排版的可读性与直观检索效率
表格与列表说明文字 100% 汉化 Launch interactive TUI ➔ 启动交互式 TUI 界面
Stable ➔ 稳定版		 表格功能描述与状态标签全量汉化
代码注释 (Code Comments) 100% 汉化 # age is of type int ➔ # age 变量类型为 int 代码块内部的解说注释全量汉化
代码块与命令行指令 100% 保留英文 docker run -d -p 80:80, print("Hello World") ➔ 100% 保留 保证指令复制即用，严禁改动变量与语法
专有名词与规格单位 保留英文 / 混排 Python, Docker, VRAM, Tokens, 128K, 5.1B ➔ 100% 保留 国际通用技术词汇与计量单位保持拼写
引导性提示词 100% 汉化 See: Strings ➔ 参阅：字符串
Read more ➔ 了解更多		 导航与关联引用链接提示词全量汉化

三、 卡片结构与 Badge 标签映射规范

由于主题会自动把 Markdown 文件中的 ### 三级标题渲染为卡片顶部的紫色 Badge 标签，必须严格遵循以下三级标题字典规范（支持并推荐使用 中文翻译 (英文原文) 的双语格式）：

通用 Badge 标签汉化字典

  • ### Getting Started ➔ ### 入门指南 (Getting Started)
  • ### Introduction ➔ ### 概述 (Introduction)
  • ### Variables ➔ ### 变量声明 (Variables)
  • ### Comments ➔ ### 代码注释 (Comments)
  • ### Conditionals / ### If statement ➔ ### 条件分支 (Conditionals)
  • ### Loops ➔ ### 循环语句 (Loops)
  • ### Functions ➔ ### 函数定义 (Functions)
  • ### Strings ➔ ### 字符串 (Strings)
  • ### Numbers ➔ ### 数值类型 (Numbers)
  • ### Booleans ➔ ### 布尔类型 (Booleans)
  • ### Lists / ### Arrays ➔ ### 列表 (Lists) / ### 数组 (Arrays)
  • ### Dictionaries / ### Maps ➔ ### 字典 (Dictionaries) / ### 哈希映射 (Maps)
  • ### File Handling ➔ ### 文件读写 (File Handling)
  • ### Classes & Inheritance ➔ ### 面向对象与继承 (Classes & Inheritance)
  • ### Examples ➔ ### 实用示例 (Examples)

四、 全量执行与自动化质量校验工作流 (Quality Workflow)

为了杜绝人工翻译导致的断层与遗漏，全站 200+ 个文件的汉化执行流程如下：

flowchart TD
    A[选择待汉化 Markdown 文件] --> B[提取全量文本内容]
    B --> C[应用四层汉化规范]
    C --> C1[1. Frontmatter 与 Intro 汉化]
    C --> C2[2. 大标题 # / ## 去除英文后缀]
    C --> C3[3. 三级标题 ### 100% 映射中文 Badge]
    C --> C4[4. 说明句、表格描述与注释全量汉化]
    C --> D[运行静态全量编译 npm run build]
    D --> E[运行自动化死角扫描脚本]
    E --> F{是否存在遗漏与混写?}
    F -- 是 --> C[二次修复死角]
    F -- 否 --> G[通过质量控制验证，发布上线]
Loading

质量检验标准 (Checklist)：

  1. 页面顶部无孤立英文 cheatsheet 单词。
  2. 页面大标题无 (Getting Started) 等拖泥带水的英文括号。
  3. 页面中所有卡片顶部的紫色 Badge 标签 100% 为中文。
  4. 从页面顶部滑动至底部，不存在全英文的大段落或未翻译的 Markdown 列表。
  5. 命令行与代码块 100% 可直接复制运行。

生效说明：本规范已在 WarpNav 极速手册 项目中即刻生效，作为后续所有卡片汉化与重构的唯一指导标准。