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

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

Jekyll を使用して GitHub Pages サイトにコンテンツを追� する

GitHub Pages の Jekyll サイトに、新規ページや投稿を追� できます。

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

リポジトリへの書き込み権限があるユーザは、Jekyll を使用して GitHub Pages サイトにコンテンツを追� できます。

Jekyll サイトのコンテンツについて

GitHub Pages で Jekyll サイトにコンテンツを追� する前に、Jekyll サイトを作成する必要があります。 詳しい情� �については、「Jekyll を使用して GitHub Pages サイトを作成する」を参照してく� さい。

Jekyll サイトのコンテンツとして 2 つの主なタイプは、ページと投稿です。 ページとは、特定の日付に紐付けられていない、「About」ページなどの独立したコンテンツです。 デフォルトの Jekyll サイトには、about.md という名前のファイルが含まれ、サイトの YOUR-SITE-URL/about でページとして表示されます。 このファイルのコンテンツを編集して、「About」ページをパーソナライズできます。また、新しいページを作成するため、「About」ページをテンプレートとして使用できます。 詳しい情� �については、Jekyll ドキュメンテーションの「Pages」を参照してく� さい。

投稿とは、ブログ記事のことです。 デフォルトの Jekyll サイトには、デフォルト投稿ファイルがある、_posts という名前のディレクトリが含まれています。 この投稿のコンテンツを編集し、デフォルト投稿を、新規投稿を作成するためのテンプレートとして使用できます。 詳しい情� �については、Jekyllのドキュメンテーションの「Posts」を参照してく� さい。

テーマには、デフォルトのレイアウト、およびサイトの新規ページや新規投稿に自動的に適用されるスタイルシートが含まれますが、これらのデフォルト設定はオーバーライドできます。 詳しい情� �については、「GitHub Pages と Jekyll」を参照してく� さい。

サイト上のページやポストに対してタイトルやレイアウトといった変数やメタデータを設定するには、任意のMarkdownあるいはHTMLファイルの先� �にYAMLフロントマターを追� できます。 詳しい情� �についてはJekyllのドキュメンテーション内の「フロントマター」を参照してく� さい。

変更がサイトの公開ソースにマージされると、サイトへの変更は自動的に公開されます。 まず変更をプレビューしたいなら、GitHub Enterprise Serverではなくローカルで変更を行えます。 そしてサイトをローカルでテストしてく� さい。 詳しい情� �については、「Jekyll を使用して GitHub Pages サイトをローカルでテストする」を参照してく� さい。

新規ページをサイトに追� する

  1. GitHub Enterprise Serverで、サイトのリポジトリにアクセスしてく� さい。

  2. サイトの公開ソースにアクセスしてく� さい。 公開元に関する詳しい情� �については、「GitHub Pages について」を参照してく� さい。

  3. ページを作成するため、公開元のルートに PAGE-NAME.md という名前の新規ファイルを作成します。PAGE-NAME は、ページを示す、意味のあるファイル名に置き換えてく� さい。

  4. 以下の YAML frontmatter を、ファイルの先� �に追� します。PAGE TITLE はページのタイトルに、URL-PATH はページの URL として指定したい URL に置き換えてく� さい。 たとえば、サイトのベース URL が https://octocat.github.io で、URL-PATH/about/contact/ である� �合、ページの� �所は https://octocat.github.io/about/contact となります。

    layout: page
    title: "PAGE TITLE"
    permalink: /URL-PATH/
  5. frontmatter の下に、ページのコンテンツを追� します。

  6. ページの下部で、ファイルに対して行った変更を説明する短く分かりやすいコミットメッセージを入力してく� さい。 コミットメッセージでは、複数の作者にコミットを関連づけることができます。 詳しい情� �については「複数の共作者を持つコミットの作成」を参照してく� さい。 変更のコミットメッセージ

  7. コミットメッセージフィールドの下で、コミットを追� を現在のブランチか新しいブランチから選択してく� さい。 現在のブランチがデフォルトブランチなら、コミット用に新しいブランチを作成してからPull Requestを作成すべきです。 詳しい情� �については「新しいプルリクエストの作成」を参照してく� さい。 コミットブランチのオプション

  8. [Propose file change] をクリックします。 ファイル変更の提案ボタン

  9. 提案した変更に対するPull Requestを作成してく� さい。

  10. "Pull Requests"リスト内で、マージしたいPull Requestをクリックしてく� さい。

  11. Merge pull request(Pull Requestをマージ)をクリックしてく� さい。 詳しい情� �についてはプルリクエストのマージを参照してく� さい。

  12. 要求されたら、コミットメッセージを入力するか、デフォルトのメッセージのままにします。 Commit messageフィールド

  13. Confirm merge(マージを確認)をクリックしてく� さい。

  14. あるいは、ブランチを削除してく� さい。 詳しい情� �についてはリポジトリ内でのブランチの作成と削除を参照してく� さい。

新規投稿をサイトに追� する

  1. GitHub Enterprise Serverで、サイトのリポジトリにアクセスしてく� さい。

  2. サイトの公開ソースにアクセスしてく� さい。 公開元に関する詳しい情� �については、「GitHub Pages について」を参照してく� さい。

  3. _posts ディレクトリに移動します。

  4. YYYY-MM-DD-NAME-OF-POST.md という名前の新規ファイルを作成します。YYYY-MM-DD は投稿の日時に、NAME-OF-POST は投稿の名前に置き換えてく� さい。

  5. 以下の YAML frontmatter を、ファイルの先� �に追� します。 POST TITLE は投稿のタイトルに、 YYYY-MM-DD hh:mm:ss -0000 は投稿の日時に置き換え、投稿に追� したいカテゴリを CATEGORY-1CATEGORY-2 のように好きな� け追� し、カテゴリの名前に置き換えてく� さい。

    layout: post
    title: "POST TITLE"
    date: YYYY-MM-DD hh:mm:ss -0000
    categories: CATEGORY-1 CATEGORY-2
  6. frontmatter の下に、投稿のコンテンツを追� します。

  7. ページの下部で、ファイルに対して行った変更を説明する短く分かりやすいコミットメッセージを入力してく� さい。 コミットメッセージでは、複数の作者にコミットを関連づけることができます。 詳しい情� �については「複数の共作者を持つコミットの作成」を参照してく� さい。 変更のコミットメッセージ

  8. コミットメッセージフィールドの下で、コミットを追� を現在のブランチか新しいブランチから選択してく� さい。 現在のブランチがデフォルトブランチなら、コミット用に新しいブランチを作成してからPull Requestを作成すべきです。 詳しい情� �については「新しいプルリクエストの作成」を参照してく� さい。 コミットブランチのオプション

  9. [Propose file change] をクリックします。 ファイル変更の提案ボタン

  10. 提案した変更に対するPull Requestを作成してく� さい。

  11. "Pull Requests"リスト内で、マージしたいPull Requestをクリックしてく� さい。

  12. Merge pull request(Pull Requestをマージ)をクリックしてく� さい。 詳しい情� �についてはプルリクエストのマージを参照してく� さい。

  13. 要求されたら、コミットメッセージを入力するか、デフォルトのメッセージのままにします。 Commit messageフィールド

  14. Confirm merge(マージを確認)をクリックしてく� さい。

  15. あるいは、ブランチを削除してく� さい。 詳しい情� �についてはリポジトリ内でのブランチの作成と削除を参照してく� さい。

あなたの投稿がサイトにアップされているはずです。 サイトのベース URL が https://octocat.github.io の� �合、新しい投稿は https://octocat.github.io/YYYY/MM/DD/TITLE.html にあります。

次のステップ

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