README_ja.md

English

Batch Translator

Batch Translator はテキストファイルを翻訳する CLI ツールです。 想定する主な利用者は、README やドキュメントを翻訳する必要のある OSS 開発プロジェクトメンバーです。 主な使用方法は以下の通りです。

• 1 つのファイルの翻訳 (README.md など)
• ディレクトリ以下の特定の拡張子を持ったファイルの一括翻訳 (AsciiDoctorを使ったドキュメントなど)

利用者向け

実行環境

Batch Translator を実行するには以下のソフトウェアが必要です。

• Java 11+
• Maven 3.6+ (Maven Plugin として使用する場合)

使用方法

Batch Translator は Java コマンド、または Maven Plugin として実行します。

1. [API Key の作成](#API Key の作成)
2. [Java コマンドで実行](Java コマンドで実行) or [Maven Plugin として実行](Maven Plugin として実行)

API Key の作成

Batch Translator は翻訳エンジンに「みんなの自動翻訳＠TexTra®」を使用しています。翻訳機能を使用するには以下のサイトでアカウントを作成してください。

https://mt-auto-minhon-mlt.ucri.jgn-x.jp/

アカウントを作成したら設定ページにあるユーザー ID、API KEY、API SECRET を sit-at.properties ファイルに保存します。

sit-at.properties ファイルはユーザーホームディレクトリ以下に.sitoolkit という名前のディレクトリを作成し、そこに保存してください。

• Windows

mkdir %USERPROFILE%\.sitoolkit
notepad %USERPROFILE%\.sitoolkit\sit-bt.properties

• macOs

mkdir ~/.sitoolkit
nano ~/.sitoolkit/sit-bt.properties

• sit-at.properties

api_key=your_api_key
api_secret=your_api_secret
name=your_user_name

Java コマンドで実行

curl -o sit-bt-core-0.9.jar https://repo1.maven.org/maven2/io/sitoolkit/bt/sit-bt-core/0.9/sit-bt-core-0.9.jar

java -jar sit-bt-core-0.9.jar -m Mode target

例 1) README_ja.md を日本語から英語に翻訳し README.md に出力するコマンド

java -jar sit-bt-core-0.9.jar -m ja2en README_ja.md:README.md

例 2) docs ディレクトリ以下の拡張子が adoc である全ファイルを日本語から英語に翻訳し、docs/en ディレクトリに出力するコマンド

java -jar sit-bt-core-0.9.jar -m ja2en -p *.adoc docs:docs/en

Maven Plugin として実行

pom.xml に Batch Traslator の Maven Plugin を追加します。

• pom.xml

<bulid>
  <plugins>
    <plugin>
        <groupId>io.sitoolkit.bt</groupId>
        <artifactId>sit-bt-maven-plugin</artifactId>
        <version>0.8</version>
    </plugin>
  </plugins>
</build>

mvn sit-bt:translate -Dmode=ja2en -Dtarget=README_ja.md:README.md

バグ報告、機能要望

Batch Translator に関するバグや機能要望がある場合は当 GitHub プロジェクトの Issues に Issue を起票してください。

ライセンス

Batch Translator は Apache Lisence 2.0 で公開しています。