ドキュメント用のローカル Git リポジトリの設定
この記事では、アドビのドキュメントにコントリビューションするためにローカルマシン上に Git リポジトリを設定する手順について説明します。 コントリビューターは、ローカルに作成したクローンのリポジトリを使用して、新規記事の追加、既存記事に対する大きな編集、アートワークの変更をおこなうことができます。
概要
アドビのドキュメントにコントリビューションするには、読み取り／書き込み権限を取得するために、適切なリポジトリを自身の GitHub アカウントにフォークします。 その後、対応するドキュメントリポジトリのクローンを作成して、ローカルで Markdown ファイルを作成および編集することができます。 作業が終わったら、プルリクエストを使用して、変更を中央の読み取り専用共有リポジトリに結合（提出）します。
- 適切なリポジトリを特定
- リポジトリを自身の GitHub アカウントにフォーク
- クローンファイルを格納するローカルフォルダーを選択
- ローカルマシンにリポジトリのクローンを作成
- upstream リモートの値を設定
リポジトリを特定
適切なリポジトリを独自の GitHub アカウントにフォークすると、提案した変更を保存するための読み取り/書き込み権限が付与されます。Adobe Experience Cloud ドキュメントは、github.com の複数の異なるリポジトリに存在します。
- 作業対象となるリポジトリがわからない場合は、Web ブラウザーで目的の記事にアクセスします。 記事の右上にある 編集 リンク（鉛筆アイコン）を選択します （Edit リンクが表示されない場合は、そのコンテンツはまだ GitHub 上にありません）。
アドビのドキュメントにコントリビューションするには、対応するドキュメントリポジトリのクローンを作成して、Markdown ファイルをローカルで作成および編集します。 作業が終わったら、プルリクエストを使用して、変更を中央の読み取り専用共有リポジトリに結合します。
リポジトリをフォーク
適切なリポジトリを使用し、そのリポジトリを GitHub の Web サイトから自身の GitHub アカウントにフォークします。
個人用のフォークが必要になるのは、メインのドキュメントリポジトリはいずれも読み取り専用で、リポジトリのコンテンツを直接変更することはできないからです。 コンテンツを変更するには、フォークからメインリポジトリへのプルリクエスト（PR）を提出しなければなりません。 このプロセスを進めるために、まずリポジトリの作業用コピーを作成して、書き込みアクセスを可能にする必要があります。 そのために、GitHub の フォーク を使用します。
-
メインリポジトリの GitHub ページに移動して、右上の「Fork」ボタンをクリックします。
-
フォークの作成先を指定するよう求められたら、自分の GitHub アカウントのタイルを選択します。 これにより、自分の GitHub アカウント内にリポジトリのコピー（フォーク）が作成されます。
-
覚えやすく、入力しやすいフォルダー名を選択します。
サイズが大きいリポジトリもあるので、 十分なディスク容量のある場所を選択するようにします。
note NOTE 別の Git リポジトリのフォルダーの下層にあるローカルフォルダーパスは選択しないでください。 Git のクローンフォルダー同士を同じ階層に並べることは問題ありませんが、他の Git フォルダーの下層に配置した場合はファイルのトラッキングでエラーが発生します。
リポジトリのローカルクローンを作成
フォークされたリポジトリのクローンを作成することで、自分のコンピューターにファイルのコピーをダウンロードできます。 編集が終わったら、編集内容をローカルドライブからサーバー上のフォークされたリポジトリにプッシュできます。 その後、プルリクエストを提出して、upstream のメインリポジトリに編集を結合できます。
以下の手順では、GitHub Desktop の使用を想定しています。 別のクライアントを使用している場合は、適宜読み替えてください。
-
「Clone or download」をクリックし、「Open in Desktop」を選択すると、リポジトリのコピー（フォーク）がコンピューターの現在のディレクトリにプルされます。
-
ローカルファイルとフォークされたリポジトリの同期を保つには、GitHub Desktop を使用します。
詳しくは、GitHub Desktop のドキュメントを参照してください。