Jekyll を使用して Pages サイトを作成する

新規または既存のリポジトリ内に、 Pages Jekyll を使用してサイトを作成できます。

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

People with admin permissions for a repository can create a Pages site with Jekyll.

Pagesは、パブリック・リポジトリの Freeと組織用の Free、パブリック・リポジトリとプライベート・リポジトリの Pro、 Team、 Enterprise Cloud、 Enterprise Serverで利用できます。詳細については、「のプラン」を参照してください。

Pages で、Jekyll ビルドの実行に Actions が使用されるようになりました。ビルドのソースとしてブランチを使用する際、組み込みの Jekyll ワークフローを使用する場合は、リポジトリで Actions を有効にする必要があります。 Actions が使用できない場合、または無効になっている場合は、ソースブランチのルートに .nojekyll ファイルを追加すると、Jekyll ビルドプロセスがバイパスされ、コンテンツが直接デプロイされます。 Actions を有効にする方法の詳細については、「リポジトリの Actions の設定を管理する」を参照してください。

Platform navigation

この記事の内容

メモ

Organization 所有者は、organization が所有しているリポジトリからの Pages サイトの公開を制限できます。詳しくは、「組織の Pages サイトの公開を管理する」をご覧ください。

前提条件

Jekyll を使用して Pages サイトを作成する前に、Jekyll と Git をインストールする必要があります。詳細については、Jekyll ドキュメントの「Installation」(インストール) と、「Git のセットアップ」を参照してください。

Bundler を使用して Jekyll をインストールして実行することをお勧めします。 Bundler は、Ruby gem の依存関係を管理し、Jekyll ビルドのエラーを減少させ、環境に関係するバグを防止します。以下はBundlerのインストール手順です。

Ruby をインストールします。詳しくは、Ruby のドキュメントで「Ruby のインストール」を参照してください。
Bundlerをインストールしてください。詳しくは、Bundler のページを参照してください。

ヒント

Bundler を使って Jekyll をインストールしようとすると Ruby エラーが発生する場合は、RVM や Homebrew などのパッケージマネージャーを使って Ruby のインストールを管理することが必要な場合があります。詳しくは、Jekyll のドキュメントでトラブルシューティングに関する説明を参照してください。

サイト用にリポジトリを作成する

リポジトリを作成することも、自分のサイト用の既存のリポジトリを選ぶこともできます。

リポジトリに対して Pages サイトを作成したい場合、そのリポジトリ内のすべてのファイルがサイトに関連付けられるわけではないのなら、そのサイトに対して公開元を構成することができます。たとえば、サイトソースファイルを保持する専用のブランチとフォルダーを用意することや、カスタムの Actions ワークフローを使ってサイトソースファイルをビルドして配置することができます。

リポジトリを所有しているアカウントが Free または Organization 用の Free を使用している場合、そのリポジトリはパブリックである必要があります。

既存のリポジトリにサイトを作成する場合は、「サイトを作成する」セクションに進んでください。

ページの右上隅でを選択し、 [新しいリポジトリ] をクリックします。
[所有者] ドロップダウンメニューを使い、リポジトリを所有させたいアカウントを選びます。
リポジトリの名前と、任意で説明を入力してください。ユーザーまたは Organization サイトを作成する場合は、リポジトリに <user>..io または <organization>..io という名前を付ける必要があります。ユーザーまたは Organization の名前に大文字が含まれている場合は、小文字にする必要があります。詳しくは、「What is Pages?」をご覧ください。
リポジトリの可視性を選択してください。詳しくは、「リポジトリについて」をご覧ください。

サイトを作成する

サイトを作成する前には、上にサイト用のリポジトリがある必要があります。既存のリポジトリにサイトを作成していない場合は、「サイト用にリポジトリを作成する」をご覧ください。

警告

Pages サイトは、そのサイトのリポジトリがプライベートであっても、インターネット上で一般に利用できます (プランまたは organization で許可されている場合)。サイトのリポジトリにセンシティブなデータがあるなら、公開前にそのデータを取り除くのが良いでしょう。詳しくは、「リポジトリについて」をご覧ください。

[ターミナル][ターミナル][Git Bash] を開きます。
リポジトリのローカルコピーがまだない場合は、サイトのソースファイルを保存したい場所に移動して、PARENT-FOLDER を、リポジトリのフォルダーを含めるフォルダーで置き換えます。
```
cd PARENT-FOLDER
```

ローカルの Git リポジトリをまだ初期化していない場合は、REPOSITORY-NAME をリポジトリの名前で置き換えて初期化します。

git init REPOSITORY-NAME
> Initialized empty Git repository in /REPOSITORY-NAME/.git/
# Creates a new folder on your computer, initialized as a Git repository

ディレクトリをリポジトリに変更します。
```
cd REPOSITORY-NAME
# Changes the working directory
```
使用する公開ソースを決定します。詳しくは、「 Pages サイトの公開元を設定する」をご覧ください。
サイトの公開ソースにアクセスしてください。詳しくは、「 Pages サイトの公開元を設定する」をご覧ください。たとえば、既定ブランチの docs フォルダーからサイトを公開することを選択した場合は、docs フォルダーを作成して、そこに移動します。
```
mkdir docs
# Creates a new folder called docs
cd docs
```
If you chose to publish your site from the gh-pages branch, create and checkout the gh-pages branch.
```
git checkout --orphan gh-pages
# Creates a new branch, with no history or contents, called gh-pages, and switches to the gh-pages branch
git rm -rf .
# Removes the contents from your default branch from the working directory
```
新しい Jekyll サイトを作成するには、リポジトリのルートディレクトリで jekyll new コマンドを使用します。
```
jekyll new --skip-bundle .
# Creates a Jekyll site in the current directory
```
Jekyll が作成した Gemfile を開きます。
gem "jekyll" で始まる行の先頭に「#」を追加して行をコメントアウトします。
# gem "-pages" で始まる行を編集して、-pages gem を追加します。行を次のように変更します。
```
gem "-pages", "~> -PAGES-VERSION", group: :jekyll_plugins
```
-PAGES-VERSION を、サポートされる最新バージョンの -pages gem で置き換えます。このバージョンは、「依存関係のバージョン」にあります。
正しいバージョンの Jekyll が、-pages gem の依存関係としてインストールされます。
Gemfile を保存して閉じます。
コマンドラインから bundle install を実行します。
Jekyll が作成した .gitignore ファイルを開き、次の行を追加して gems ロックファイルを無視します。
```
Gemfile.lock
```

必要に応じて、_config.yml ファイルに対して必要な編集を行います。これは、リポジトリがサブディレクトリでホストされている場合に相対パスに対して必要です。詳しくは、「サブフォルダを新規リポジトリに分割する」をご覧ください。

domain: my-site..io       # if you want to force HTTPS, specify the domain without the http at the start, e.g. example.com
url: https://my-site..io  # the base hostname and protocol for your site, e.g. http://example.com
baseurl: /REPOSITORY-NAME/      # place folder name if the site is served in a subfolder

必要に応じて、サイトをローカルでテストします。詳細については、「Jekyll を使用して Pages サイトをローカルでテストする」を参照してください。
作業内容を追加してコミットしてください。
```
git add .
git commit -m 'Initial  pages site with Jekyll'
```
リポジトリを .com にリモートとして追加します。その際に、 USER をリポジトリを所有するアカウントに、およびREPOSITORY をリポジトリの名前に置き換えます。
```
git remote add origin https://.com/USER/REPOSITORY.git
```
リポジトリをにプッシュします。BRANCH は実際に作業しているブランチの名前に置き換えてください。
```
git push -u origin BRANCH
```
公開ソースを設定してください。詳しくは、「 Pages サイトの公開元を設定する」をご覧ください。
で、サイトのリポジトリにアクセスしてください。
リポジトリ名の下にある [設定] をクリックします。 [設定] タブが表示されない場合は、 [] ドロップダウンメニューを選び、 [設定] をクリックします。
サイドバーの [コードと自動化] セクションで、 [ ページ] をクリックします。
公開されたサイトを表示するには、[ Pages] の下で [ サイトにアクセスする] をクリックします。
メモ
サイトに対する変更は、その変更をにプッシュしてから公開されるまでに最大 10 分かかることがあります。 Pages サイトの変更が 1 時間経ってもブラウザーに反映されない場合は、「 PagesサイトのJekyllビルドエラーについて」を参照してください。
Pages サイトは、 Actions ワークフローでビルドされ、デプロイされます。詳しくは、「ワークフロー実行の履歴を表示する」をご覧ください。
メモ
Actions はパブリックリポジトリでは無料です。使用料は、無料の時間 (分) の毎月の割り当てを超えるプライベートリポジトリと内部リポジトリに適用されます。詳しくは、「使用制限、支払い、管理」をご覧ください。

メモ

ブランチから公開していて、サイトが自動的に公開されていない場合は、管理者アクセス許可と検証済みのメールアドレスを持つユーザーが公開元にプッシュしていることを確認します。
_TOKEN を使う Actions ワークフローによってプッシュされたコミットでは、 Pages ビルドがトリガーされません。

次のステップ

新しいページまたは投稿をサイトに追加するには、「Jekyll を使用して Pages サイトにコンテンツを追加する」を参照してください。

Jekyllのテーマを Pagesサイトに追加して、サイトのルックアンドフィールをカスタマイズできます。詳細については、「Jekyll を使用して Pages サイトにテーマを追加する」を参照してください。