Skip to main content
ドキュメントへの更新が頻繁に発行されており、このページの翻訳はまだ行われている場合があります。最新情報については、英語版のドキュメントをご覧ください。
 

 

GitHub Pagesのクイックスタート

この記事では、次の項目が扱われます。

GitHub Pagesを使って、オープンソースプロジェクトを紹介したり、ブログをホストしたり、履歴書を共有することさえもできます。 このガイドは、次のWebサイトを作成し始めるための役に立ちます。

GitHub Pagesは、GitHub Free及びOrganizationのGitHub Freeのパブリックリポジトリ、GitHub Pro、GitHub Team、GitHub Enterprise Cloud、GitHub Enterprise Serverのパブリック及びプライベートリポジトリで利用できます。 詳細については、「GitHub's products」を参照してください。

はじめに

GitHub Pagesは、GitHubを通じてホストされ、公開されるパブリックなWebページです。 立ち上げて実行するための最速の方法は、Jekyll テーマ選択画面を使って事前作成されたテーマをロードすることです。 その後、GitHub Pagesのコンテンツやスタイルを変更できます。

このガイドでは、username.github.io でのユーザー サイトの作成手順について説明します。

Webサイトの作成

  1. ページの右上隅で、[] ドロップダウン メニューを使用して、 [新しいリポジトリ] を選択します。 新しいリポジトリを作成するオプションがあるドロップダウン

  2. リポジトリ名として username.github.io を入力します。 username を GitHub のユーザー名に置き換えます。 たとえば、ユーザー名が octocat の場合、リポジトリ名を octocat.github.io とする必要があります。 リポジトリ名フィールド 1. リポジトリ名の下の [ 設定] をクリックします。 リポジトリの設定ボタン

  3. In the "Code and automation" section of the sidebar, click Pages.

  4. [ビルドとデプロイ] の [ソース] で、 [ソースからのデプロイ] を選択します。

  5. [ビルドとデプロイ] の [ブランチ] で、 [なし] または [ブランチ] ドロップダウン メニューを使用し、公開元を選択します。

    公開ソースを選択するドロップダウン メニュー

  6. 必要に応じて、リポジトリの README.md ファイルを開きます。 README.md ファイルは、サイトのコンテンツを記述する場所です。 このファイルを編集することも、あるいはとりあえずデフォルトの内容をそのままにしておくこともできます。

  7. username.github.io にアクセスして新しい Web サイトをご覧ください。 注: サイトに対する変更は、その変更を GitHub にプッシュしてから公開されるまでに、最大 10 分かかることがあります。

タイトルと説明の変更

既定では、サイトのタイトルは username.github.io になります。 リポジトリ内の _config.yml ファイルを編集することで、タイトルを変更できます。 サイトの説明を追加することもできます。

  1. リポジトリの [Code](コード) タブをクリックします。

  2. ファイルの一覧で、_config.yml をクリックしてファイルを開きます。

  3. をクリックしてファイルを編集してください。

  4. _config.yml ファイルには、サイトのテーマを指定する行が既に含まれています。 新しい行を追加し、title: に続けて必要なタイトルを記載します。 新しい行を追加し、description: に続けて必要な説明を記載します。 次に例を示します。

    theme: jekyll-theme-minimal
title: Octocat's homepage
description: Bookmark this to keep an eye on my project updates!

  5. ファイルの編集が完了したら、 [Commit changes](変更のコミット) をクリックします。

次の手順

サイトにページを追加する方法の詳細については、「Jekyll を使用して GitHub Pages サイトにコンテンツを追加する」を参照してください。

Jekyll で GitHub Pages サイトを設定する方法の詳細については、「GitHub ページと Jekyll について」を参照してください。