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の製品」を参照してください。

はじめに

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. "Build and deployment(ビルドとデプロイ)"の下の"Source(ソース)"の下で、Deploy from a branch(ブランチからデプロイ)を選択してください。

  6. "Build and deployment(ビルドとデプロイ)"の下の"Branch(ブランチ)"の下で、None(無し)もしくはBranch(ブランチ)ドロップダウンメニューを使って公開ソースを選択してください。

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

  7. あるいは、リポジトリのREADME.mdファイルを開いてください。 README.mdファイルは、サイトの内容を書くところです。 このファイルを編集することも、あるいはとりあえずデフォルトの内容をそのままにしておくこともできます。

  8. 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 PagesとJekyllについて」を参照してください。