GitHub Pagesのクイックスタート

はじめに

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

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

Webサイトの作成

1. ページの右上角で ドロップダウンメニューを使い、New repository（新規リポジトリ）を選択してください。

2. リポジトリ名としてusername.github.ioを入力してください。 usernameを自分のGitHubユーザ名で置き換えてください。 たとえば、ユーザ名がoctocatなら、リポジトリ名はoctocat.github.ioとなります。

3. リポジトリ名の下で Settings（設定）をクリックしてください。

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

5. Choose a theme（テーマの選択）をクリックしてください。

6. テーマ選択画面が開きます。 利用可能なテーマをブラウズし、Select theme（テーマの選択）をクリックしてテーマを選択してください。 後でテーマを変更することも容易なので、はっきりしない場合はとりあえずどれか1つを選択しておいてください。

7. テーマとを選択すると、ファイルエディタでREADME.mdファイルが開かれます。 README.mdファイルは、サイトの内容を書くところです。 このファイルを編集することも、あるいはとりあえずデフォルトの内容をそのままにしておくこともできます。

8. ファイルの編集が終わったら、Commit changes（変更をコミット）をクリックしてください。

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

タイトルと説明の変更

デフォルトでは、サイトのタイトルは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 PagesとJekyllについて」を参照してください。