###序章

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がこのリポジトリを取得してアカウントにコピーとして追加するのを確認します。 これで、メインの俳句リポジトリの「フォーク」であるこのリポジトリの作成者としてあなたの名前が表示されます。

Clone the repository

次に、コマンドラインインターフェイスに移動して、ローカルマシンにプロジェクトのクローンを作成します。これは、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の選択方法に関するアドバイスを確認することを検討してください。

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

Browse the Codebase

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

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

  1. git add .

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

  1. git add sammyhaiku.md

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

  1. git status

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

Git Add

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

git commit -m "added sammy haiku"

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

Git Commit

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

  1. git push

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

Git Push

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

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

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

Submit a PR

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

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

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

#結論

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

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

Video: How to Submit Your First PR

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