Skip to content

Latest commit

 

History

History
177 lines (104 loc) · 6.44 KB

README.zh.md

File metadata and controls

177 lines (104 loc) · 6.44 KB

DocumentationGem VersionBuild StatusCode Climate

Translatomatic

将文本文件从一种语言翻译成另一种语言,或从一种格式翻译成另一种格式。 目前支持以下文件格式:

文件格式 扩展
属性 .properties
Windows资源文件 .resw, .resx
属性列表 (OSX plist) .plist
PO文件 .po, .pot
XCode字符串 .strings
YAML .yaml
字幕 .srt, .ass, .ssa
HTML .html, .htm, .shtml
XML .xml
降价 .md
文本文件 .txt
CSV文件 .csv

以下译文提供方可与Translatomatic一起使用:

翻译后的字符串保存在数据库中并重新使用。


##安装

将此行添加到您的应用程序的 Gemfile

ruby gem 'translatomatic'

然后执行:

$ bundle

或者自己安装:

$ gem install translatomatic

##用法

这个宝石提供了一个可执行文件 translatomatic。 该 translatomatic 命令有许多功能,并不是所有这些功能都记录在这里。 有关可用命令和选项的帮助,请执行:

$ translatomatic help

为了帮助一个命令,执行:

$ translatomatic translate help
$ translatomatic translate help file

## 建立

检查可用的翻译供应商和选项 providers 命令:

$ translatomatic providers

可以在命令行,环境变量或translatomatic的配置文件中指定选项。 配置文件可以使用translatomatic的内部进行修改 config 命令。 要列出所有可用的配置设置,请使用:

$ translatomatic config list
$ translatomatic config describe

可以在用户级别或项目级别设置选项。 有关更多信息,另请参阅下面的配置部分。


##翻译文件

翻译文件时, translatomatic 一次翻译文本一个句子或短语。 如果文件被重新翻译,那么只有自上次翻译以来发生了变化的句子才会被发送到翻译提供者,其余的来自本地数据库。

要使用Google提供程序将Java属性文件翻译成德语和法语:

$ translatomatic translate file --provider Google strings.properties de,fr

这将创建(或覆盖) strings_de.propertiesstrings_fr.properties 与翻译的属性。

显示资源包中的字符串

阅读并显示 store.descriptionstore.name 英文,德文和法文本地资源文件的属性:

$ translatomatic display --locales=en,de,fr \
    resources/strings.properties store.description store.name

从源文件中提取字符串

从源文件中提取字符串,使用 strings 命令,例如

$ translatomatic strings file.rb

##转换文件

Translatomatic可用于将文件从一种格式转换为另一种格式。 例如,要将Java属性文件转换为XCode字符串文件:

$ translatomatic convert strings.properties Localization.strings

##配置

配置设置可以使用 config getconfig set 命令。 Translatomatic使用一个用户配置文件 $HOME/.translatomatic/config.yml,以及可选的每个项目配置文件 $PROJECT_DIR/.translatomatic/config.yml

--user--project 选项可以用来告诉命令读取或写入 user 要么 project 组态。

配置设置是从环境变量,用户配置文件,项目配置文件(如果存在)以及从命令行中读取的。 找到的最后一个值优先于先前读取的值。

在写入配置时使用 config set 命令,则在包含translatomatic配置文件的项目中执行时,将新值写入项目配置文件,如果没有项目配置文件,则将新值写入用户配置文件。

翻译配置示例

设置 google_api_key 在用户配置文件中,使用:

$ translatomatic config set google_api_key value --user

要设置一个或多个翻译服务使用:

$ translatomatic config set provider Microsoft,Yandex

要设置目标区域设置的默认列表:

$ translatomatic config set target_locales en,de,es,fr,it

target_locales 设置,可以在不指定目标语言环境的情况下转换文件 translate file 命令。

$ translatomatic translate file resources/strings.properties

要显示当前配置,请执行:

$ translatomatic config list

数据库配置

默认, translatomatic 在中使用一个sqlite3数据库 $HOME/.translatomatic/translatomatic.sqlite3 存储翻译的字符串。 数据库配置可以通过创建一个 database.yml 文件下 $HOME/.translatomatic/database.yml 为了 production 环境,例如

production:
  adapter: mysql2
  host: db.example.com
  database: translatomatic
  pool: 5
  encoding: utf8
  collation: utf8_bin
  username: username
  password: password

##贡献

https://github.com/smugglys/translatomatic的GitHub上欢迎Bug报告和请求。 这个项目的目的是成为一个安全的,欢迎的合作空间,贡献者有望坚持 贡献者盟约 行为守则。


## 执照

这个宝石可以按照开源的条款来使用 MIT许可证


## 行为守则

每个人都与Translatomatic项目的代码库,问题跟踪器,聊天室和邮件列表进行交互,预计将遵循 行为守则

由 Translatomatic 0.1.3 Tue, 06 Feb 2018 22:18:34 +1030 https://github.com/smugglys/translatomatic