Inno Setup 简体中文翻译规范深度指南:占位符、换行符、快捷键与不加点号规则
【免费下载链接】Inno-Setup-Chinese-Simplified-Translation:earth_asia: Inno Setup Chinese Simplified Translation项目地址: https://gitcode.com/gh_mirrors/in/Inno-Setup-Chinese-Simplified-Translation
Inno Setup 简体中文翻译项目为 Inno Setup 6.5.0+ 提供了开箱即用的安装向导汉化方案。本指南面向新手与开发者,讲透 ChineseSimplified.isl 翻译文件背后的 4 条核心规范:占位符写法(%1与[name])、%n换行符、(&N)快捷键标记,以及"不加点号"规则——掌握它们,你既能正确使用中文安装包,也能安全地维护或扩展翻译。
快速启用 Inno Setup 简体中文翻译
启用分两步,整个过程不到一分钟:
- 将 ChineseSimplified.isl 放入Inno Setup 安装目录下的
Languages文件夹; - 在新建脚本时,于Languages选项勾选Chinese Simplified,效果如下图所示:
如果是在现有脚本中添加,只需在[Languages]段落加一行:
Name: "chinesesimplified"; MessagesFile: "compiler:Languages\ChineseSimplified.isl"💡 持续集成(CI)环境:把
.isl文件放进项目仓库,MessagesFile改为相对路径即可,详见 README.md 中的配置说明。
翻译文件深度解析:三类占位符写法
打开 ChineseSimplified.isl,每条消息都是消息名=翻译内容的键值对。翻译内容中有3 类占位符,它们来源不同、作用不同,翻译时必须原样保留:
| 类型 | 示例 | 含义 | 来源 |
|---|---|---|---|
%数字 | 安装 - %1 | 运行时变量,如程序名、错误码 | Inno Setup 引擎 |
[方括号] | 欢迎使用 [name] 安装向导 | 脚本作者可自定义的变量,如[name]、[name/ver]、[gb]、[mb] | 安装脚本 |
| 字面量 | C:\App、\\server\share | 需要原样保留的示例文本 | 无 |
典型例子对比(可直接点开原文查看):
- 窗口标题:
SetupWindowTitle=安装 - %1,见 ChineseSimplified.isl - 欢迎页:
WelcomeLabel1=欢迎使用 [name] 安装向导,见 ChineseSimplified.isl - 磁盘空间提示:
DiskSpaceGBLabel=至少需要有 [gb] GB 的可用磁盘空间。,见 ChineseSimplified.isl
📌 常见翻译事故就是把[name]或%1翻译成中文、挪动位置或删除——正确做法是只翻译占位符之外的文字,占位符位置与数量必须和英文原文严格对应。
%n换行符:翻译中如何保留换行
当一条消息本身较长、英文原文用%n(两个连用表示空行%n%n)强制换行时,中文翻译也必须保留,否则多行提示会挤成一团。例如:
InvalidPath=您必须输入一个带驱动器盘符的完整路径,例如:%n%nC:\App%n%n或UNC路径:%n%n\\server\share,见 ChineseSimplified.isl- 退出确认:
ExitSetupMessage=安装程序尚未完成。……%n%n现在退出安装程序吗?,见 ChineseSimplified.isl - 注册表错误:
ErrorRegOpenKey=打开注册表项时出错:%n%1\%2,见 ChineseSimplified.isl
规则:%n既不是%1那种数字占位符,也不是普通文字,它是 Inno Setup 的换行转义序列,在翻译时按"不可见符号"原样保留。
快捷键规范:(&N) 是什么意思
中文翻译中大量出现下一步(&N) >、确定这类文本,形如(&X)的部分是Windows 加速键(Access Key)标记:
- 显示在按钮上时,
&不可见,用户按Alt + N即可触发"下一步"; &标记的字母(N、B、A、M等)必须与英文原文保持一致,不能随意改字母,否则快捷键行为会错乱;- 同一对话框内的多个按钮不能共用同一个加速字母,例如 ChineseSimplified.isl 中"上一步(&B)"、"浏览(&B)..."分属不同页面,不冲突。
按钮与选项类的快捷键分布很集中:
- 向导按钮区:ChineseSimplified.isl
- 许可协议选项:ChineseSimplified.isl
- 附加任务选项:ChineseSimplified.isl
不加点号规则:为什么有的句子末尾没有"。"
这是翻译文件头部注释中最容易忽略的一条规则,原文写道:对本身不带句点(.)的消息,翻译时不要补加句号,因为 Inno Setup 会自动在消息末尾追加句号,重复添加会显示成两个点,见 ChineseSimplified.isl。
对应到简体中文,实践中的做法是:
| 英文原文末尾 | 中文翻译末尾 | 示例(原文位置) |
|---|---|---|
| 无句号 | 不加"。",由引擎自动补全 | ErrorCreatingDir=安装程序无法创建目录“%1”,L86 |
| 有句号/问号 | 保留相应标点 | StopDownload=您确定要停止下载吗?,L225 |
一句话总结:以英文原文的标点风格为准,引擎负责收尾标点,翻译者不要画蛇添足。
翻译规则速查表 + [LangOptions] 配置要点
速查表
| # | 规则 | 要点 |
|---|---|---|
| 1 | 占位符 | %1、[name]等原样保留,位置与数量与英文一致 |
| 2 | 换行 | %n(含%n%n空行)原样保留 |
| 3 | 快捷键 | (&X)中的字母与英文原文保持一致 |
| 4 | 标点 | 原文末尾无句号则翻译也不加点号 |
[LangOptions] 配置要点
文件头部的[LangOptions]段定义了语言本身的元信息,见 ChineseSimplified.isl:
LanguageName=简体中文:安装向导"选择安装语言"对话框中显示的文案;LanguageID=$0804:简体中文的 Windows 语言 ID,决定系统级字体与排版行为;LanguageCodePage=936:GBK 代码页,即便文件是 UTF-8 也建议保留;DialogFontName等字体项默认被注释:简体中文使用系统默认字体即可,无需修改。
相关文件一览
| 文件 | 说明 |
|---|---|
| ChineseSimplified.isl | 简体中文消息文件,本指南的分析对象 |
| README.md | 使用方法、CI 环境配置示例 |
| LICENSE | MIT 许可证,允许自由使用与修改 |
翻译文件由维护者持续跟进 Inno Setup 新版本(当前支持6.5.0+;5.x 请使用对应分支的旧版文件)。当你需要修改翻译时,记住本文的 4 条规则——占位符不动、%n保留、快捷键字母不改、末尾不画蛇添足——你的改动就能安全地通过编译并在向导中正确显示。
【免费下载链接】Inno-Setup-Chinese-Simplified-Translation:earth_asia: Inno Setup Chinese Simplified Translation项目地址: https://gitcode.com/gh_mirrors/in/Inno-Setup-Chinese-Simplified-Translation
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考