Skip to main content
ドキュメントには� �繁に更新が� えられ、その都度公開されています。本ページの翻訳はま� 未完成な部分があることをご了承く� さい。最新の情� �については、英語のドキュメンテーションをご参照く� さい。本ページの翻訳に問題がある� �合はこちらまでご連絡く� さい。

このバージョンの GitHub Enterprise はこの日付をもって終了となりました: 2022-06-03. 重大なセキュリティの問題に対してであっても、パッチリリースは作成されません。 パフォーマンスの向上、セキュリティの改善、新機能のためには、最新バージョンのGitHub Enterpriseにアップグレードしてく� さい。 アップグレードに関する支援については、GitHub Enterprise supportに連絡してく� さい。

Jekyll を使用して GitHub Pages サイトをローカルでテストする

GitHub Pages サイトをローカルでビルドすると、サイトに対する変更のプレビューとテストを行うことができます。

GitHub Pagesは、GitHub Free及びOrganizationのGitHub Freeのパブリックリポジトリ、GitHub Pro、GitHub Team、GitHub Enterprise Cloud、GitHub Enterprise Serverのパブリック及びプライベートリポジトリで利用できます。

リポジトリへの書き込み権限があるユーザは、GitHub Pages サイトをローカルでテストできます。

必要な環境

Jekyll を使用してサイトをテストする前に、以下の操作が必要です。

Jekyll をインストールし動作させるのには Bundler を使うようおすすめします。 Bundler は、Ruby gem の依存関係を管理し、Jekyll ビルドのエラーを減少させ、環境に関係するバグを防止します。 以下はBundlerのインストール手� �です。

  1. Rubyをインストールしてく� さい。 詳しい情� �については、Rubyのドキュメンテーションの「Rubyのインストール」を参照してく� さい。
  2. Bundlerをインストールしてく� さい。 詳しい情� �については「Bundler」を参照してく� さい。

参考: Bundler を使って Jekyll をインストールしようとしている時に Ruby のエラーがある� �合、Ruby のインストールをマネージするために、RVM または Homebrew などのパッケージマネージャーが必要になる可能性があります。 詳しい情� �については、Jekyllのドキュメンテーションの「トラブルシューティング」を参照してく� さい。

サイトをローカルでビルドする

  1. ターミナルターミナルGit Bashを開いてく� さい。
  2. サイトの公開ソースにアクセスしてく� さい。 公開元に関する詳しい情� �については、「GitHub Pages について」を参照してく� さい。
  3. bundle install を実行します。
  4. ローカルで 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.
  5. サイトをプレビューするには、ウェブブラウザで 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 は常にアップデートしておきましょう。

  1. ターミナルターミナルGit Bashを開いてく� さい。
  2. github-pages gem をアップデートします。
    • Bundler をインストールしている� �合は、bundle update github-pages を実行します。
    • Bundler をインストールしていない� �合は、gem update github-pages を実行します。

参考リンク