GitHub Pagesを使うには？

ジャンプ先:
  1. 公開コンテンツ

この翻訳は不完全です。英語から この記事を翻訳 してください。

GitHub は“ソーシャル・コーディング”のサイトです。Git バージョン管理システムのストレージに対して、ソースコードリポジトリのアップロードを許可します。その後、コードプロジェクトで共同作業を行うことができます。また、システムはオープンソースに自動設定されています。つまり、世界中の誰もがGitHubコードを検索・使用また、そこから学習しコードを改善することができます。 他の人のコードでもそれが可能です！この記事はGithubのgh-pages機能を使って、公開コンテンツに関する基本的なガイドを提供します。

公開コンテンツ

GitHubは非常に重要で役に立つコミュニティの一つで、Git / GitHubは非常に人気のあるバージョン管理システムです。現在、ほとんどのハイテク企業がワークフローでそれを使用しています。 GitHub はGitHub ページと呼ばれる非常に便利な機能を持っています。これはあなたがウェブライブでウェブサイトのコードを公開することを可能にします。

Github の基本設定

  1. 初めに、システムにGit をインストールしてください。これはGitHub が動作する基盤となるバージョン管理システムのソフトウェアです。
  2. 次に、GitHub アカウントにサインアップします。それは単純かつ簡単です。
  3. サインアップしたら、ユーザ名とパスワードを使ってgithub.com  にログインします。

ソースコードのアップロード準備

Githubリポジトリに好きなコードを保存できますが、GitHubページ機能を最大限に活用するには、コードを典型的なWebサイトとして構成する必要があります。主なエントリポイントは、index.htmlというHTMLファイルです。
 

次に進む前に、自身のコードディレクトリをGitリポジトリとして初期化する必要があります。このために、以下のことを実行してください：

１. コマンドラインでtest-site のディレクトリ（またはWebサイトを含むデ         ィレクトリと呼んだもの）を指定します。これには、cd コマンドを使用し         ます（例えば、「ディレクトリの変更」）。 Webサイトをデスクトップ             の  test-site というディレクトリに配置した場合は、次のように入力しま       す：

cd Desktop/test-site

 2. コマンドラインが、あなたのウェブサイトディレクトリの中を指していると       き、ディレクトリをgit リポジトリにそのまま変えるようにgit ツールに指         示する、次のコマンドを入力してください：

git init


コマンドラインインターフェース（CLI）

Githubにコードをアップロードする最良の方法は、コマンドラインを使用することです。これは、ユーザーインターフェイス内をクリックするというよりは、ファイルを作成・プログラム実行のような動作のためのコマンドを入力するウィンドウです。それは次のようにものです：

補足：コマンドラインに不安がある場合は、Git グラフィカルユーザーインターフェイスを使用して、同じ作業を行うことも検討できます。

全てのオペレーティングシステムには、コマンドラインツールが付属しています：
 

  • Windows：Windows のキーを押して、「コマンドプロンプト」と入力し、表示されるリストから選択すると、コマンドプロンプト にアクセスできます。Windows は、Linux やOS X とは異なる、独自のコマンド規約を持っているので、下記のコマンドは、あなたのシステムによって、異なるかもしれません。
  • OS X： ターミナルは、「アプリケーション」>「ユーティリティ」にあります。
  • Linux： 通常、「Ctrl + Alt + T」で端末を起動できます。それでもうまくいかない場合は、アプリバーまたはメニューでターミナルを探します。
     

これはに最初は、少し戸惑うかもしれませんが、心配しないでくださいー すぐに基本のコツをつかむでしょう。上記のようにコマンドを入力して、Enter キーを押すことで、端末で動作するようにコンピュータに指示します。
 

ソースコードのリポジトリの作成

  1. 次に、ファイルを保存するための新しいリポジトリを作成する必要が、あります。GitHub ホームページの右上にあるプラス（+）をクリックしてから、「新しいリポジトリ」を選択します。
  2. このページの「リポジトリ名ボックス」に、ソースコードもリポジトリ名（例：my-repository）を入力します。
  3. また、説明を入力することで、リポジトリに何を格納しようとしているのかを記述します。画面は次のようなものです：
  4. 「Create repository」をクリックします。これにより、次のページに移動します。

GitHub へのファイル格納

  1. 現在のページで、あなたはセクションに興味を持っています．．．「または、コマンドラインから既存のリポジトリをプッシュします。」このセクションに2行のコードがリストされているはずです。最初の行全体をコピーしてコマンドラインに貼り付け、Enter キーを押します。コマンドは次のようなものです： 
    git remote add origin https://github.com/chrisdavidmills/my-repository.git
  2. 次に、以下の2つのコマンドを入力し、それぞれの後にEnter キーを押します。これらはGitHub にアップロードするためのコードを用意し、Git にこれらのファイルを管理するように依頼します。 
    git add --all
git commit -m 'adding my files to my repository'
  3. 最後に、表示されている2つのコマンドの内、2番目のコマンドを端末に入力する「または、コマンドラインセクションから既存のリポジトリをプッシュして」、コードをGitHub にプッシュします： 
    git push -u origin master
  4. ここで、リポジトリのgh-pages ブランチを作成する必要があります。現在のページを更新すると、以下のようなリポジトリページが表示されます。「Branch：master」というボタンを押し、テキスト入力にgh-pages と入力してから Create branch: gh-pages という青いボタンを押す必要があります。これにより、gh-pages という特別な場所に公開されている、特別なコードブランチが作成されます。URL は、username.github.io/my-repository-name の形式を取ります。したがって、この例の場合、URLは　https://chrisdavidmills.github.io/my-repository になります。表示されているページはindex.html ページです。

 

　 5. 新しいブラウザタブで、GitHub Pages のWeb アドレスに移動すると、　            サイトがオンラインなります！友人にそれを電子メールで送って、あな              たの習熟を披露してください。

Note: 困った場合は、GitHub Pages ホームページ も大いに役立ちます。

GitHub の詳細

テストサイトにさらに変更を加えて、GitHub にアップロードしたい場合は、以前と同じようにファイルに変更を加えるだけです。それから、以下のコマンドを入力して（それぞれEnterキー を押して）GitHub にそれらの変更をプッシュする必要があります：

git add --all
git commit -m 'another commit'
git push

another commit をより適切なメッセージに置換して、今行った変更を説明できます。


私たちは、Git の表面をほとんど改修していません。詳細については、GitHub ヘルプサイト から始めてください。

ドキュメントのタグと貢献者

このページの貢献者: mdnwebdocs-bot, Suuzuukii, silverskyvicto
最終更新者: mdnwebdocs-bot,