Snippの翻訳

Snippはコミュニティによって翻訳されており、ぜひあなたの協力をお願いします。他の言語が堪能であれば、既存の翻訳を改善したり、Snippを新しい言語に対応させる手助けができます。このガイドでは必要なことをすべて説明します。

特典

  • 有意義な貢献をすると、Snippのプロフィールに限定の翻訳者バッジが付与されます。

  • あわせて、Discordサーバーで翻訳者ロールも付与されます。

  • 多大な貢献をした方には、感謝のしるしとしてSnipp PLUSが付与される場合があります。

はじめに

最初に訪れるのに最適な場所は、私たちの Discordサーバー です。ここで翻訳者が連携し、言語を担当し、サポートを受けています。作業が重複しないよう、どの言語に取り組みたいかをお知らせください。

翻訳の2つの方法

翻訳に貢献する方法は2つあります。自分に合った方を選んでください。両方を使う必要はありません。

Crowdin

最も簡単な方法です。JSONやGitの知識は不要で、ブラウザー上で直接翻訳できます。Crowdinは各テキストを文脈とともに表示し、書式設定も代わりに処理してくれます。ほとんどの翻訳者におすすめです。

Crowdinを開く

GitHub

Gitに慣れている開発者向けです。言語のJSONファイルを直接編集してプルリクエストを作成します。完全な制御が必要な場合や、新しい言語を追加する場合に最適です。

リポジトリを開く

ファイルの仕組み

各ロケールはフラットなJSONファイルです。キーは安定したIDであり、変更されることはありません。値はユーザーに表示されるテキストで、翻訳するのはこれだけです。

{
  "SETTINGS_PREFS_AUTO_COMPRESSION_LABEL": "Automatic Compression",
  "SETTINGS_PREFS_PARTY_MODE_LABEL": "Party Mode"
}

英語のファイルが信頼できる情報源です。他のすべてのロケールはまったく同じキーのセットを持っているため、変更するのは値だけです。

ルール

  • キーの追加、削除、名前の変更は決してしないでください。新しいキーはSnippのコードベースから追加されます。あなたのロケールでキーが欠けている場合、サイトは英語にフォールバックします。

  • プレースホルダーは同一に保ってください。{count}や{username}のようなテキストは実行時に置き換えられます。まったく同じプレースホルダーを保持してください。ただし、あなたの言語の語順に合わせて移動させることはできます。

  • 大文字小文字の規則に従ってください。短いUIラベルはどの言語でもTitle Caseを使用します。完全な文は、あなたの言語の通常の文のスタイルを使用します。

  • ブランド名や技術用語は翻訳しないでください。Snipp、Discord、ShareX、URL、API、PLUS、およびファイル拡張子はそのままにしてください。

  • 有効なJSONを保ってください。二重引用符を使用し、最後の項目を除く各項目の後にカンマを付け、末尾のカンマは付けないでください。

  • 値の先頭や末尾にスペースがある場合は、それを残してください。これは意図的なもので、文をつなぐために使用されています。

GitHubでの提出

GitHubの方法を選んだ場合の流れは次のとおりです。Crowdinの翻訳者はこのセクションを飛ばして構いません。変更はCrowdin内から提出されます。

翻訳は、標準的なフォークとプルリクエストの流れで GitHubのi18nリポジトリ を通じて提出されます。

  • リポジトリをフォークし、フォークをクローンして、変更用の新しいブランチを作成します。

  • あなたの言語のロケールファイルを編集し、改善したい値を翻訳します。

  • リポジトリのルートから検証スクリプトを実行し、提出前に報告された問題をすべて修正します。

  • コミットしてフォークにプッシュし、メインブランチに対するプルリクエストを作成します。メンテナーがレビューしてマージします。

コマンドラインを使いたくない場合は、GitHubのウェブエディターも利用できます。ロケールファイルを開き、鉛筆アイコンをクリックして編集し、変更を提案してください。

新しい言語の追加

Snippがまだあなたの言語に対応していませんか。GitHubで言語とそのロケールコードを提案するイシューを作成し、英語のソースファイルを出発点としてコピーし、すべての値を翻訳して、プルリクエストを作成してください。メンテナーがサイトに新しいロケールを登録します。

協力する準備はできましたか?

Discordサーバーに参加して、言語を担当し、他の翻訳者と出会い、始めましょう。

その他の記事