記事のバージョン: Enterprise Server 2.17
Jekyll を使用して GitHub Pages サイトを作成する
新規または既存のリポジトリ内に、GitHub Pages Jekyll を使用してサイトを作成できます。
GitHub Pagesは、GitHub Free 及びGitHub FreeのOrganizationではパブリックリポジトリでのみ使用でき、GitHub Pro、GitHub Team、GitHub Enterprise Cloud、GitHub Enterprise Server ではパブリックおよびプライベートリポジトリで使用できます。
必要な環境
Jekyll を使用して GitHub Pages サイトを作成する前に、Jekyll と Git をインストールする必要があります。 詳しい情報については、Jekyll ドキュメンテーションの Installation および「Git のセットアップ」を参照してください。
Jekyll をインストールし動作させるのには Bundler を使うようおすすめします。 Bundler は、Ruby gem の依存関係を管理し、Jekyll ビルドのエラーを減少させ、環境に関係するバグを防止します。 以下はBundlerのインストール手順です。
- Rubyをインストールしてください。 詳しい情報については、Rubyのドキュメンテーションの「Rubyのインストール」を参照してください。
- Bundlerをインストールしてください。 詳しい情報については「Bundler」を参照してください。
参考: Bundler を使って Jekyll をインストールしようとしている時に Ruby のエラーがある場合、Ruby のインストールをマネージするために、RVM または Homebrew などのパッケージマネージャーが必要になる可能性があります。 詳しい情報については、Jekyllのドキュメンテーションの「トラブルシューティング」を参照してください。
サイト用にリポジトリを作成する
サイトが独立プロジェクトなら、サイトのソースコードを保存するために新しいリポジトリを作成できます。 サイトが既存のプロジェクトと関連しているなら、サイトのソースコードをそのプロジェクトのリポジトリのgh-pages
ブランチもしくはmaster
ブランチのdocs
フォルダに追加できます。 たとえば、すでにGitHub Enterprise上にあるプロジェクトのドキュメンテーションを公開するサイトを作成しているなら、そのサイトのソースコードはプロジェクトと同じリポジトリに保存したいでしょう。
既存のリポジトリにサイトを作成したいのなら、サイトの作成セクションまでスキップしてください。
警告: サイト管理者がPublic Pagesを有効化したなら、そのリポジトリがプライベートの場合であっても、GitHub Pagesサイトはインターネット上でパブリックにアクセスできるようになります。 サイトのリポジトリにセンシティブなデータがあるなら、公開前にそれを取り除くのが良いでしょう。 詳しい情報については「アプライアンス上でのGitHub Pagesの設定」及び「リポジトリの可視性について」を参照してください。
- ページの右上角で ドロップダウンメニューを使い、New repository(新規リポジトリ)を選択してください。
- Owner(オーナー)ドロップダウンメニューを使い、リポジトリを所有したいアカウントを選択してください。
- リポジトリの名前と、任意で説明を入力してください。 ユーザもしくはOrganizationのサイトを作成しているなら、リポジトリは
<user>.github.io
もしくは<organization>.github.io
という名前でなければなりません。 詳細については、「GitHub Pagesについて」を参照してください。 - リポジトリの可視性を選択してください。 詳しい情報については「リポジトリの可視性について」を参照してください。
サイトを作成する
サイトを作成する前には、GitHub Enterprise上にサイトのためのリポジトリを持っていなければなりません。 既存のリポジトリ内にサイトを作成しようとしているのではないなら、「サイトのためのリポジトリの作成」を参照してください。
-
ターミナルターミナルGit Bashを開いてください。
-
リポジトリのローカルコピーがまだない場合、サイトのソースファイルを保存したい場所に移動します。PARENT-FOLDER は、リポジトリを保存したいフォルダの名前に置き換えてください。
$ cd PARENT-FOLDER
-
ローカルの Git リポジトリをまだ初期化していない場合は、初期化します。 REPOSITORY-NAME は、リポジトリの名前に置き換えてください。
$ git init REPOSITORY-NAME > Initialized empty Git repository in /Users/octocat/my-site/.git/ # Creates a new folder on your computer, initialized as a Git repository
-
ディレクトリをリポジトリに変更します。
$ cd REPOSITORY-NAME # Changes the working directory
-
プロジェクトサイトを作成しているなら、使いたい公開ソースを決めてください。 ユーザもしくはOrganizationのサイトを作成しているなら、サイトのソースコードは
master
ブランチに保存しなければなりません。 詳しい情報については「GitHub Pagesについて」を参照してください。 -
サイトの公開ソースにアクセスしてください。 公開元に関する詳しい情報については、「GitHub Pages について」を参照してください。 たとえは、サイトを
master
ブランチのdocs
フォルダから公開する場合には、docs
フォルダを作成して、ディレクトリをdocs
フォルダに変更します。$ mkdir docs # Creates a new folder called docs $ cd docs
サイトを
gh-pages
ブランチから公開する場合には、gh-pages
ブランチを作成してチェックアウトします。$ git checkout --orphan gh-pages # Creates a new branch, with no history or contents, called gh-pages and switches to the gh-pages branch
-
新しい Jekyll サイトを作成するには、
jekyll new
コマンドを使用します。VERSION は、Jekyll の現在の依存関係バージョンに置き換えてください。 詳しい情報については、GitHub Pages サイトで「依存関係のバージョン」を参照してください。- Bundler をインストールしている場合、以下のコマンドを入力します。
$ bundle exec jekyll VERSION new . # Creates a Jekyll site in the current directory
- Bundler をインストールしていない場合、以下のコマンドを入力します。
$ jekyll VERSION new . # Creates a Jekyll site in the current directory
- Bundler をインストールしている場合、以下のコマンドを入力します。
-
作成された Gemfile を開き、Gemfile のコメントに従って GitHub Pages を使用します。
-
gem "github-pages"
の行を以下のように更新します。VERSION は、github-pages
の現在の依存関係バージョンに置き換えてください。 詳しい情報については、GitHub Pages サイトで「依存関係のバージョン」を参照してください。gem "github-pages", "~> VERSION", group: :jekyll_plugins
-
Gemfile を保存して閉じます。
-
必要に応じて、サイトをローカルでテストします。 詳しい情報については、「Jekyll を使用して GitHub Pages サイトをローカルでテストする」を参照してください。
-
GitHub Enterprise リポジトリをリモートとして追加します。HOSTNAME はアプライアンスのホスト名に、USER はリポジトリ所有者のアカウントに、そして REPOSITORY はリポジトリの名前に置き換えてください。
$ git remote add origin https://HOSTNAME/USER/REPOSITORY.git
-
リポジトリを GitHub Enterprise にプッシュします。 BRANCH は、作業を行なっているブランチの名前に置き換えてください。
$ git push -u origin BRANCH
-
プロジェクトサイトにデフォルトではない公開ソースを使っているなら、公開ソースを設定してください。 詳しい情報については「GitHub Pages サイトの公開元を設定する」を参照してください。
-
GitHub Enterpriseで、サイトのリポジトリにアクセスしてください。
-
リポジトリ名の下で Settings(設定)をクリックしてください。
-
公開されたサイトを見るには、"GitHub Pages"の下で、サイトのURLをクリックしてください。
メモ: サイトに対する変更は、その変更をGitHub Enterpriseにプッシュしてから公開されるまでに、最大20分かかることがあります。 1時間経っても変更がブラウザーに反映されなければ、「GitHub PagesサイトのJekyllビルドエラーについて」を参照してください。
ノート: サイトのソースファイルがデフォルトの公開ソース、すなわちユーザ及びOrganizationのサイトであればmaster
、プロジェクトのサイトであればgh-pages
にありながら、サイトが自動的に公開されない場合は、管理権限と認証済みメールアドレスを持つ人がデフォルトの公開ソースにプッシュしていることを確認してください。
次のステップ
サイトに新しいページを追加したり、投稿したりするには、「Jekyll を使用して GitHub Pages サイトにコンテンツを追加する」を参照してください。
JekyllのテーマをGitHub Pagesサイトに追加して、サイトのルックアンドフィールをカスタマイズできます。詳しい情報については、「Jekyll を使用して GitHub Pages サイトにテーマを追加する」を参照してください。