术语

概述

在这些文档中，我们使用各种术语来描述通用翻译库中使用的不同概念。

本页面突出介绍了我们使用的一些关键术语。

关键术语

区域设置

区域设置是用于标识特定语言的代码。

有关更详细的解释，请参阅区域设置字符串页面。

例如，en-US是英语（美国）的区域设置。

在这些文档中，我们经常互换使用"区域设置"和"语言代码"这两个术语。

语言

当我们在代码使用上下文中提到语言时，我们实际上指的是区域设置。（或语言代码）

例如，当我们说"在调用setLocale时提供语言"时，我们实际上是指"在调用setLocale时提供区域设置"。

如果我们说"法语是支持的语言"，我们实际上是指"fr是支持的区域设置"。

字典

字典是一个JSON文件，包含一组（可能嵌套的）键值对。

键用作引用，值是字符串，可以是原始语言或翻译后的语言。

{
  "greeting": "Hello, World!",
  "farewell": "Goodbye, World!",
  "dashboard": {
    "title": "Dashboard",
    "description": "Welcome to the dashboard"
  }
}

这些键是人类可读的引用，用于在应用程序中查找翻译内容。

这些字典在结构和使用上是常规的，类似于其他i18n库中的翻译文件。

源字典

源字典是包含应用程序默认区域设置内容的字典。

翻译字典

翻译字典是包含与默认区域设置不同的特定区域设置内容的字典。

键与源字典相同，值是翻译后的字符串。

如果你有自己的翻译字典，可以使用loadDictionary()函数加载它们。

内联内容

内联内容是直接写在应用程序代码中的内容，而不是单独存储在JSON或字典文件等地方。

这包括：

• <T>组件
• useGT钩子
• getGT函数

源内容

源内容是应用程序默认区域设置的内容。它包括应用程序默认语言中编写的任何内容。

特别是对于gt-next和gt-react，源内容包括应用程序的所有可翻译内容，包括应用程序的源字典和任何内联内容。

源模板

源模板指的是存储源内容的特定数据格式。

{
  ["源内容的唯一标识符"]: "...内容..."
}

源内容的唯一标识符要么是源内容的哈希值，要么是用户定义的唯一标识符。

根据源内容的类型，相应的值可以是字符串、数组或对象。（字典使用字符串和数组，<T>组件使用对象）

翻译

在这些文档中，我们使用名词"翻译"来指代从源内容翻译得到的翻译内容。

翻译直接从你的源模板生成。

loadTranslations()函数允许你自定义存储这些翻译的位置。该函数期望JSON的格式与源模板相同。

使用CLI generate命令从你的源内容生成这些数据文件。

翻译是存储在GT CDN上的内容。

如果我们在提到JSON、MDX或MD文件时使用翻译，我们指的是原始源文件的直接翻译。