Difference between revisions of "翻译文档"

Revision as of 22:39, 30 November 2019

[[:]] [[:]] [[:]] [[= Translate documentation on wiki=]] Dolibarr language files are already translated in several languages.: English is the default and always complete. Other languages depend on contributions. This tutorial can help you complete a translation for a language not yet available or somehow incorrect.: Dolibarr can be translated by three different means: #Manually using Transifex (Official and recommended method).: #Manually editing language files: #Completely automatic: autotranslator ==Manual Translation using Transifex online service (recommended)==: Transifex is a web application that provides an online platform for translation projects. It includes teams and discussion tools, translation memory, glossary, proofreading and a lot of other features.: It is quite easy to use and all translations can be uploaded and downloaded through the web interface or using their TX client from a terminal.: Transifex is an open source project and the "community edition" can be freely downloaded and installed, but we will use the online hosted service.: ===Using the web interface (for translators)===: If you want to help to translate Dolibarr in your own language, check the project's page at https://www.transifex.com/dolibarr-association/dolibarr/ You can then register an account and request joining the project team for the language(s) you're targeting. A manager will have to accept your request, so please be patient.: Once accepted, you can start translating right away.: For more information, please check Transifex "Getting Started" introduction at http://docs.transifex.com/introduction/translators/ and the web editor tutorial at http ''' Note about en_US ''': The web interface can not be used to translate the en_US language which is source.: Any change for en_US language must be done in Dolibarr source code and submitted using a Pull Request on our GitHub repository.: [[===Using TX command line client (for Dolibarr Category This describes how to use Transifex from the command line. However, this is reserved to Dolibarr admin users to synchronize Transifex with Dolibarr main sources.: [[More information can also be found on the Transifex Official documentation] ====TX Client configuration====: First install TX Client.: With Debian/Ubuntu/Mint:

[[

:]]
[[apt-get install python-pip:]]
[[pip install transifex-client:]]
[[

:]]

Then you have to initialize your TX environment. This is done by running '''tx init''' into dolibarr project root directory.: cd git/dolibarr: tx init: Accept to overwrite config file. Keep default value for Transifex instance, then enter your Transifex login and password.: After this, a .transifexrc has been created into your HOME dir and a generic config file has been created as '''.tx/config''' in project's root.: So your directory's contents will look like that:

[[

:]]
[[.:]]
[[|-- 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:]]
[[

:]]

The current config file can be downloaded from https://github.com/Dolibarr/dolibarr/tree/develop/.tx , put it into .tx directory, overwriting the one created by '''tx init''' This project configuration file is used to store the project’s details and the file-to-resource mappings.: That is a sample of what the config file contains:

[[

:]]
[[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:]]
[[Here is an explanation of the sections and options used in the config file:]]
[[<nowiki>[main] section</nowiki>:]]
[[In this section, we have project-wide options, such as the default transifex host for all projects. These can be overridden by each resource, in case it is needed.:]]
[[<nowiki>[dolibarr.resource]</nowiki>:]]
[[source_lang: this is the source language of the resource.<br />]]
[[source_file: this points to the source file directly.<br />]]
[[file_filter: here we hold the expression used to identify translation files under the specific project. ''not mandatory''<br />]]
[[trans.<lang>: this is used for translation files that don’t follow a common naming schema and the file expression cannot be used to track them. ''not mandatory''<br />]]
[[host: in case the project doesn’t use the default Transifex server as specified in the [main] section, it can override it using this option. ''not mandatory''<br />]]
[[====TX Client use====:]]
[[Some useful information on '''tx''' commands.:]]
[['''tx status''':]]
[[Show status of translations:]]
[['''tx push''':]]
[[Used to push changes from your computer to Transifex server<br>:]]
[[Additional options for the tx push command are:]]
[[-h - Shows the help screen for the command:]]
[[-l <lang> - Specify which translations you want to push (defaults to all):]]
[[-r <resource> - Specify the resource for which you want to push the translations (defaults to all):]]
[[-f - Push source files without checking modification times:]]
[[--skip - Don't stop on errors. Useful when pushing many files concurrently.:]]
[[-s - Push the source file to the server:]]
[[-t - Push the translation files to the server:]]
[[--no-interactive - Don't require user input when forcing a push</pre></code>:]]
[['''tx pull''':]]
[[Used to pull changes from Transifex server to your computer<br />:]]
[[Additional options for the tx pull command are:]]
[[-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 the server (even new ones):]]
[[-s - Force the fetching of the source file (default: False)]]
[[-f - Force download of translations files:]]
[[--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.</pre></code>:]]
[['''Examples''':]]
[[To pull translation files, you can use:]]
[[tx -d pull -l it_IT  # Get italian language only:]]
[[tx -d pull -a   # Get all languages:]]
[[To push source files, just type:]]
[[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:]]
[[===Other questions on transifex process===:]]
[[This is short questions and answers you may also ask about transifex translation process:]]
[[1) Is the sync on a regular time interval?:]]
[[No. It is done where there is enough translation submitted. It is also done on a beta branch just before creating the final release package.:]]
[[ :]]
[[2) Are all the translations synced to git or only the reviewed translations? Do I need to review before sync is done?:]]
[[When a Sync is done, transifex files overwrites files into git, but only if there is at least on record modified for the file. :]]
[[You don't have to make a review before sync is done. Making review is above all to know which lines were manually reviewed and which one was initially translated using a robot.:]]
[[3) In which Dolibarr releases will translations be available? Are transifex translations also synced to maintenance releases?:]]
[[Sync is always done on develop and/or beta.:]]
[[So transifex changes appear in all version whose branch is created after the transifex change (a sync is always done before creating a new branch). Once a branch is created, the new changes into transifex will be available only for the next branch. The reason for this is that transifex is not able to manage branch/versions (not yet).:]]
[[==Manual Translation (not recommended)==:]]
[[To translate Dolibarr into another language, go to the langs directory and create a folder/directory named with the code language to translate (follow the existing format, for example en_US, en_GB, es_ES, de_DE, etc...). Then copy the files from an existing language directory (for example en_US/main.lang, en_GB/bills.lang), into the new language directory that you have just created.:]]
[[These files have the format of key/value pairs in each line like the followings:]]
[[Code1 = translate phrase 1:]]
[[Code2 = translate phrase 2:]]
[[...:]]
[[Coden = translate phrase n:]]
[[Translate the phrases (the value portion of the key/value pairs) on the right side of the "=" as seen above, the code (the key portion) on the left side of "=" should remain unchanged. It is possible to translate the files one by one, without bringing them all at once. If a file has not been translated into the new language, Dolibarr uses English.:]]
[[To have a localised (translated) string into the PHP code, all you have to do is load the language file and use the method to get the translated value, like this:]]
[[<source lang="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"):]]
[[An entry type;:]]
[[CodeX = phrase X:]]
[[must be present or added to the myfile.lang file.:]]
[[==Automatic Translation with autotranslator.php tool==:]]
[[*Translator OS: All]]
[[*Tool: '''autotranslator.php''' provided with Dolibarr in directory '''dev/translation'''.]]
[[This method is recommended when starting translation for a language not already initialized. If there is already a translation available but you need to add a missing key or correct errors, try to use method using Transifex (see later).:]]
[[To make or update all files of a language code, just run the script:]]
[[php autotranslator.php lang_code_source lang_code_target GOOGLEAPIKEY:]]
[[For example :]]
[[php autotranslator.php en_US pt_PT GOOGLEAPIKEY:]]
[[to translate into Portuguese (pt_PT) using English (en_US) files.:]]
[[All nonexisting files will be created, all existing files will be updated.:]]
[[The tool use [http://translate.google.com Google translation] service to find the translation value of a string, so a working Internet connection is required from station running the script. Also, a GOOGLEAPIKEY is required and Google charges a fee for using this service (20 euros / 1 000 000 of translated chars).]]
[[Your PHP must also have permissions to write into '''htdocs/langs''' directory and must have curl functions available.:]]
[[Once you start translating, it's a smart decision to share it, so it can be included in the official code of Dolibarr.:]]
[[If you keep it for you, others will not be able to improve it when new terms are added or previous terms are modified, and you will still have to manage the translation on your own.:]]
[[If you translated through the Transifex system, there's nothing to be done. Your translation will be included in the next version of Dolibarr. No additional work! In technical terms, the translation will be exported from Transifex and imported into Dolibarr by our developers, at least once every month.:]]
[[If, however, you translated directly in Dolibarr files, then you will first have to transfer those translations to Transifex before they can be included. So, really, you should start translating into Transifex.:]]
[[If you send us your translation through a Pull Request on Github, sadly, it will be overwritten by the next import from Transifex, so it would be very short-lived.:]]
[[Note:]]
[[The reference language is en_US and is always complete. You can find it in the htdocs/langs/en_US/ folder. All other language files are likely to be slightly or highly incomplete, depending on the language.:]]
[[If you are developing a new module, you are likely going to need the addition of new language variables. This is done exclusively through the update of the en_US language (htdocs/langs/en_US/ folder). Just modify these files to add the variable you need and send the resulting folder as part of your Pull Request. Refer to the developer documentation to learn how to contribute code (you will need an account on {{TemplateUrlSCM}}.:]]
[[The wiki is written in 3 languages: English, French, and Spanish.]]
[[If you want to enhance documentation on one of these languages, all you have to do is to create an account on this wiki.:]]
[[Then, you can edit existing pages to correct a bad translation or translate pages waiting for translation [[:Category]]
[[<br />:]]
[[=== How to translate an existing page ? ===:]]
[[==== Create a new page for the translated version. ====:]]
[[Start by creating a new page for the translated version. To do this, you can access an non existant URL : for example [[Translator documentation|<code>https]]
[[The chosen title for the translated version of the page should be the translation of the title of the original English page.:]]
[[==== Linking your new page to the original English page. ====:]]
[[To add a link to your newly created page on the original English page, you must edit it using the '''Edit wikicode''' (not the visual editor).:]]
[[On the top of the page, search for a block that look like :]]
[[<source>:]]
[[<!-- BEGIN origin interlang links -->:]]
[[<!-- You can edit this section but do NOT remove these comments:]]
[[     Links below will be automatically replicated on translated pages by PolyglotBot --> :]]
<!-- END interlang links -->

<seo metak="translation, documentation, translator, localize, localization, i18n, internationalization, language" />
{{Template用户手册}}
{{TemplateMainPageZh}}

= [[File:Language.png]] 翻译 Dolibarr =

Dolibarr语言文件已经用几种语言翻译了。
英语是默认的语言会首先完成翻译。其他语言依赖于自愿者的贡献。 本教程帮助您完成一个未译的或错译的语言。
Dolibarr可以用三种不同的方式翻译：

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

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

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

===使用Web界面（译者）===
如果你想用自己的语言帮助翻译Dolibarr，请检查项目的页面。 https://www.transifex.com/dolibarr-association/dolibarr/

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

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

欲了解更多信息，请检查Transifex“入门”介绍规范 http://docs.transifex.com/introduction/translators/ 和网络编辑器向导于 http://docs.transifex.com/tutorials/txeditor/

===='''备注关于 en_US'''====
Web界面不能用来翻译源代码的en_US语言。

任何更改都必须在Dolibarr源代码中完成，并在GitHub存储库上使用Pull请求提交。

=== 使用TX 命令行客户端 (for Dolibarr [[:Category:Yoda]] team) ===
这描述了如何从命令行中使用Transifex。然而，这是保留给Dolibarr管理员用户，以同步Transifex与Dolibarr主源码。

[http://docs.transifex.com/developer/client/ 官方文档]

====TX 客户端设置====
安装 TX 客户端
使用 Debian/Ubuntu/Mint:
<source lang="bash">
apt-get install python-pip
pip install transifex-client

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

cd git/dolibarr
tx init

接受改写配置文件。保持Transifex实例的默认值，然后输入您的Transifex登录和密码。

在此之后，一个.transifexrc已经创建到您的主页目录，并且一个通用配置文件被创建于项目根目录中的.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: this is the source language of the resource.
source_file: this points to the source file directly.
file_filter: here we hold the expression used to identify translation files under the specific project. not mandatory
trans.<lang>: this is used for translation files that don’t follow a common naming schema and the file expression cannot be used to track them. not mandatory
host: in case the project doesn’t use the default Transifex server as specified in the [main] section, it can override it using this option. not mandatory

TX 客户端使用

tx 命令有用的信息。

tx status

显示翻译状态

tx push

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

TX推送命令的其他选项是：

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

tx pull

用于从Transifex服务器将更改拉到您的计算机上
TX拉动命令的其他选项是：

-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 翻译也与维护版本同步?

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

一旦创建了一个分支，那么新的过渡到transifex将只适用于下一个分支。这是因为transifex无法管理分支/版本（还没有）。

手动翻译（不推荐）

要将DoiBARR翻译成另一种语言，请转到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 provided with Dolibarr in directory dev/translation.

This method is recommended when starting translation for a language not already initialized. If there is already a translation available but you need to add missing key or correct errors, try to use method using Transifex (see later).

To make or update all files of a language code, just run the script:

php autotranslator.php lang_code_source lang_code_target GOOGLEAPIKEY

For example :

php autotranslator.php en_US pt_PT GOOGLEAPIKEY

to translate into Portuguese (pt_PT) using English (en_US) files.

All non existing files will be created, all existing files will be updated. The tool use Google translation service to find the translation value of a string, so a working Internet connection is required from station running the script. Also a GOOGLEAPIKEY is required and Google charges a fee for using this service (20 euros / 1 000 000 of translated chars). Your PHP must also have permissions to write into htdocs/langs directory and must have curl functions available.

将你的翻译分发到核心资源中

Once you start translating, it's a smart decision to share it, so it can be included into the official code of Dolibarr. If you keep it for you, others will not be able to improve it when new terms are added or previous terms are modified, and you will still have to manage the translation on your own.

If you translated through the Transifex system, there's nothing to be done. Your translation will be included in the next version of Dolibarr. No additional work! In technical terms, the translation will be exported from Transifex and imported into Dolibarr by our developers, at least once every month.

If, however, you translated directly in Dolibarr files, then you will first have to transfer those translations to Transifex before they can be included. So, really, you should start translating into Transifex. If you send us your translation through a Pull Request on Github, sadly, it will be overwritten by the next import from Transifex, so it would be very short-lived.

Note:

The reference language is en_US and is always complete. You can find it in the htdocs/langs/en_US/ folder. All other language files are likely to be slightly or highly incomplete, depending on the language.

If you are developing a new module, you are likely going to need the addition of new language variables. This is done exclusively through the update of the en_US language (htdocs/langs/en_US/ folder). Just modify these files to add the variable you need and send the resulting folder as part of your Pull Request. Refer to the developer documentation to learn how to contribute code (you will need an account on https://github.com/Dolibarr/dolibarr.

翻译Wiki文档

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

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

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