インストールして使用する

Windows ではまず git bash をインストールします

windowsシステム。まずここをクリックしてgit bashダウンロードしてインストールしてください。

後続の操作はgit bashで実行します。

インストール

bash <(curl -sS https://i.i18n.site) i18

翻訳トークンを構成する

クリックしてトークンをコピーしてi18n.site/token

~/.config/i18n.site.yml作成し、コピーした内容を貼り付けます。内容は次のとおりです。

token: YOUR_API_TOKEN

i18n.site/payBill 、支払いにはクレジット カードをバインドする必要があります (リチャージは必要ありません。Web サイトは使用量に応じて料金を自動的に差し引きます。価格についてはホームページを参照してください)。

使用

デモプロジェクト

i18翻訳の構成については、デモ プロジェクトを参照してくださいgithub.com/i18n-site/demo.i18

中国のユーザーはクローンを作成できますatomgit.com/i18n/demo.i18

クローン作成後、ディレクトリに入り、 i18実行して変換を完了します。

ディレクトリ構造

テンプレートウェアハウスのディレクトリ構造は次のとおりです。

┌── .i18n
│  └── conf.yml
└── en
   ├── _IgnoreDemoFile.md
   ├── i18n.yml
   └── README.md

enディレクトリ内の翻訳済みデモ ファイルは単なる例なので、削除しても問題ありません。

翻訳を実行する

ディレクトリに入り、 i18実行して翻訳します。

翻訳に加えて、プログラムは.i18n/dataフォルダーも生成します。それをリポジトリに追加してください。

新しいファイルを変換した後、このディレクトリに新しいデータ ファイルが生成されるので、必ずgit add . を追加してください。

設定ファイル

.i18n/conf.yml i18コマンドライン変換ツールの設定ファイルです

内容は以下の通りです。

i18n:
  fromTo:
    en: zh ja ko de fr
    # en:

ignore:
  - _*

ソース&翻訳言語

設定ファイルでは、 fromToの下位は次のようになります。

enはソース言語、 zh ja ko de fr翻訳のターゲット言語です。

言語コードを参照してくださいi18n.site/i18/LANG_CODE

たとえば、中国語を英語に翻訳したい場合は、この行zh: enを書き換えます。

サポートされているすべての言語に翻訳したい場合は、 :後ろを空白のままにしてください。例えば

i18n:
  fromTo:
    en:

異なるサブディレクトリに対して異なるfromToを設定できます/デモは次のように記述されます:

i18n:
  fromTo:
    en:
  path:
    blog:
      fromTo:
        zh:
    blog/your_file_name.md:
      fromTo:
        ja:

この構成テーブルでは、カタログblogの翻訳のソース言語はzh 、カタログblog/your_file_name.mdの翻訳のソース言語はjaです。

多言語画像/リンク

画像内の URL とreplace:およびMarkDownのリンク (および埋め込みHTMLのsrcおよびhref属性) がこのプレフィックスを使用して.i18n/conf.ymlに設定されている場合、URL 内のソース言語コードは翻訳の言語コード ( languageコードリスト）。

たとえば、構成は次のようになります。

i18n:
  fromTo:
    fr: ko de en zh zh-TW uk ru ja
  replace:
    https://fcdoc.github.io/img/ : ko de uk>ru zh-TW>zh >en

replace: は辞書、キーは置換される URL プレフィックス、値は置換ルールです。

上記のルールko de uk>ru zh-TW>zh >enを置き換える意味は、 ko de独自の言語コードのピクチャを使用し、 zh-TWとzh zhのピクチャを使用し、 uk ruのピクチャを使用し、他の言語 ( jaなど) はピクチャを使用します。デフォルトではenです。

たとえば、 MarkDownのフランス語 ( fr ) ソース ファイルは次のようになります:

![xx](//i18n-img.github.io/fr/1.avif)
<video src="https://i18n-img.github.io/fr/1.mp4"></video>
[xx](//i18n-img.github.io/fr/README.md)
<a style="color:red" href="https://i18n-img.github.io/fr/i18n.site.gz">xx</a>

翻訳され生成された英語 ( en ) ファイルは次のとおりです:

![xx](//i18n-img.github.io/en/1.avif)
<video src="https://i18n-img.github.io/en/1.mp4"></video>
[xx](//i18n-img.github.io/en/README.md)
<a style="color:red" href="https://i18n-img.github.io/en/i18n.site.gz">xx</a>

ここでは、ソース言語コードの/en/ターゲット言語の/zh/に置き換えられます。

注: URL 内の置換テキストの言語コードの前後には/が必要です。

[!TIP] url:に- /が設定されている場合、相対パスのみが照合され、 //で始まる URL は照合されません。

ドメイン名の一部のリンクを置換する必要があり、一部のリンクを置換したくない場合は、 [x](//x.com/en/)や[x](//x.com/en/)などの異なるプレフィックスを使用してそれらを区別できます。

ファイルを無視する

デフォルトでは、ソース言語ディレクトリ内の.mdと.ymlで始まるすべてのファイルが翻訳されます。

特定のファイル (未完成の下書きなど) を無視して翻訳しない場合は、 ignoreフィールドを使用して設定できます。

ignore .gitignoreファイルとglobset構文を使用します。

たとえば、上記の設定ファイルの_* 、 _で始まるファイルは翻訳されないことを意味します。

翻訳ルール

翻訳編集者は行を追加または削除してはなりません

翻訳は編集可能です。元のテキストを変更して再度機械翻訳すると、翻訳に対する手動の変更は上書きされません (元のテキストのこの段落が変更されていない場合)。

[!WARN] 翻訳文と原文の行は 1 対 1 に対応している必要があります。つまり、翻訳をコンパイルするときに行を追加または削除しないでください。そうしないと、翻訳編集キャッシュで混乱が生じます。

何か問題が発生した場合は、 FAQ で解決策を参照してください。

YAML翻訳

コマンド ライン ツールは、ソース言語ファイル ディレクトリ内で.ymlで終わるすべてのファイルを検索し、翻訳します。

このツールは、辞書キーではなく、 .ymlの辞書値のみを変換します。

たとえばi18n/en/i18n.yml

apiToken: API Token
defaultToken: Default Token

i18n/zh/i18n.ymlとして変換されます

apiToken: 接口令牌
defaultToken: 默认令牌

YAMLの変換は手動で変更することもできます (ただし、変換内のキーや行を追加または削除しないでください)。

YAML翻訳に基づいて、さまざまなプログラミング言語に対応する国際的なソリューションを簡単に構築できます。

高度な使用法

翻訳サブディレクトリ

.i18n/conf.ymlが作成されている限り (毎回デモ プロジェクト テンプレートから開始する必要はありません)、 i18問題なく動作します。

コマンド ライン ツールは、すべてのサブディレクトリで.i18n/conf.yml構成を見つけて変換します。

monorepoアーキテクチャを使用するプロジェクトでは、言語ファイルをサブディレクトリに分割できます。

カスタムインストールディレクトリ

デフォルトでは/usr/local/binにインストールされます。

/usr/local/bin書き込み権限がない場合は、 ~/.binにインストールされます。

環境変数TOを設定すると、インストール ディレクトリを定義できます (例: :

TO=/bin sudo bash <(curl -sS https://i.i18n.site) i18