＃＃＃序章

Hacktoberfestは、DigitalOceanによって運営され、グローバルコミュニティのすべての人に開かれた、オープンソースソフトウェアの1か月にわたるお祝いです。 参加するには、10月に4つの品質プルリクエストを公開GitHubリポジトリに送信する必要があります。 チャレンジを完了すると、Hacktoberfest限定のTシャツなどの特別賞品を獲得できます。

10月1日から10月31日まではいつでも登録できます。また、9月から始まる仮想イベントや説明会について、他の開発者やHacktoberfest愛好家とつながることをお勧めします。

このチュートリアルでは、プルリクエストの送信に使用するバージョン管理システムであるGitと、進行状況を追跡するために使用するリポジトリホスティングサービスであるGitHubを紹介します。 このチュートリアルが終了するまでに、最初のプルリクエストを送信する準備が整い、Hacktoberfestへの参加に向けて順調に進んでいます。

＃＃バージョン管理

GitとGitHubから始める前に、バージョン管理について説明しましょう。 開発者が一緒にプロジェクトに取り組む場合、多くの場合、同じコードベースで作業する必要があります。 彼らが働いている間、各開発者は、他の開発者が行った変更について知る必要があります。これは、作業を複製したり、すでに行われたことに対してコードを記述したりしないようにするためです。

バージョン管理システムは、コードの保存プログラムとして機能し、プロジェクトにバージョンを割り当て、プロジェクト内の各ファイルに加えられた変更を追跡します。 このように、開発者は最新バージョンでチェックインしてプロジェクトで共同作業を行い、プロジェクトのコードの自分の部分で作業する前に行われた変更を確認できます。

##GitとGitHub

あらゆる規模の開発者プロジェクトを管理するために使用されるバージョン管理システムであるGitは、開発者がコードを提供し、コードリビジョンを高速、効率的、かつ安価に共有できるように、Linuxの作成者であるLinusTorvaldsによって2005年に作成されました。 Gitを使用すると、開発者はコードを編集、共有、公開できるため、コラボレーションとチームワークが容易になります。

GitHubは、クラウドベースのgitリポジトリホスティングサービスであり、開発者がローカルマシンで作成したコードを取得して、世界中のユーザーと共有できるようにします。 リポジトリまたは中央のファイルストレージの場所を介して、ローカルコンピューター上のバージョン追跡プロジェクトをパブリックに共有する方法を提供します。プロジェクトの可用性（パブリックまたはプライベートリポジトリのいずれか）に応じて、その他開発者はプロジェクトをダウンロードして、コードを編集したり、洞察を提供したりできます。

GitHubの使用を開始するには、GitHubでアカウントを作成できます。 その方法の詳細については、Hacktoberfestリソースページを参照してください。

##リポジトリのクローン作成

次に、最初のGitHubリポジトリのクローンを作成して編集します。 まず、クローンを作成するリポジトリに移動しましょう。 このチュートリアルでは、CloudHaikuリポジトリを使用します。 このリポジトリのクローンを作成する前に、つまり、GitHubのコードのコピーをローカルマシンに取り込む前に、リポジトリ全体のコピーを自分のGitHubアカウントに取り込む必要があります。 これはリポジトリのフォークと呼ばれ、メインのコードベースに影響を与えることなくコードを開発できます。

リポジトリをフォークするには、をクリックします Fork リポジトリの右上にあるボタン。 クローンを作成するには、 code ボタンをクリックし、提供されたリンクのコピーを取り、GitHubがこのリポジトリを取得してアカウントにコピーとして追加するのを確認します。 これで、メインの俳句リポジトリの「フォーク」であるこのリポジトリの作成者としてあなたの名前が表示されます。

次に、コマンドラインインターフェイスに移動して、ローカルマシンにプロジェクトのクローンを作成します。 git clone コマンド。これは、haikuリポジトリから作成したフォークをローカルマシンに複製またはコピーします。 これにより、ローカルで（自分のマシン上で）コードベースに変更を加えることができます。

  1. cd ~

  2. git clone https://github.com/sammy/cloud_haiku

##コードコンテンツの編集

これで、ローカルマシンにCloud Haikuリポジトリのコピーが作成されたので、投稿を準備する準備が整いました。 コマンドラインインターフェイスを使用して、複製されたリポジトリのフォルダーに移動します。 あなたが従った場合、あなたは持っている必要があります cloud_haiku ホームディレクトリ内のフォルダ：

  1. cd ~/cloud_haiku

コードの編集に使用できるテキストエディタと統合開発環境（IDE）は多数あります。 IDEは通常、プログラミング言語によってセグメント化されており、その言語でアプリケーションを開発するプロセスを合理化するための一連の便利な機能が含まれています。 現在、作業マシン内にIDEがセットアップされていない場合は、HacktoberfestのリソースページでIDEの選択方法に関するアドバイスを確認することを検討してください。

時間をかけてプロジェクトの編成方法と貢献ガイドラインを読んで理解し、作業できるコードの部分を見つけることが重要です。 変更を加える前に、提供されている関連ドキュメントをお読みください。 次に、俳句を提出しましょう！

##リモートリポジトリへのコンテンツの追加

haikuリポジトリに変更が加えられたので、その変更を追跡して保存する必要があります。 変更を追跡する最初のステップは、作業中のバージョンに変更を追加することです。 そのために、コマンドを実行します git add . :

  1. git add .

この方法でコマンドを作成すると、リポジトリに加えられたすべての変更をファイル全体に追加できます。 個々のファイルへの変更のみを送信する必要がある場合は、 git add filename:

  1. git add sammyhaiku.md

実行後 add コマンドを実行すると、確認は得られません。 コミットする準備ができているファイルのリストに変更が含まれているかどうかを確認するには、コマンドを実行します git status:

  1. git status

これにより、追跡された変更のステータスを確認できます。ファイルが追加されたことがわかりますが、変更としてコミットされていないことがわかります。 Gitは、新しいコードまたは編集されたコードとして正式に追跡する前に変更を修正する必要がある場合に、このステップを提供します。

次に、変更をコミットしましょう。 コマンドを実行します git commit、メッセージを追加して、このプロジェクトで共同作業している他の開発者が、あなたが行った変更について知ることができるようにします。

git commit -m "added sammy haiku"

メッセージを使用してコミットを作成すると、開発者に変更内容を通知できます。このメッセージは、コミットIDとユーザー名とともに追跡されます。

コミットした後、私たちはする必要があります push ローカルマシンからGitHubのリモートリポジトリに変更します。 これを行うには、コマンドを実行してみましょう git push:

  1. git push

ここで、プッシュの発信元を指定できます。この場合、貢献はDigitalOceanの俳句リポジトリのフォークバージョンに送られます。

要約すると、これまでに編集したいリポジトリを特定し、リポジトリのコピーをGitHubアカウントとローカルマシンに取得しました。 fork と clone. 変更を加え、変更を送信しました git add. 次に、実行して変更を固めました git commit、変更をコミットしました。 git push 変更をローカルマシンからGitHubのリモートリポジトリにプッシュしました。 GitHubを見ると、行った変更がhaikuリポジトリのコピー内のファイルに反映されていることがわかります。

##プルリクエストの作成

これで、プロジェクトのメンテナに、自信を持って送信する準備ができているリポジトリへの変更があることを通知する準備が整いました。 これを行うには、右側のプルリクエストボタンをクリックします。

プルリクエストボタンをクリックすると、新しいページが開き、行った変更を説明するフォームが表示され、加えられた変更が既存のコンテンツと競合するかどうかが示されます。 変更の詳細を示す適切なタイトルを追加し、説明に、行われた変更とその理由の説明を追加します。 ここで追加する内容はプロジェクトによって異なる場合があります。プロジェクトのコラボレーションガイドラインを確認して、プルリクエストが正しくフォーマットされていることを確認してください。

加えられた変更のタイトルと説明を追加した後、プルリクエストページをスキャンして、コミットされた変更がコードリポジトリに加えられた既存の変更と競合しないことを確認します。 すべてがチェックアウトされると、下部に緑色の送信プルリクエストボタンが表示され、元の俳句コードベースに変更を加えるリクエストがエスカレートされます。このボタンは、そのメインを表示しているすべての人に公開されます。ブランチ。 しばらくお待ちください—メンテナがリクエストを確認するのに時間がかかる場合があります。 プルリクエストページに修正とコメントを追加でき、同じ影響を受けるファイルに対して行われた新しいコミットがリクエストの履歴に表示されます。

おめでとうございます-最初のプルリクエストを正常に送信しました。

＃結論

このチュートリアルでは、GitとGitHubについて学び、変更を正常に識別してパブリックリポジトリに送信しました。 Hacktoberfestの場合、4つの意味のあるプルリクエストを送信する必要があるので、もう一度、あなたと共鳴し、ハッキングを楽しんでいるプロジェクトを見つけてください！

このチュートリアルの動作を確認するために、最初のプルリクエストを送信するプロセスを説明する役立つビデオを次に示します。

Hacktoberfestの詳細については、メインページをご覧ください。 Gitの詳細については、 Gitの使用方法：リファレンスガイドをご覧ください。 GitHubの詳細については、GitHubをご覧ください。 。