この記事は公開されてから7年経過しています。現在とは内容が異なる場合がありますのでご注意ください。
最新の記事や関連記事をお探しの方は下の「サイト内検索」で検索してみてください。
最新の記事や関連記事をお探しの方は下の「サイト内検索」で検索してみてください。
FuelPHP の日本語ドキュメントの翻訳について私のよくやる手順をちょっとまとめてみました。
万人向けではないと思いますが、参考になれば。
ちなみに、 github 上だけで fork → 編集 → PullRequest することもできます。
こちらについては以下のページをご覧ください。
- FuelPHP の日本語ドキュメントを 5分で修正する
http://d.hatena.ne.jp/Kenji_s/20130117/edit_fuel_docs - github でドキュメント日本語化
http://ounziw.com/2011/12/01/github-localize/
では、ここからは私がよくやる方法をご紹介します。
1. まだ fork してないなら、github の画面で NEKOGET さんのリポジトリから fork する
もし fork していたらこの手順は skip。
https://github.com/NEKOGET/FuelPHP_docs_jp のページを開いて、画像の赤枠のところですね。
で、fork したら自分のリポジトリの画面になりますので、右下の方にある SSH clone URL のテキストフィールドの内容をコピーしておきます。
- fork したリポジトリをローカルに clone する
|
1 2 3 4 5 6 7 8 9 |
$ git clone git@github.com:torut/FuelPHP_docs_jp.git Initialized empty Git repository in /home/torut/git/FuelPHP_docs_jp/.git/ remote: Counting objects: 13500, done. remote: Compressing objects: 100% (6629/6629), done. remote: Total 13500 (delta 6660), reused 13500 (delta 6660) Receiving objects: 100% (13500/13500), 6.66 MiB | 1.72 MiB/s, done. Resolving deltas: 100% (6660/6660), done. $ cd ./FuelPHP_docs_jp/ |
- clone したローカルリポジトリに NEKOGET さんのリポジトリを参照先として追加する
|
1 |
$ git remote add nekoget git@github.com:NEKOGET/FuelPHP_docs_jp.git |
- 追加した NEKOGET さんのリポジトリから fetch してくる
これは以前に fork した時から増えたリポジトリを取得するためで、1 の手順で fork したばかりなら不要。
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 |
$ git fetch nekoget remote: Counting objects: 4113, done. remote: Compressing objects: 100% (2432/2432), done. remote: Total 4113 (delta 1920), reused 3797 (delta 1631) Receiving objects: 100% (4113/4113), 2.88 MiB | 961 KiB/s, done. Resolving deltas: 100% (1920/1920), done. From github.com:NEKOGET/FuelPHP_docs_jp * [new branch] 1.0/develop -> nekoget/1.0/develop * [new branch] 1.0/master -> nekoget/1.0/master * [new branch] 1.1/develop -> nekoget/1.1/develop * [new branch] 1.1/develop_japanese -> nekoget/1.1/develop_japanese * [new branch] 1.1/master -> nekoget/1.1/master * [new branch] 1.1/master_japanese -> nekoget/1.1/master_japanese * [new branch] 1.2/develop -> nekoget/1.2/develop * [new branch] 1.2/develop_japanese -> nekoget/1.2/develop_japanese * [new branch] 1.3/develop -> nekoget/1.3/develop * [new branch] 1.3/develop_japanese -> nekoget/1.3/develop_japanese * [new branch] 1.4/develop -> nekoget/1.4/develop * [new branch] 1.4/develop_japanese -> nekoget/1.4/develop_japanese * [new branch] 1.5/develop -> nekoget/1.5/develop * [new branch] 1.5/develop_japanese -> nekoget/1.5/develop_japanese * [new branch] 1.6/develop -> nekoget/1.6/develop * [new branch] 1.6/develop_japanese -> nekoget/1.6/develop_japanese * [new branch] 1.7/develop -> nekoget/1.7/develop * [new branch] 1.7/develop_japanese -> nekoget/1.7/develop_japanese * [new branch] 1.8/develop -> nekoget/1.8/develop * [new branch] 1.8/develop_japanese -> nekoget/1.8/develop_japanese |
- NEKOGET さんのリポジトリの 1.8/develop_japanese ブランチからローカルにブランチを作成
|
1 2 3 4 5 |
$ git branch 1.8/develop_japanese nekoget/1.8/develop_japanese Branch 1.8/develop_japanese set up to track remote branch 1.8/develop_japanese from nekoget. $ git checkout 1.8/develop_japanese Switched to branch '1.8/develop_japanese' |
- 変更するためのブランチを作成
|
1 2 |
$ git checkout -b translation-orm_model_soft-1.8 1.8/develop_japanese Switched to a new branch 'translation-orm_model_soft-1.8' |
tips: checkout コマンドに -b オプションをつけることで次の2つを同時におこなったことになる
|
1 2 |
$ git branch translation-orm_model_soft 1.8/develop_japanese $ git checkout translation-orm_model_soft |
- 何かしら変更してコミット
|
1 2 3 4 5 6 |
$ emacs packages/orm/model/soft.html $ git ad -u $ git ci -m'translation orm/model/soft.html' [translation-orm_model_soft-1.8 348dc29] translation orm/model/soft.html 1 files changed, 8 insertions(+), 8 deletions(-) |
- コミットしたローカルブランチを自分の github のリポジトリに push する
push する時の第1引数を origin として自分のリポジトリへの push だと指定する。
|
1 2 3 4 5 6 7 8 |
$ git push -u origin translation-orm_model_soft-1.8 Counting objects: 4414, done. Compressing objects: 100% (2118/2118), done. Writing objects: 100% (4064/4064), 1.77 MiB, done. Total 4064 (delta 2287), reused 3672 (delta 1899) To git@github.com:torut/FuelPHP_docs_jp.git * [new branch] translation-orm_model_soft-1.8 -> translation-orm_model_soft-1.8 Branch translation-orm_model_soft-1.8 set up to track remote branch translation-orm_model_soft-1.8 from origin. |
- github の画面から PullRequest を行う
-
PullRequest が取り込まれたら NEKOGET さんのブランチを pull する
|
1 2 3 4 5 6 7 8 9 10 11 |
$ git checkout 1.8/develop_japanese $ git pull nekoget 1.8/develop_japanese remote: Counting objects: 1, done. remote: Total 1 (delta 0), reused 1 (delta 0) Unpacking objects: 100% (1/1), done. From github.com:NEKOGET/FuelPHP_docs_jp * branch 1.8/develop_japanese -> FETCH_HEAD Updating 22a939b..864f98e Fast-forward packages/orm/model/soft.html | 16 ++++++++-------- 1 files changed, 8 insertions(+), 8 deletions(-) |
- pull したのを自分の github のリポジトリに push する
|
1 2 3 4 5 6 7 |
$ git push -u origin 1.8/develop_japanese Counting objects: 1, done. Writing objects: 100% (1/1), 270 bytes, done. Total 1 (delta 0), reused 0 (delta 0) To git@github.com:torut/FuelPHP_docs_jp.git * [new branch] 1.8/develop_japanese -> 1.8/develop_japanese Branch 1.8/develop_japanese set up to track remote branch 1.8/develop_japanese from origin. |
ここで -u オプションを指定するとこのローカルブランチのデフォルト push 先を origin に指定できるので、次回以降の push は次のように簡単になります。
|
1 |
$ git push |
さぁ、あなたもぜひ FuelPHP ドキュメント日本語化 に参加しませんか？
翻訳に関するコミュニケーションは、以下の Google グループにて行われています。
https://groups.google.com/group/fuelphp_jp?hl=ja
翻訳作業に参加される方は、ご参加ください。