翻译文档

翻译 Dolibarr 应用程序

Dolibarr的语言文件已经被翻译成多种语言。英语是其默认的语言，并且其内容会始终保持完整。其他语言的文档是否完整依赖于自愿者的贡献。本教程帮助您针对未被翻译或者翻译错误的文档完成语言翻译工作。 Dolibarr可以用三种不同的方式翻译：

手动使用Transifex （官方和推荐的方法）
手动编辑语言文件
全自动：自动翻译机

使用Transifex在线服务进行手动翻译（推荐）

Transifex 是一个为翻译项目提供在线平台的Web应用程序。它包括团队和讨论工具、翻译记忆库、词汇表、校对和许多其他功能。它非常容易使用，所有翻译都可以通过Web界面或者使用TX客户端终端上传或下载。 Transifex 是一个开源项目，“社区版”可以免费下载和安装，但我们将使用在线托管服务。

使用Web界面（适用于翻译人员）

如果你想帮忙把Dolibarr翻译成自己的语言，请进入该项目的页面 https://www.transifex.com/dolibarr-association/dolibarr/

然后，您可以注册一个帐户，并请求加入目标语言的项目团队。管理员会接受您的请求，所以请耐心等待。

一旦被接受，您就可以马上开始翻译了。

欲了解更多信息，请查阅网站 http://docs.transifex.com/introduction/translators/ 上的Transifex Getting Started（入门）介绍规范和网站 http://docs.transifex.com/tutorials/txeditor/ 上的web editor tutorial（编辑器向导）。

关于 en_US 的备注

这个Web界面不能用来翻译源代码的en_US语言。

对en_US语言的任何更改都必须在Dolibarr源代码中完成，并在我们的GitHub存储库上使用Pull Request提交。

使用TX 命令行客户端 (适用于管理员团队 Category:Yoda )

这部分描述了如何从命令行中使用Transifex。然而，这是保留给Dolibarr管理员用户（Yoda团队）的，用于将Transifex与Dolibarr主源码同步。

更多信息请参考Transifex 官方文档

TX 客户端设置

首先要安装 TX 客户端，操作系统使用 Debian/Ubuntu/Mint:

apt-get install python-pip
pip install transifex-client

然后你必须初始化你的TX环境。这是通过进入Dolibarr项目根目录运行 tx init 来完成的。

cd git/dolibarr
tx init

接受覆盖配置文件。保留Transifex实例的默认值，然后输入您的Transifex登录名和密码。

在此之后，一个.transifexrc文件已经创建到您的HOME目录，并且一个通用配置文件被创建为项目根目录中的.tx/config。目录的内容看起来会是这样的：

.
|-- build
|-- build.xml
|-- ChangeLog
|-- COPYING
|-- COPYRIGHT
|-- dev
|-- doc
|-- .gitignore
|-- htdocs
|-- INSTALL
|-- pom.xml
|-- quickbuild.xml
|-- README
|-- README-FR
|-- README.md
|-- robots.txt
|-- scripts
|-- test
`-- .tx

当前的配置文件可以从 https://github.com/Dolibarr/dolibarr/tree/develop/.tx 下载，将其放入.tx目录，覆盖由 tx init 创建的配置文件。

此项目配置文件用于存储项目的详细信息和文件到资源的映射。

这是配置文件包含的内容的示例：

[main]
host = https://www.transifex.com
lang_map = uz: uz_UZ

[dolibarr.admin]
file_filter = htdocs/langs/<lang>/admin.lang
source_file = htdocs/langs/en_US/admin.lang
source_lang = en_US
type = MOZILLAPROPERTIES

下面是配置文件中使用的片段和选项的说明：

[main] section

在本片段中，我们有项目范围的选项，例如：所有项目的默认transifex主机。如果需要的话，这些可以被每个资源覆盖。

[dolibarr.resource]

source_lang: 这是资源的源语言
source_file: 这直接指向源文件
file_filter: 在这里，我们保存用于标识特定项目下的翻译文件的表达式。非强制性
trans.<lang>: 这用于不遵循公共命名模式的翻译文件，并且文件表达式不能用于跟踪它们。非强制性
host: 如果项目不使用[main]片段中指定的默认Transifex服务器，它可以使用此选项覆盖它。非强制性

TX 客户端使用

一些有用的 tx 命令。

tx status

显示翻译状态

tx push

用于将更改从你的计算机推送到Transifex服务器。

tx push命令的其他选项包括：

-h - 显示命令行帮助
-l <lang> - 指定要推送哪些翻译（默认为所有）
-r <resource> - 指定要向其推送翻译的资源（默认为所有）
-f - 在不修改修改时间的情况下推送源文件
--skip - 错误时不要停止。当同时推多个文件时很有用。
-s - 将源文件推送到服务器
-t - 将翻译文件推送到服务器
--no-interactive - 强制推送时不需要用户输入。

tx pull

用于将更改从Transifex服务器拉到您的计算机上。
tx pull命令的其他选项包括：

-h - Shows the help screen for the command
-l <lang> - Specify which translations you want to pull (defaults to all)
-r <resource> - Specify the resource for which you want to pull the translations (defaults to all)
-a - Fetch all translation files from server (even new ones)
-s - Force the fetching of the source file (default: False)
-f - Force download of translations files
--skip - Don't stop on errors. Useful when pushing many files concurrently.
--disable-overwrite - By default Transifex will fetch new translations files and replace existing ones. Use this flag if you want to disable this feature.
--minimum_perc=VALUE - Specify the minimum acceptable percentage of a translation in order to download it.

示例：

要拉取翻译文档，可以使用:

tx -d pull -l it_IT  # Get italian language only
tx -d pull -a   # Get all languages

要推送源文件，只需键入:

tx -d push -t -l it_IT [-r dolibarr.file]   # To push only a specific translation file
tx -d push -s  # To push source file

关于transifex流程的其他问题

这是一个简短的Q&A，你也可以询问transifex翻译进程：

1) 同步是否按固定的时间间隔完成?

不，只有在提交了足够的译文时才进行翻译。在创建最终发布包之前，它也会在beta分支上完成。

2) 是否所有的翻译都同步到git，还是仅仅同步经过审核的翻译。在同步完成之前我需要进行检查吗?

当同步完成时，transifex文件将覆盖git中的文件，但前提是该文件至少有一条记录被修改。在同步完成之前，您不必进行复查。最重要的是，要知道哪些行是手动审核的，哪些行是最初使用机器人翻译的。同步始终采用最后翻译的版本，即使新的翻译没有被审核。

3) 在哪些Dolibarr版本中提供翻译？Transifex翻译是否也同步到维护版本？

同步总是在develop和/或beta版本上完成。因此，transifex更改会出现在其分支在Transifex更改之后创建的所有版本中（在创建新分支之前总是进行同步）。

一旦创建了一个分支，对Transifex的新更改将仅适用于下一个分支。这样做的原因是我们不管理Transifex上的分支/版本（目前还没有）。

手动翻译（不推荐）

要将Dolibarr翻译成另一种语言，请转到Langs目录，并创建一个用要翻译的语言代码命名的文件夹/目录（遵循现有格式，例如en_US, en_GB, es_ES, de_DE, 等）。然后将文件从现有的语言目录（例如en_US/main.lang, en_GB/bills.lang）复制到您刚刚创建的新语言目录中。

这些文件在每行中具有键/值对的格式，如下所示：

Code1 = translate phrase 1
Code2 = translate phrase 2
...
Coden = translate phrase n

如上所述，翻译“=”右侧的短语（键/值对的值部分），“=”左侧的代码（键部分）应保持不变。

可以逐个翻译这些文件，而不必一次就把它们全部翻译出来。

如果文件尚未被翻译成新的语言，Dolibarr将使用英语。

要将本地化（翻译）的字符串放入PHP代码中，您所要做的就是加载语言文件并使用下述方法来获取翻译后的值，如下所示：

$langs->load("myfile"); // or use $langs->load("myfile@mymodule") if myfile.lang is inside directory htdocs/mymodule/langs/xx_XX   

print $langs->trans("CodeX")

条目类型：

CodeX = phrase X

必须存在或添加到myfile.lang文件中。

使用autotranslator.php工具自动翻译

Translator OS: All
Tool: autotranslator.php 随 Dolibarr 提供，位于目录 dev/translation 下

当刚开始翻译为尚未初始化的语言时，建议使用此方法。如果已经有一个可用的翻译，但您需要添加一个丢失的键或纠正错误，请尝试使用Transifex方法（见下文）。

要创建或更新语言代码的所有文件，只需运行脚本：

php autotranslator.php lang_code_source lang_code_target GOOGLEAPIKEY

例如：

php autotranslator.php en_US pt_PT GOOGLEAPIKEY

使用英语（en_US）文件翻译成葡萄牙语（pt_PT）。

此操作将创建所有不存在的文件，并更新所有现有文件。该工具使用Google翻译服务来查找字符串的翻译值，因此需要从运行脚本的站点进行工作的Internet连接。此外，还需要GOOGLEAPIKEY，Google会收取使用此服务的费用（20欧元/1000000翻译字符）。你的PHP还必须有写入htdocs/langs目录的权限，并且必须有可用的curl函数。

此操作将创建所有不存在的文件，并更新所有现有文件。该工具使用 Google translation 翻译服务来查找字符串的翻译值，因此运行脚本的工作站点需要有Internet连接。此外，还需要GOOGLEAPIKEY，Google会收取使用此服务的费用（20欧元/1 000 000翻译字符）。你的PHP还必须有写入htdocs/langs目录的权限，并且必须有可用的curl函数。

将你的翻译分发或纳入到核心源代码中

一旦你开始翻译，分享它将是一个明智的决定，因为它可以被包含在Dolibarr的官方代码中。如果您保留它，当添加新术语或修改以前的术语时，其他人将无法改进它，并且您仍然必须自己管理翻译。

如果你是通过Transifex系统翻译的，那就没什么可做的了。您的翻译将被包含在Dolibarr的下一个版本中。没有额外的工作！从技术上讲，翻译将从Transifex导出，并由我们的开发人员导入Dolibarr，每月至少一次。

但是，如果您直接在Dolibarr文件中进行翻译，则必须首先将这些翻译传输到Transifex，然后才能将其包含在内。所以，真的，你应该一开始就翻译成Transifex。如果你通过Github上的Pull Request向我们发送你的翻译，很遗憾，它会被Transifex的下一次导入所覆盖，所以它的生命周期将是非常短暂的。

注意事项：

参考语言是en_US，并且其内容始终是完整的。您可以在htdocs/langs/en_US/文件夹中找到它。所有其他语言文件都可能是轻微或高度不完整的，具体取决于语言。

如果你正在开发一个新的模块，你可能需要添加新的语言变量。这完全通过更新en_US语言（htdocs/langs/en_US/文件夹）完成。只需修改这些文件以添加所需的变量，并将生成的文件夹作为Pull Request的一部分发送。请参阅开发人员文档以了解如何贡献代码（您需要在 https://github.com/Dolibarr/dolibarr 上创建一个帐户）。

翻译Wiki上的文档

wiki是用3种语言写成的：英语、法语和西班牙语。

如果你想增强这些语言中的一种语言的文档，你所要做的就是在wiki上创建一个帐户。

然后，您可以编辑现有的页面来纠正错误的翻译或翻译等待翻译的页面 Category:Page_waiting_for_translation。

如何翻译现有页面？

为翻译版本创建一个新页面。

首先为翻译后的版本创建一个新页面。为此，您可以访问一个不存在的URL：例如 https://wiki.dolibarr.org/index.php/Ma_nouvelle_page_en_français

选择的翻译版本的页面标题应该是原始英语页面标题的翻译。