qt creator源码全方面分析(2-6)
User Interface Text Guidelines
请遵循本节中的准则，以确保扩展与Qt Creator UI保持一致，并且可以轻松地将其本地化为其他语言。
编写UI文本时，请确保它：
- 与现有的Qt Creator用户界面条款一致
- 简明扼要
- 中性，描述性和事实正确
- 明确的
- 可翻译成不同的语言
语法和风格
所有UI文本必须为语法正确的英语，并使用标准形式的书面语言。不要使用方言。使用惯用语言，即英语特有的表达。如果可能，请以英语为母语的人进行评论。
用户界面文本应简洁明了且经济实惠。避免使用不必要的内容词和短语。但是，更重要的是使文本有用且易于理解。
避免以第二个人称称呼用户。使用中性语调或被动语态，但在必要时使用称呼。称呼用户时，请避免使用“请”一词。例外情况是一些版权文本和简短的命令式句子，否则听起来可能会粗鲁。例如，请稍候。
避免在菜单名称和项目中使用缩写。如果没有足够的空间可以完整拼写或连字，请根据英语缩写规则将文本缩写。
避免缩写。例如，使用cannot 而不是can't。
标点
避免在菜单名称和菜单项中使用标点符号或特殊字符。
使用标点符号如下：
- 在消息中使用句号。
- 切勿在菜单项名称的末尾使用句号(.)。
- 放置三个句号(...)在菜单项名称的末尾，这将打开一个需要用户操作的对话框。
- 使用感叹号(!)，仅在需要用户特别注意或特别重要的文本中。
- 在变量值周围使用引号("")。 例如，关闭项目"qtcreator"。为了保持一致，请在用户可见的字符串中使用双引号突出显示或设置文件名，目录名，URL等。
- 不要使用前导，尾随或多个空格来对齐消息中的文本，因为翻译工具可能无法正确处理它们。
编写工具提示tooltips
工具提示包含有关图标，菜单项或其他UI元素的有用信息。当用户将鼠标指针放在UI元素上时，它们就会出现。您还可以向用户界面添加始终可见的描述性文本。
对于图标，可以将命令名用作工具提示。在这种情况下，请使用书本样式大写(book style capitalization)，并且不要在工具提示后添加句点。
工具提示也可以包含完整的句子。尝试使它们尽可能短而简洁，同时仍使它们在语法上正确。就像对任何句子一样，使用句子样式大写(sentence style capitalization)和标点符号。
设计模式中编写工具提示
在Qt Designer中，将纯文本用作工具提示。要获得更多格式，请在富文本编辑器的源选项卡中，编写简短的规范HTML：<html><head/><body><b>Note:</b> text.
Qt Designer具有简化富文本格式的功能（默认情况下处于启用状态），但仍然应通过查看源选项卡进行验证。
编写消息
检查消息是否简洁明了且经济合理。 但是，更重要的是消息是有用的并且易于理解。
尽量减少使用许多新的和不同的句子结构。 重用在类似情况下使用的句子结构。 例如：
- 无法将日志作为所选消息类型发送。文字太长。
- 无法接收图像。
- 无法插入图片。 文字长度上限为120个字符。
- 图片名称已被使用。
- 文件夹名称已被使用。
UI文本大写
使用两种样式，书名和句子样式（book title and sentence style）：
示例 Example of Book Title Capitalization
示例 Example of sentence style capitalization
使用书本样式大写
使用书本样式大写时，大写所有单词，除少于五个字母的介词（例如，是'with'而不是'Without'），连词（例如，and, or, but）和冠词（a, an, the ）。 但是，请始终将大写第一个和最后一个的上述单词。
将书本样式大写用于：
- 标题（窗口，对话框，组框，选项卡，列表视图列等）
- 功能（菜单项，按钮）
- 可选择项目（组合框项目，列表框项目，树形列表项目等）
检查书本样式大写
您可以使用\doc\titlecase文件夹中的to-title-case.js脚本来检查UI文本或文档中标题的书籍样式大写：
- 在浏览器中打开to-title-case.html。
- 在字段中输入用户界面文本。
- 单击转换。
带有建议的书本样式大写的UI文本显示在右侧的字段中。
使用句子样式大写
当使用句子样式大写时，除专有名称外，仅大写第一个字母。
将句子样式大写用于：
- 标签
- 工具提示
- 描述性文本
- 其他非头或标题文字
准备本地化
Qt Creator已本地化为多种语言。一致性和简洁性使UI文本更易于翻译。
标记UI文本进行翻译
确保呈现给用户的文本字符串易于翻译。用户界面文本字符串包含在tr()调用中，并在翻译过程中从源代码中提取。因此，翻译器可能不知道消息的源代码上下文。
您可以添加注释，使之在Qt Linguist( //:)中可见，以阐明上下文。例如：
//: Contact book "Add person" button label
return tr("Add");
如果该类不是Q_OBJECT，请使用QCoreApplication::translate("class context", "message")或考虑使用Q_DECLARE_TR_FUNCTIONS。不要使用QObject::tr()，这会造成混淆，因为消息在Qt Linguist中按类上下文分组显示，而与QObject绑定的消息没有类上下文。
传递给tr().arg()的文件和目录名称，使用QDir::toNativeSeparators()。
不要使用跨越整个字符串的标记，因为这会使翻译人员感到困惑。例如，不采用：
tr("<html><head/><body><span>UI Text</span></body></html>")
采用
QLatin1String("<html><head/><body><span>") + tr("UI Text") + QLatin1String("/span></body></html>")
语言或书写系统的特征
为了使扩展本地化，请考虑语言和书写系统对实现的影响。
不好意思，这一小节我也看的不知所云，大家感兴趣直接看原文吧，sry
| 语言或书写系统的特征 | 对实现的影响 |
|---|---|
| 字序 | 不同的语言具有不同的字序规则。 不要使用运行时串联。 请使用完整的短语和"%1"格式。 例如，使用： tr("Foo failed: %1").arg(message) 代替 tr("Foo failed: ") + message |
| 单数，复数，对偶形式 | 某些语言没有复数形式（例如，中文和日语），而另一些语言具有双重形式。 在布局设计中为文本扩展留出空间。 一些语言需要更多空间来表示多个或双重性以传达所需的信息。 例如使用 tr("%n files found", 0, number) 代替 tr("%1 files found").arg(number) |
| 性别 | 有些语言具有性别（女性，男性，中性），而有些则没有（例如芬兰语）或没有广泛使用（例如英语）。 不要重复使用文本字符串。 由于基本单词的性别，同一术语可能无法在其他情况下使用。 文章在某些语言中具有语法性别，而且在英语中句子不如容易被构造。 避免以下类型的构造： tr("%1 failed").arg(someCondition ? "the operation" : "opening a file") |
Qt Creator通用条款
本节总结了用于常见Qt Creator UI组件的术语。 它还描述了命名不同类型的UI组件的约定。
始终检查您打算使用的术语在UI中是否没有其他含义。如果已经存在合适的术语，请使用它。 例如，将查找Find用于搜索，将新建New用于创建新对象的向导。
有关如何添加UI组件的更多信息，请参见Common Extension Tasks。
| UI文本 | 使用 | 约定 |
|---|---|---|
| 上下文菜单 | 当用户右键单击屏幕时打开。 内容取决于上下文。 | 您可以添加与特定上下文相关的菜单项。 请遵循命名菜单项的约定。 |
| 对话框 | 用户界面元素通常包含许多选择，或允许用户向应用程序提供输入。 当用户选择菜单项或按钮时打开。 | 使用菜单项或按钮名称作为对话框名称。 您也可以将菜单项或按钮名称与对话框中管理的对象名称结合在一起。例如，文档选项中的添加按钮将打开添加文档对话框。 |
| 定位器 | 使您不仅可以浏览文件，还可以浏览定位过滤器（locator filter）得到的任何条目。 | 您可以添加定位过滤器。 检查过滤器是否尚未使用，并为其指定描述性名称。 |
| 菜单 | 包含代表命令或选项的菜单项，并在逻辑上进行分组和显示。 菜单也可以包含子菜单。 | 您可以创建新菜单。 使用与现有菜单名称一致的简短但描述性的名称。 使用无歧义的名称。 |
| 菜单项 | 表示供用户选择的命令或选项。 | 您可以将新条目添加到菜单。 使用与现有菜单名称一致的简短但描述性的名称。 使用无歧义的名称。 |
| 消息框 | 以状态信息，警告或错误消息的形式向用户提供反馈的对话框。
来自Qt Creator的输出应该显示在输出面板中。 |
使用事件作为标题，并在消息框中提供解决方案。 |
| 模式 | 模式对应于全屏幕控件，专门用于任务。 | 例如，您可以为新型编辑器添加模式。 使用描述性但简短的模式名称。 它们必须适合于模式选择器。 |
| 输出面板 | 任务面板中显示的面板，显示Qt Creator的输出。 | 对输出面板使用描述性名称。 |
| 侧边栏 | 在编辑和调试模式下可用的视图，可用于浏览项目，文件和书签，以及查看类层次结构。 | 您可以将视图添加到侧边栏菜单。 使用描述性名称。 |
| 视图 | 屏幕上为用户显示信息，以及为用户提供管理信息功能的区域。 调试模式下可用，用于与在调试器控制下运行的程序进行交互。 | 对视图使用描述性名称。 |
原创造福大家，共享改变世界
献出一片爱心，温暖作者心灵
qt creator源码全方面分析(2-6)的更多相关文章
- qt creator源码全方面分析(3-3)
目录 qtcreatordata.pri 定义stripStaticBase替换函数 设置自定义编译和安装 QMAKE_EXTRA_COMPILERS Adding Compilers 示例1 示例2 ...
- qt creator源码全方面分析(3-5)
目录 qtcreatorlibrary.pri 使用实例 上半部 下半部 结果 qtcreatorlibrary.pri 上一章节,我们介绍了src.pro,这里乘此机会,把src目录下的所有项目文件 ...
- qt creator源码全方面分析(0)
本人主攻C++和Qt. 上两天刚研究完Qt install framework(IFW)应用程序安装框架. google没发现有正儿八经的官方文档的翻译,我就进行了翻译哈!! 系列文章具体见:http ...
- qt creator源码全方面分析(4-0)
Qt系统 Qt Creator源码是在Qt对象和框架基础下写的,因此,阅读Qt Creator源码,你首先对Qt得有一定的了解. Qt Core Qt Core特征: The Meta-Object ...
- qt creator源码全方面分析(4-2)
目录 global头文件 global.h xx.h global头文件 插件的本质就是动态链接库,对于库,需要导出符号,供用户导入使用.在qt creator的源码中,存在固定的导入导出模式. gl ...
- qt creator源码全方面分析(4-5)
目录 Qt中的字符串 QLatinString 详细介绍 源码 小结 QStringLiteral(str) 详细介绍 源码 小结 Qt中的字符串 Qt中处理字符串最常用的肯定是QString,但是在 ...
- qt creator源码全方面分析(4-6)
目录 Qt插件基础 Qt插件基础 我们知道Qt Creator源码是基于插件架构的,那么我们先来介绍下插件基础知识. 相关内容如下: How to Create Qt Plugins [ - Defi ...
- qt creator源码全方面分析(3-2)
目录 qtcreator.pri 判断重复包含 定义版本信息 VERSION 定义IDE名称 启用C++14 CONFIG 自定义函数 Replace Functions Test Functions ...
- qt creator源码全方面分析(2-7)
目录 Completing Code 补全代码片段 编辑代码片段 添加和编辑片段 删除片段 重置片段 补全Nim代码 Completing Code 在编写代码时,Qt Creator建议使用属性,I ...
- qt creator源码全方面分析(2-10-1)
目录 Getting and Building Qt Creator 获取Qt 获取和构建Qt Creator Getting and Building Qt Creator 待办事项:应该对此进行扩 ...
随机推荐
- LibreOJ6279. 数列分块入门 3 题解
题目链接:https://loj.ac/problem/6279 题目描述 给出一个长为 \(n\) 的数列,以及 \(n\) 个操作,操作涉及区间加法,询问区间内小于某个值 \(x\) 的前驱(比其 ...
- Java网络编程——TCP图片上传
1.编写一个服务器端程序,用来接收图片.创建一个监听指定端口号的ServerSocket服务端对象,在while(true)无限循环中持续调用ServerSocket的accept()方法来接收客户端 ...
- web前端常用知识点
1.常见的块级元素 内联元素 div -最常用的块级元素 dl - 和dt-dd 搭配使用的块级元素 form - 交互表单 h1 -h6- 大标题 hr ...
- 【转】VS2017缺少文件
在VS工程中,添加c/c++工程中外部头文件及库的基本步骤: 1.添加工程的头文件目录:工程---属性---配置属性---c/c++---常规---附加包含目录:加上头文件存放目录. 2.添加文件引用 ...
- GitHub 标星 2.4w+，最适合编程新手入门的宝藏项目推荐
照惯例这周给大家推荐几个Github上高星的优秀项目,我的github:图灵的猫 ,也欢迎大家follow~ 下面这是第一个,也是首推的新手入门项目,以前我入门的时候如果有这样一个项目,知识广度和 ...
- 【转】在MyEclipse 8.6上搭建Android开发环境
内容导航 第 1 页:基本环境准备 第 2 页:下载Android SDK 第 3 页:配置SDK环境变量 第 4 页:给MyEclipse安装ADT插件 第 5 页:配置MyEclipse 第 6 ...
- vue中动态设置echarts画布大小
document.getElementById('news-shopPagechart').style.height = this.heightpx2+'px'; //heightpx2定义在data ...
- vue 移动端在div上绑定click事件 失效
在.vue的文件中使用了better-scroll,在div标签上绑定click事件后,无效. 原因:使用了better-scroll,默认它会阻止touch事件.所以在配置中需要加上click: t ...
- 让你的 Linux 命令骚起来
目录 管道符号 " | " grep sed awk sort comm uniq tr cat head tail wc find tsort tee 「>」重定向符号 「 ...
- Linux下Tomcat,mysql安装包及教程整合，
前段时间孔老师给了一个虚拟机,自己瞎捣鼓,装了Tomcat和mysql,捣鼓了好几天,把一些安装包和试过还不错的博客整理出来: 老师给的已经装好了Linux系统和JDK. Tomcat9安装包 ...