リポジトリへの書き込み権限があるユーザは、GitHub Pages サイトをローカルでテストできます。
前提条件
Jekyll を使用してサイトをテストする前に、以下の操作が必要です。
- Jekyll をインストールする。
- Jekyll サイトを作成する。 詳細については、Jekyll で GitHub Pages サイトを作成する方法に関するページを参照してく� さい。
Bundler を使用して Jekyll をインストールして実行することをお勧めします。 Bundler は、Ruby gem の依存関係を管理し、Jekyll ビルドのエラーを減少させ、環境に関係するバグを防止します。 以下はBundlerのインストール手� �です。
- Ruby をインストールします。 詳細については、Ruby ドキュメントの「Installing Ruby」 (Ruby のインストール) を参照してく� さい。
- Bundlerをインストールしてく� さい。 詳細については、「Bundler」を参照してく� さい。
ヒント: Bundler を使用して Jekyll をインストールしようとしたときに Ruby エラーが表示された� �合は、RVM や Homebrew などのパッケージ マネージャーを使用して Ruby のインストールを管理することが必要になる� �合があります。 詳細については、Jekyll ドキュメントのトラブルシューティングを参照してく� さい。
サイトをローカルでビルドする
- [ターミナル][ターミナル][Git Bash] を開きます。 1. サイトの公開ソースにアクセスしてく� さい。 詳細については、「ご利用の GitHub Pages サイトに合わせた公開元の構成」を参照してく� さい。
bundle install
を実行します。- ローカルで Jekyll サイトを実行します。
$ bundle exec jekyll serve > Configuration file: /Users/octocat/my-site/_config.yml > Source: /Users/octocat/my-site > Destination: /Users/octocat/my-site/_site > Incremental build: disabled. Enable with --incremental > Generating... > done in 0.309 seconds. > Auto-regeneration: enabled for '/Users/octocat/my-site' > Configuration file: /Users/octocat/my-site/_config.yml > Server address: http://127.0.0.1:4000/ > Server running... press ctrl-c to stop.
- サイトをプレビューするには、Web ブラウザーで
http://localhost:4000
に移動します。
注釈: Ruby 3.0 と Jekyll 4.2.x 以前を使用している� �合、bundle install
を実行する前にプロジェクトの Gemfile に webrick
gem を追� する必要があります。
GitHub Pages gem の更新
Jekyll は、� �繁に更新されているアクティブなオープンソースプロジェクトです。 お使いのコンピューター上の github-pages
gem が GitHub Pages サーバー上の github-pages
gem と比較して古くなっている� �合は、ローカルでビルドしたときと GitHub Enterprise Server に公開したときで、サイトの見え方が異なることがあります。 これを回避するには、お使いのコンピューターで github-pages
gem を定期的に更新します。
- [ターミナル][ターミナル][Git Bash] を開きます。
github-pages
gem を更新します。- Bundler をインストールしている� �合、
bundle update github-pages
を実行します。 - Bundler をインストールしていない� �合、
gem update github-pages
を実行します。
- Bundler をインストールしている� �合、