GitHub Pagesのクイックスタート

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

この機能を使用できるユーザーについて

GitHub Pagesは、パブリック・リポジトリのGitHub Freeと組織用のGitHub Free、パブリック・リポジトリとプライベート・リポジトリのGitHub Pro、GitHub Team、GitHub Enterprise Cloud、GitHub Enterprise Serverで利用できます。

この記事の内容

はじめに

このガイドでは、<username>.github.io にユーザーサイトを作成します。

Webサイトの作成

ページの右上隅でを選択し、 [新しいリポジトリ] をクリックします。
リポジトリ名として username.github.io を入力します。 username を GitHub のユーザー名に置き換えます。たとえば、ユーザー名が octocat の場合、リポジトリ名を octocat.github.io とする必要があります。
リポジトリの可視性を選択してください。詳しくは、「リポジトリについて」をご覧ください。
[Initialize this repository with a README] (このレポジトリを README で初期化する) を選択します。
[Create repository] (リポジトリの作成) をクリックします。
リポジトリ名の下にある [Settings] をクリックします。 [設定] タブが表示されない場合は、 [] ドロップダウンメニューを選び、 [設定] をクリックします。
サイドバーの [Code and automation] セクションで、[ Pages] をクリックします。
[ビルドとデプロイ] の [ソース] で、 [ソースからのデプロイ] を選択します。
[ビルドとデプロイ] の [ブランチ] で、[ブランチ] ドロップダウンメニューを使って、公開元を選びます。
必要に応じて、リポジトリの README.md ファイルを開きます。 README.md ファイルは、サイトのコンテンツを記述する場所です。このファイルを編集することも、あるいはとりあえずデフォルトの内容をそのままにしておくこともできます。
username.github.io にアクセスして新しい Web サイトをご覧ください。サイトに対する変更は、その変更を GitHub にプッシュしてから公開されるまで、最大 10 分かかることがあることに注意してください。

タイトルと説明の変更

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

リポジトリの Code タブをクリックします。
ファイルの一覧で、_config.yml をクリックしてファイルを開きます。
をクリックしてファイルを編集してください。
_config.yml ファイルには、サイトのテーマを指定する行が既に含まれています。新しい行を追加し、title: に続けて必要なタイトルを記載します。新しい行を追加し、description: に続けて必要な説明を記載します。次に例を示します。
```
theme: jekyll-theme-minimal
title: Octocat's homepage
description: Bookmark this to keep an eye on my project updates!
```
ファイルの編集を終えたら、[Commit changes] をクリックします。

次のステップ

初めての GitHub Pages Web サイトの作成、カスタマイズ、発行は無事に済みましたが、調べることはまだたくさんあります。 GitHub Pages で次のステップに進むのに役立つリソースがいくつかあります。

Jekyll を使用して GitHub Pages サイトにコンテンツを追加する: このガイドでは、サイトにページを追加する方法が説明されています。