ガバナンス

leji.org はどのように翻訳されているか

AI エージェントの支援による翻訳です。内容に相違がある場合は、英語版ページが優先されます。文章に問題を見つけた際は、Issueまたはプルリクエストをお願いします。

leji.org は英語で書かれ、言語ごとに翻訳されています。このページには、2 つの版に違いがある場合に何が優先されるか、翻訳がどのように作られるか、その用語が何を参照しているか、そして誤りをどう報告するかを記します。

英語版ページが正本

すべてのページは、まず英語で書かれます。翻訳されたページはその英語ページの翻訳であり、そのことをタイトルの下に明記します。両者に違いがある場合は、英語の文が優先されます。仕様の翻訳は参考訳です。規範的なテキストは凍結された 1.0 系列の英語であり、翻訳された仕様ページにはその旨のバナーが付きます。

翻訳の作り方

ページはエージェントを活用したワークフローで下書きし、公開前にページ単位で承認します。下書きに関与していない 2 つの独立したレビュー用エンジンが、英語への忠実さ、その言語の用語集に照らした用語、そして読みやすさを確認し、両方が一致したときにだけ公開されます。

用語

各言語は、Leji が使う用語の用語集を持っています。ある用語に、よく知られたオープンソースプロジェクトの人手による翻訳で定着した訳語がある場合、用語集はそれに従うか、理由を添えて例外を記録します。これらの参照は手がかりであって、典拠ではありません。以下の一覧は、それらのプロジェクトの翻訳が現れたり失われたりするのに合わせて更新します。

簡体字中国語

日本語

ブラジルポルトガル語

スペイン語

ベトナム語

最新に保つ

翻訳されたページはいずれも、どの版の英語原文に従っているかを記録しています。ビルドのたびに実行されるチェックが、原文から遅れている翻訳があればそのビルドを失敗させるため、公開された翻訳が、その翻訳元の英語より古いことはありません。この版の情報は記録されるだけで、表示はされません。

誤りの報告

翻訳されたページには、タイトルの下に 2 つのリンクがあります。ひとつは、言語とページがあらかじめ入力された状態で Issue を作成するもの、もうひとつは、そのページ自身のソースファイルを開いてプルリクエストを送るためのものです。1 ページ版の仕様ビューだけは例外です。ひとつの文書ではなく複数の文書から組み立てられているため、Issue へのリンクは冒頭のバナーに置かれ、編集リンクは各文書の見出しの横に置かれます。修正はほかの変更と同じようにレビューされ、次のリリースで反映されます。

翻訳しないもの

コマンド名、フラグ、パス、JSON のキー、コードサンプルは英語のままです。コードサンプルの中のコメントは翻訳します。JSON Schema のファイル自体と、生の markdown のルートも英語のままです。