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文本或文档中标题的书籍样式大写：

  1. 在浏览器中打开to-title-case.html。
  2. 在字段中输入用户界面文本。
  3. 单击转换。

带有建议的书本样式大写的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)的更多相关文章

  1. qt creator源码全方面分析(3-3)

    目录 qtcreatordata.pri 定义stripStaticBase替换函数 设置自定义编译和安装 QMAKE_EXTRA_COMPILERS Adding Compilers 示例1 示例2 ...

  2. qt creator源码全方面分析(3-5)

    目录 qtcreatorlibrary.pri 使用实例 上半部 下半部 结果 qtcreatorlibrary.pri 上一章节,我们介绍了src.pro,这里乘此机会,把src目录下的所有项目文件 ...

  3. qt creator源码全方面分析(0)

    本人主攻C++和Qt. 上两天刚研究完Qt install framework(IFW)应用程序安装框架. google没发现有正儿八经的官方文档的翻译,我就进行了翻译哈!! 系列文章具体见:http ...

  4. qt creator源码全方面分析(4-0)

    Qt系统 Qt Creator源码是在Qt对象和框架基础下写的,因此,阅读Qt Creator源码,你首先对Qt得有一定的了解. Qt Core Qt Core特征: The Meta-Object ...

  5. qt creator源码全方面分析(4-2)

    目录 global头文件 global.h xx.h global头文件 插件的本质就是动态链接库,对于库,需要导出符号,供用户导入使用.在qt creator的源码中,存在固定的导入导出模式. gl ...

  6. qt creator源码全方面分析(4-5)

    目录 Qt中的字符串 QLatinString 详细介绍 源码 小结 QStringLiteral(str) 详细介绍 源码 小结 Qt中的字符串 Qt中处理字符串最常用的肯定是QString,但是在 ...

  7. qt creator源码全方面分析(4-6)

    目录 Qt插件基础 Qt插件基础 我们知道Qt Creator源码是基于插件架构的,那么我们先来介绍下插件基础知识. 相关内容如下: How to Create Qt Plugins [ - Defi ...

  8. qt creator源码全方面分析(3-2)

    目录 qtcreator.pri 判断重复包含 定义版本信息 VERSION 定义IDE名称 启用C++14 CONFIG 自定义函数 Replace Functions Test Functions ...

  9. qt creator源码全方面分析(2-7)

    目录 Completing Code 补全代码片段 编辑代码片段 添加和编辑片段 删除片段 重置片段 补全Nim代码 Completing Code 在编写代码时,Qt Creator建议使用属性,I ...

  10. qt creator源码全方面分析(2-10-1)

    目录 Getting and Building Qt Creator 获取Qt 获取和构建Qt Creator Getting and Building Qt Creator 待办事项:应该对此进行扩 ...

随机推荐

  1. DFT与IDFT

    [转]https://blog.csdn.net/mingzhuo_126/article/details/88044390 二.编程实现考滤到DFT和IDFT算法过程中有部分相似,可以把它们合成到一 ...

  2. 通过例子学习C++（三）最大公约数，并知其然

    本文是通过例子学习C++的第三篇,通过这个例子可以快速入门c++相关的语法. 题目要求:输入两个整数,求其大公约数. 解答方法一:两个数的最大公约数,是这两个数中的小数,或者是这2个数的公约数中的最大 ...

  3. Linux之shell编程的基本使用

    1.Shell shell是一个命令行解释器,它为用户提供了一个向 Linux 内核发送请求以便运行程序的系统级程序 2.shell编程打印hello world 2.1 代码部分 #!/bin/ba ...

  4. 数据库的SQL基本用法 创建 删除 查询 修改

    1.说明:创建数据库CREATE DATABASE database-name 2.说明:删除数据库drop database dbname 3.说明:备份sql server--- 创建 备份数据的 ...

  5. 更加清晰的TFRecord格式数据生成及读取

    TFRecords 格式数据文件处理流程 TFRecords 文件包含了 tf.train.Example 协议缓冲区(protocol buffer),协议缓冲区包含了特征 Features.Ten ...

  6. 转型IT学什么语言好，学编程语言为何要重视代码规范？

    造价转IT需要注意什么,先学什么比较好?属于零基础,2019毕业,三本学校,男.自己的想法是先以副业来学习,在合适的时候转入it行业.1.以副业来学的话应该先学习什么比较好?2.如果要直接找工作的话先 ...

  7. linux 反选删除文件

    一.背景 历史原因自动部署程序的历史版本没有自动删除脚本.导致服务器没有空间了.但是又不能将所有的备份都删除. 所以要求只保留一个备份版本,把其他的删除. 二. 要求 要求:删除 除了 2017110 ...

  8. SpringCloud组件和概念介绍(一)

    一:什么是微服务(Microservice) 微服务英文名称Microservice,Microservice架构模式就是将整个Web应用组织为一系列小的Web服务.这些小的Web服务可以独立地编译及 ...

  9. 使用read、readline、readlines和pd.read_csv、pd.read_table、pd.read_fwf、pd.read_excel获取数据

    从文本文件读取数据 法一: 使用read.readline.readlines读取数据 read([size]):从文件读取指定的字节数.如果未给定或为负值,则去取全部.返回数据类型为字符串(将所有行 ...

  10. Creating Custom Helper Methods 创建自定义辅助器方法----辅助器方法 ------ 精通ASP.NET MVC 5

    创建内联的辅助器方法 和 拓展方法 好像类似的功能. 不过写在前台更直观