このリポジトリは、Craft CMS documentation を日本語に翻訳するプロジェクトです。
本プロジェクトでは翻訳メモリソフト OmegaT を利用して作業を進めます。
OmegaT の「チーム機能」を利用するため、当リポジトリとの同期は自動で行なわれます。
OmegaT の翻訳ソースに Markdown を指定するにあたって okapiFiltersForOmegaT プラグインが必要です。
下記などを参考に、事前にプラグインをインストールしておいてください。
【天使降臨】OmegaTにOkapiプラグインを入れてXLF/XLIFFファイルを使う方法 - WSBIWSBI
http://wsbi.net/omegaT_angel
作業前に OmegaT の環境設定ダイアログで チーム を選び、名前または ID を確認してください。
ここで入力された値はコミットメッセージに Translated by {{名前または ID}} の形で挿入されるため、公開しても問題ない内容にしておきましょう。
OmegaT を起動後、メニューから プロジェクト > チームプロジェクトをダウンロード... を選択します。
チームプロジェクト ダイアログの リポジトリ URL には git@github.com:bit-part/craftcms_docs-ja.git または https://github.com/bit-part/craftcms_docs-ja.git と入力します。OmegaT のバージョンによりチームプロジェクトの Git が HTTPS 固定の場合がありますので、注意してください。
ローカルフォルダー には保存先の任意のディレクトリを指定してください。確定 ボタンをクリックすると、保存先に当リポジトリのクローンが生成されます。
2回目以降は、ローカルフォルダにある omegat.project をダブルクリックするとプロジェクトを直接開くことができます。
本家の公式リポジトリから、英語版の Markdown ファイル一式を取得します。
取得した docs/3.x ディレクトリをローカルフォルダの source/3.x ディレクトリの中に移動し、以下の変更を加えます。
source/docs/3.x/jaディレクトリに含まれるすべてのディレクトとファイルを削除source/docs/3.x/jaを新規作成source/docs/3.x/jaを除く、すべてのディレクトリとファイルをsource/docs/3.x/jaに移動
これによって、元の英文ファイルをソースとする日本語版の翻訳が可能となります。
翻訳ソースに変更を加えた場合は、メニューの プロジェクト > 再読み込み を実行し、アップデートしてください。
OmegaT でプロジェクトを開くと「翻訳対象ファイル一覧」ウィンドウが表示されます。その中から翻訳したいファイルを選択し、メインウィンドウで文節ごとの翻訳をしてください。
初めてプロジェクトを保存すると 認証 ダイアログが表示される場合がありますので、GitHub のユーザー名とパスワードを入力してください。ただし、何も変更がない場合は2回目以降の保存時となります。
OmegaT 日本語化プロジェクトの Wiki を参考にしてください。
翻訳のベースとなるドキュメントの著作権は Craft CMS 開発チームにあります。
公式リポジトリの Contributor として参加させてもらっていますので、当プロジェクトで修正された内容を確認後にコミットします。（※反映時期については、一任ください。）
翻訳にあたり意訳を含む場合があるため、本来の翻訳としては不適切な表現があるかもしれません。
誤りや気になる表現などは Issue でのフィードバックにご協力ください。
リンク URL の https://craftcms.com/docs/3.x/ をルート相対パス /docs/3.x/ja/ に変更する必要があります。
backup/db の「オプション」に含まれるリストにインデントを加える必要があります。
Toru Kokubun https://twitter.com/BUN
この README は、Perl 6ドキュメント日本語化プロジェクトの内容を参考にさせていただきました。