From 7d9dd08625f86ce5b3525a97ce9594707fcfa834 Mon Sep 17 00:00:00 2001 From: SI Date: Mon, 24 Feb 2020 18:12:18 +0900 Subject: [PATCH] Elaborate ## Repositories --- README_ja.md | 42 ++++++++++++++++++++++++++---------------- 1 file changed, 26 insertions(+), 16 deletions(-) diff --git a/README_ja.md b/README_ja.md index e852138..35a083f 100644 --- a/README_ja.md +++ b/README_ja.md @@ -149,9 +149,9 @@ ## リポジトリ -### ローカルリポジトリを初期化したい +### ローカルリポジトリを初期設定したい -既存のディレクトリを Git リポジトリとして初期化するには、次を実行します： +既存のディレクトリを Git リポジトリとして初期設定するには、次を実行します。 ```sh (my-folder) $ git init @@ -159,7 +159,7 @@ ### リモートリポジトリをクローンしたい -リモートリポジトリをクローン（コピー）したいときは、リポジトリの URL をコピーし、次を実行します： +リモートリポジトリをクローン（コピー）したいときは、リポジトリの URL をコピーし、次を実行します。 ```sh $ git clone [url] @@ -168,7 +168,7 @@ $ git clone [url] すると、リモートリポジトリと同名のフォルダにリポジトリの内容が保存されます。 リモートリポジトリのあるサーバに接続できる必要があります。大抵の場合インターネット接続があれば大丈夫です。 -リモートリポジトリと異なる名前のフォルダにクローンしたいときは、次のようにします： +リモートリポジトリと異なる名前のフォルダにクローンしたいときは、次のようにします。 ```sh $ git clone [url] name-of-new-folder @@ -180,23 +180,29 @@ $ git clone [url] name-of-new-folder 間違ったリポジトリをクローンしてしまったときは、`git clone` で作ったディレクトリを削除して、正しいリポジトリをクローンし直せばよいです。 -間違ったリポジトリを既存のローカルリポジトリの origin に設定してしまったときは、次のように origin の URL を変更しましょう： +間違ったリポジトリを既存のローカルリポジトリの origin に設定してしまったときは、次のように origin の URL を変更しましょう。 ```sh $ git remote set-url origin [url of the actual repo] ``` -ほかの問題の場合は、[この StackOverflow トピック](https://stackoverflow.com/questions/2432764/how-to-change-the-uri-url-for-a-remote-git-repository#2432799)を参照してみてください。 +ほかの問題は[この StackOverflow トピック](https://stackoverflow.com/questions/2432764/how-to-change-the-uri-url-for-a-remote-git-repository#2432799)を参照してください。 ### 他の人のリポジトリにコードを書き加えたい -Git では、アクセス権がないと他の人のリポジトリに書き込むことはできません。GitHub は Git リポジトリのホスティングサービスであって Git 自体とは異なるものですが、GitHub でもやはり同様です。しかし、パッチによってコードを提案することができます。GitHub ならフォークとプルリクエストの機能がこれにあたります。 +Git では、アクセス権がないかぎり他の人のリポジトリに書き込むことはできません。 +GitHub は Git リポジトリのホスティングサービスであって Git 自体とは異なるものですが、GitHub でもやはり同様です。 +しかし、パッチでコードを提案することができます。 +GitHub ならフォークとプルリクエストの機能がこれにあたります。 -まずはフォークについて説明しましょう。フォークはリポジトリのコピーです。Git 自体の機能ではないものの、GitHub, BitBucket, GitLab やその他のホスティングサービスにはこの機能があり、各サービスの UI を通して実行できます。 +まずはフォークについて説明しましょう。 +フォークはリポジトリのコピーです。 +Git 自体の機能ではないものの、GitHub, BitBucket, GitLab やその他のホスティングサービスにはこの機能があり、各サービスの UI を通して実行できます。 #### プルリクエストでコードを提案するには -リポジトリをフォークしたら、ローカルマシンにクローンして編集しましょう。ちょっとした編集なら GitHub 上でもできるでしょうが、この文書は GitHub フライトルールではないので、ローカルで編集する方法を説明します。 +リポジトリをフォークしたら、ローカルマシンにクローンして編集しましょう。 +ちょっとした編集なら GitHub 上でもできるでしょうが、この文書は GitHub フライトルールではないので、ローカルで編集する方法を説明します。 ```sh # ssh を使う場合 @@ -206,10 +212,12 @@ $ git clone git@github.com:k88hudson/git-flight-rules.git $ git clone https://github.com/k88hudson/git-flight-rules.git ``` -できたディレクトリに `cd` で移動し、`git remote` を実行してください。リモートのリストが表示されるはずです。 +できたディレクトリに `cd` で移動し、`git remote` を実行してください。 +リモートのリストが表示されるはずです。 ただ、おそらく表示されるのは `k88hudson/git-flight-rules` を参照する `origin` だけなので、自分がフォークして作った方のリモートも用意する必要があります。 -Git では、自分自身のリポジトリのリモートには `origin`、フォークした元のリポジトリは `upstream` と名付けるのが一般的です。これにならって、まず、リモート `origin` の名前を `upstream` に変更しましょう： +Git では、自分自身のリポジトリのリモートは `origin`、フォークした元のリポジトリには `upstream` と名付けるのが一般的です。 +これにならって、まず、リモート `origin` の名前を `upstream` に変更しましょう。 ```sh $ git remote rename origin upstream @@ -223,7 +231,7 @@ $ git remote rename origin upstream $ git remote add origin git@github.com:YourName/git-flight-rules.git ``` -この時点でリモートは二つです： +この時点でリモートは二つです。 - `origin` は自分のリポジトリを参照しています。 - `upstream` は元のリポジトリを参照しています。 @@ -231,14 +239,15 @@ $ git remote add origin git@github.com:YourName/git-flight-rules.git `origin` は読み取り・書き込みの両方ができ、`upstream` は読み取り専用です。 編集が済んだら、編集内容を（通常はブランチ内から）リモート `origin` にプッシュしましょう。 -ブランチ内にいる場合、次のように `--set-upstream` を使うと、次回から同じブランチからプッシュする際にリモートを指定せずに済みます： +ブランチ内にいる場合、次のように `--set-upstream` を使うと、次回から同じブランチからプッシュする際にリモートを指定せずに済みます。 ```sh $ (feature/my-feature) git push --set-upstream origin feature/my-feature ``` Git で CLI からプルリクエストを送る方法はありません（[hub](http://github.com/github/hub) のようなツールを使えば別ですが）。 -プルリクエストを送りたいときは、GitHub（あるいは他のホスティングサービス）上でプルリクエストを作成してください。元のリポジトリとフォークしたリポジトリを関連付けるのはホスティングサービスが自動的にしてくれます。 +プルリクエストを送りたいときは、GitHub（あるいは他のホスティングサービス）上でプルリクエストを作成してください。 +元のリポジトリとフォークしたリポジトリの紐付けはホスティングサービスが自動的にしてくれます。 プルリクエストの後、コードレビューのフィードバックに対応するのを忘れないようにしましょう。 @@ -248,14 +257,15 @@ Git で CLI からプルリクエストを送る方法はありません（[hub] 自分だけでなく他の人も共同作業していることを忘れないようにしてください。 自分のフィーチャーブランチにいて、これを元のリポジトリに合わせて更新したい場合を想定します。 -元のプロジェクトを参照するリモートは設定してありますか？　まだなら今やってしまいましょう。通常はリモートの名前に `upstream` を使います： +元のプロジェクトを参照するリモートは設定してありますか？　まだなら今やってしまいましょう。 +通常はリモートの名前に `upstream` を使います。 ```sh $ (master) git remote add upstream # $ (master) git remote add upstream git@github.com:k88hudson/git-flight-rules.git ``` -これで `upstream` から最新版をフェッチできるようになりました。 +これで `upstream` から最新版を取得できるようになりました。 ```sh $ (master) git fetch upstream