Learn/Tools_and_testing/GitHub を新規翻訳 (#218)

2021/01/22時点の英語版に基づいて新規翻訳

1 files changed, 92 insertions, 0 deletions

diff --git a/files/ja/learn/tools_and_testing/github/index.html b/files/ja/learn/tools_and_testing/github/index.html
new file mode 100644
index 0000000000..ab060c4eea
--- /dev/null
+++ b/files/ja/learn/tools_and_testing/github/index.html
@@ -0,0 +1,92 @@
+---
+title: Git と GitHub
+slug: Learn/Tools_and_testing/GitHub
+tags:
+  - Beginner
+  - GitHub
+  - Learn
+  - Web
+  - git
+---
+<div>{{LearnSidebar}}</div>
+
+<p class="summary">すべての開発者が、何らかの<strong>バージョン管理システム</strong> (<strong>VCS</strong>) を使用しています。これは、他の開発者との共同作業において、お互いの作業を上書きする危険がなく、また、後で問題が発見された場合には以前のバージョンのコードベースにロールバックすることができるツールです。 (少なくともウェブ開発者の間では) 最も人気のある VCS は <strong>Git</strong> であり、 <strong>GitHub</strong> はリポジトリのホスティングとそれを操作するためのいくつかのツールを提供するサイトです。このモジュールは、この2つについて知っておくべきことを紹介することを目的としています。</p>
+
+<h2 id="Overview">概要</h2>
+
+<p>VCS は本質的に、ソフトウェア開発のためのものです。</p>
+
+<ul>
+ <li>完全に自分一人でプロジェクトに取り組むことは稀で、他の人と一緒に作業を始めるとすぐに、二人が同時に同じコードを更新しようとする場合、互いの作業が衝突する危険性が出てきます。このような事態を回避するためには、何らかの仕組みを用意しておく必要があり、それが結果的に仕事のロスを避けるのに役立ちます。</li>
+ <li>一人で、あるいは他の人と一緒にプロジェクトを進める際には、コンピューターが壊れてもコードが失われないように、中央にバックアップできるようにしておきたいものです。</li>
+ <li>また、後で問題が発見された場合には、以前のバージョンにロールバックできるようにしておきたいものです。同じファイルの異なるバージョン、例えば <code>myCode.js</code>, <code>myCode_v2.js</code>, <code>myCode_v3.js</code>, <code>myCode_final.js</code>, <code>myCode_really_really_final.js</code> のようなものを作成して、自分の仕事でこれを始めているかもしれませんが、これは実にエラーが起こりやすく、信頼性に欠けます。</li>
+ <li>チームのメンバーは、それぞれ別のバージョンのコード (Git では<strong>ブランチ</strong>と呼びます) を作成し、そのバージョンで新機能の開発を行い、作業が終わったら制御された方法 (GitHub では<strong>プルリクエストを使用します</strong>) でマスターバージョンにマージしたいと考えるのが一般的です。</li>
+</ul>
+
+<p>VCS は、上記のニーズを満たすツールを提供します。 <a href="https://git-scm.com/">Git</a> は VCS の一例であり、 <a href="https://github.com/">GitHub</a> は Git サーバーに加えて、コードの問題点の報告、レビューツール、タスクの割り当てやタスクの状態管理などのプロジェクト管理機能など、個人やチームで git リポジトリを扱うための実に便利なツールを提供するウェブサイト＋インフラです。</p>
+
+<div class="notecard note">
+<p><strong>注</strong>: Git は実際には<em>分散</em>バージョン管理システムです。つまり、コードベースを含むリポジトリの完全なコピーが、自分のコンピュータ (そして他の全員のコンピュータ) に作られます。自分のコピーに変更を加え、その変更をサーバーにプッシュします。サーバーでは、管理者があなたの変更をマスターコピーにマージするかどうかを決定します。</p>
+</div>
+
+<div class="callout">
+  <h4 id="Looking_to_become_a_front-end_web_developer">フロントエンドのウェブ開発者を目指している方</h4>
+
+  <p>あなたが目標に向かって頑張るために必要なすべての必要な情報を含むコースをまとめました。</p>
+
+  <p><a class="button primary" href="/ja/docs/Learn/Front-end_web_developer">始めましょう</a>
+  </p>
+</div>
+
+<h2 id="Prerequisites">前提条件</h2>
+
+<p>Git と GitHub を使用するには、以下のものが必要です。</p>
+
+<ul>
+ <li>Git がインストールされたデスクトップコンピューター (<a href="https://git-scm.com/downloads">Git のダウンロードページ</a>を参照)。</li>
+ <li>Git を使うためのツール。仕事のやり方によっては、 <a href="https://git-scm.com/downloads/guis/">Git の GUI クライアント</a> (GitHub Desktop、SourceTree、Git Kraken などがお勧めです) を使うこともできますし、端末ウィンドウを使うこともできます。実際、 GUI を使うにしても、 Git の端末コマンドの基本だけは覚えておいたほうが役立つでしょう。</li>
+ <li><a href="https://github.com/join">GitHub アカウント</a>。まだお持ちでない場合は、このリンクからサインアップしてください。</li>
+</ul>
+
+<p>前提知識としては、このモジュールを始めるにあたり、ウェブ開発、Git/GitHub、VCS について何も知らなくても構いません。しかし、適度なコンピューターリテラシーを持ち、リポジトリに保存するためのコードがあるように、いくらかのコーディングの知識を持つことをお勧めします。</p>
+
+<p>また、ディレクトリ間の移動、ファイルの作成、システムの <code>PATH</code> の変更など、基本的な端末の知識があることが望ましいです。</p>
+
+<div class="notecard note">
+<p><strong>注</strong>: GitHub が Git で使えるサイトやツールセットとして唯一のものではありません。 GitLab のような他のツールもありますし、自分で Git サーバーを立ち上げて GitHub の代わりに使うこともできます。このコースでは、 GitHub を使った方法だけを紹介しています。</p>
+</div>
+
+<h2 id="Guides">ガイド</h2>
+
+<p>以下のリンクは、外部サイト (訳注: 多くは英語) のリソースに移動しますのでご注意ください。最終的には、 Git/GitHub に特化した独自のコースを設けることを目指していますが、現時点では、これらのサイトがこの主題を把握するのに役立つでしょう。</p>
+
+<dl>
+ <dt><a href="https://guides.github.com/activities/hello-world/">Hello, World (from GitHub)</a> (英語)</dt>
+ <dd>始めるのによいところです。 — リポジトリやブランチの作成、コミットの作成、プルリクエストの作成とマージなど、 Git の基本を学びながら、 GitHub をすぐに使い始めることができる実用的なガイドとなっています。</dd>
+ <dt><a href="https://guides.github.com/introduction/git-handbook/">Git Handbook (from GitHub)</a> (英語)</dt>
+ <dd>この Git ハンドブックでは、 VCS とは何か、リポジトリとは何か、 GitHub の基本モデルはどうなっているのか、 Git コマンドとその例など、もう少し深く掘り下げて説明しています。</dd>
+ <dt><a href="https://guides.github.com/activities/forking/">Forking Projects (from GitHub)</a> (英語)</dt>
+ <dd>誰かのコードに協力したいときには、プロジェクトをフォークすることが不可欠です。このガイドでは、その方法を説明します。</dd>
+ <dt><a href="https://docs.github.com/ja/github/collaborating-with-issues-and-pull-requests/about-pull-requests">プルリクエストについて (GitHub より)</a></dt>
+ <dd>提案されたコードの変更を、他の人のリポジトリに配信して検討してもらう方法であるプルリクエストを管理す津ための有益なガイドです。</dd>
+ <dt><a href="https://guides.github.com/features/issues/">Mastering issues (from GitHub)</a> (英語)</dt>
+ <dd>課題 (issue) とは、 GitHub プロジェクトのフォーラムのようなものです。質問をしたり問題を報告したりすることができ、そこで更新を管理することができます (たとえば、問題を修正する人を割り当てたり、問題を明確にしたり、問題が修正されたことを人々に知らせたりすることができます)。この記事では、課題について知っておくべきことを説明します。</dd>
+</dl>
+
+<div class="notecard note">
+<p><strong>注</strong>: Git や GitHub でできることは<strong>他にもたくさん</strong>ありますが、以上のことは Git を効果的に使い始めるために最低限知っておくべきことだと思います。 Git の理解が深まるにつれ、より複雑なコマンドを使い始めると簡単に間違えてしまうことに気づくでしょう。心配しないでください。プロのウェブ開発者であっても、 Git が分かりにくいと感じることがあり、ウェブ上で解決策を探したり、 <a href="https://github.com/k88hudson/git-flight-rules">Flight rules for Git</a> や <a href="https://dangitgit.com/">Dangit, git!</a> のようなサイトを参考にして問題を解決することがよくあります。</p>
+</div>
+
+<h2 id="See_also">関連情報</h2>
+
+<ul>
+ <li><a href="https://guides.github.com/introduction/flow/">Understanding the GitHub flow</a></li>
+ <li><a href="https://git-scm.com/docs">Git command list</a></li>
+ <li><a href="https://guides.github.com/features/mastering-markdown/">Mastering markdown</a> (the text format you write in on PR, issue comments, and <code>.md</code> files).</li>
+ <li><a href="https://guides.github.com/features/pages/">Getting Started with GitHub Pages</a> (デモやウェブサイトを GitHub で公開する方法).</li>
+ <li><a href="https://learngitbranching.js.org/">Learn Git branching</a></li>
+ <li><a href="https://github.com/k88hudson/git-flight-rules">Flight rules for Git</a> (Git であることを実現するための方法や、間違えた場合の修正方法など、とても有用な概説が書かれています。).</li>
+ <li>
+  <p><a href="https://dangitgit.com/">Dangit, git!</a> (もう一つの有用な概説で、特に、間違ったときに物事を修正する方法です。).</p>
+ </li>
+</ul>