2021 年 4 月 9 日星期五
作者:Sandy Galloway

国际化贡献

DataTables 的国际化插件允许针对 DataTables 的表示层进行本地化。其目标始终是让社区尽可能轻松地提交 DataTables 的翻译。多年来,许多贡献者已在 Github 上提交了 84 种不同语言的拉取请求。如果您是其中一位贡献者,我们想感谢您对 DataTables 的改进!然而,随着时间的推移,更多可配置的语言选项已添加到 DataTables 及其扩展功能中,这导致许多语言不完整。

几个月前,我们部署了 一个新工具,让人们能够在无需创建拉取请求的情况下为国际化插件做出贡献。该工具易于使用,这意味着很多新提交已经完成,并增加了几个全新的翻译。我们希望这个新工具连同这篇博客文章能够让更多人轻松地为 DataTables 做出贡献并完成缺失的翻译。

用法

新的国际化插件工具提供了多种不同的功能。

  • 语言特定插件页面的链接
  • 每种语言的完成指示符
  • 每种语言的编辑/添加表单
  • 创建一个新语言的表单

我将在下面详细介绍这些内容。

语言特定插件页面的链接

这些链接显示在数据表的左栏中。它们链接到 此类页面,这些页面提供该语言插件所需的完整 JSON,以及有关从 CDN 和版本控制获得的信息。作者也列在页面的顶部,以感谢他们的贡献。

完成指示符

它只是简单地指示每种语言的翻译文件的完成程度。其目标是尽可能地让这些文件达到 100%! 这是一种简单的方法,可以了解社区在哪些语言选项方面可以做出更多贡献。

编辑/添加到一种现有语言

在完成指示符的右侧,有一个贡献按钮。这将打开一个表单,允许所有语言选项编辑或添加该语言。

在左侧,有一个选择元素,允许用户查看任何待提交的更改。这允许用户专注于翻译尚未被其他人完成的选项。当然,如果您发现在待定的翻译中有不准确之处,那么您可以提交自己的翻译来替换它。

选择元素后,您名字的输入项。这不是必需的。它只允许我们在相关页面和 JSON 文件中让您因对 DataTables 的贡献而获得荣誉。

左侧的语言选项旁边列出了输入元素用来获取它们的值。当选择输入元素时,表单的右侧将更新为提供有关语言选项的更多信息。将显示简要说明以及默认值,并适当地图像展示了它在 DataTables 中的使用位置。

一旦输入了所有翻译,只需按表单右下角的编辑按钮。然后,我们将审查它们,然后批准它们用于插件。

创建新语言

此表单与用于编辑/添加到当前语言的表单非常相似。语言选项仍全部列出,右侧显示相同的信息。

这里唯一的更改是用于存储语言名称的输入元素和另一个用于存储 此页面 列出的 LCID 代码的输入元素。

一旦你添加了所有可能的翻译,请按右下方的创建按钮,我们将审查该语言及其选项,然后批准它们。

许可

如工具的表单中所述,通过工具提交任何更改,即表示你同意根据 DataTables 的 MIT 许可 发布所做的任何更改。

摘要

我们希望此工具有用,并使为 DataTables 做出贡献比以往任何时候都容易,我们期待收到你的翻译!

与往常一样,如果你能想到任何改进此工具的方法,请与我们联系或在下方评论。