Skip to main content
我们经常发布文档更新，此页面的翻译可能仍在进行中。有关最新信息，请访问英语文档。
� 

� 

此版本的 GitHub Enterprise 已停止服务 2022-10-12. 即使针对重大安全问题，也不会发布补丁。 为了获得更好的性能、更高的安全性和新功能，请升级到最新版本的 GitHub Enterprise。 如需升级帮助，请联系 GitHub Enterprise 支持。

使用 Jekyll 向 GitHub Pages 站点添� 内容

本文内容

您可以在 GitHub Pages 上向 Jekyll 站点添� 新页面或帖子。

GitHub Pages 适用于具有 GitHub Free 和组织的 GitHub Free 的公共仓库，以及具有 GitHub Pro、GitHub Team、GitHub Enterprise Cloud 和 GitHub Enterprise Server 的公共和私有仓库。

拥有仓库写入权限的人员可以使用 Jekyll 向 GitHub Pages 站点添� 内容。

关于 Jekyll 站点中的内容

必须先创建一个 Jekyll 站点，然后才可将内容添� 到 GitHub Pages 上的 Jekyll 站点。 有关详细信息，请参阅“使用 Jekyll 创建 GitHub Pages 站点”。

Jekyll 站点中内容的主要类型是页面和帖子。 页面是指与某个特定日期没有关联的独立内容，例如“关于”页面。 默认的 Jekyll 站点包含一个名为 about.md 的文件，该文件在 YOUR-SITE-URL/about 呈现为站点上的一个页面。 您可以编辑该文件的内容以个性化“关于”页面，也可以使用“关于”页作为模板创建新页面。 有关详细信息，请参阅 Jekyll 文档中的“页面”。

帖子是博客文� 。 默认 Jekyll 站点包含名为 _posts 的目录，其中包含默认帖子文件。 您可以编辑该帖子的内容，也可以将默认帖子用作模板来创建新帖子。 有关详细信息，请参阅 Jekyll 文档中的“帖子”。

主题包括默认布局、包含和� �式表，它们将自动应用到站点上的新页面和帖子，但您可以覆盖其中任何默认值。 有关详细信息，请参阅“关于 GitHub Pages 和 Jekyll”。

要为网站上的页面或帖子设置变量和元数据，例如� �题和布局， 您可以将 YAML 前页添� 到任意 Markdown 或 HTML 文件的顶部。 有关详细信息，请参阅 Jekyll 文档中的“前页”。

Changes。 如果想先预览� 的更改，可以在本地而不是 GitHub Enterprise Server 上进行更改。 然后在本地测试站点。 有关详细信息，请参阅“使用 Jekyll 在本地测试 GitHub Pages 站点”。

向站点添� 新页面

  1. 在 GitHub Enterprise Server 上，导航到站点的仓库。 1. 导航到站点的发布来源。 有关详细信息，请参阅“为 GitHub Pages 站点配置发布源”。
  2. 在发布源的� �目录中，为名为 PAGE-NAME.md 的页面创建新文件，将 PAGE-NAME 替换为对该页面有意义的文件名 。
  3. 在文件顶部添� 以下 YAML 前页，将 PAGE TITLE 替换为页面的� �题，将 URL-PATH 替换为想要的页面 URL 的路径 。 例如，如果站点的基 URL 为 https://octocat.github.io，并且 URL-PATH 为 /about/contact/，则页面将位于 https://octocat.github.io/about/contact。 
    layout: page
title: "PAGE TITLE"
permalink: /URL-PATH/
  4. 在前页下方，为页面添� 内容。
  5. 在页面底部，输入一条简短、有意义的提交消息，描述您对文件所作的更改。 您可以在提交消息中将提交归于多个作者。 有关详细信息，请参阅“创建具有多个共同作者的提交”。 更改的提交消息 1. 在提交消息字段下面，确定是要将提交添� 到当前分支还是新分支。 如果当前分支是默认分支，则应选择为提交创建新分支，然后创建拉取请求。 有关详细信息，请参阅“创建新的拉取请求”。 提交分支选项 1. 单击“提议文件更改”。 提议文件更改按钮 1. 为您提议的更改创建拉取请求。
  6. 在“Pull Requests（拉取请求）”列表中，单击要合并的拉取请求。 1. 单击“合并拉取请求”。 有关详细信息，请参阅“合并拉取请求”。 1. 如有提示，输入提交消息，或接受默认消息。 提交消息字段 1. 单击“确认合并”。 1. （可选）� 除分支。 有关详细信息，请参阅“在存储库中创建和� 除分支”。

向站点添� 新帖子

  1. 在 GitHub Enterprise Server 上，导航到站点的仓库。 1. 导航到站点的发布来源。 有关详细信息，请参阅“为 GitHub Pages 站点配置发布源”。
  2. 导航到 _posts 目录。
  3. 创建名为 YYYY-MM-DD-NAME-OF-POST.md 的新文件，将 YYYY-MM-DD 替换为帖子的日期，将 NAME-OF-POST 替换为帖子的名称 。
  4. 在文件顶部添� 以下 YAML 前页，将 POST TITLE 替换为帖子� �题，将 YYYY-MM-DD hh:mm:ss -0000 替换为帖子的日期和时间，将 CATEGORY-1 和 CATEGORY-2 替换为要为帖子选择的多个类别 。 
    layout: post
title: "POST TITLE"
date: YYYY-MM-DD hh:mm:ss -0000
categories: CATEGORY-1 CATEGORY-2
  5. 在前页下方，为帖子添� 内容。
  6. 在页面底部，输入一条简短、有意义的提交消息，描述您对文件所作的更改。 您可以在提交消息中将提交归于多个作者。 有关详细信息，请参阅“创建具有多个共同作者的提交”。 更改的提交消息 1. 在提交消息字段下面，确定是要将提交添� 到当前分支还是新分支。 如果当前分支是默认分支，则应选择为提交创建新分支，然后创建拉取请求。 有关详细信息，请参阅“创建新的拉取请求”。 提交分支选项 1. 单击“提议文件更改”。 提议文件更改按钮 1. 为您提议的更改创建拉取请求。
  7. 在“Pull Requests（拉取请求）”列表中，单击要合并的拉取请求。 1. 单击“合并拉取请求”。 有关详细信息，请参阅“合并拉取请求”。 1. 如有提示，输入提交消息，或接受默认消息。 提交消息字段 1. 单击“确认合并”。 1. （可选）� 除分支。 有关详细信息，请参阅“在存储库中创建和� 除分支”。

您的帖子现在应该显示在您的站点上！ 如果站点的基 URL 为 https://octocat.github.io，则新帖子将位于 https://octocat.github.io/YYYY/MM/DD/TITLE.html。

后续步骤

您可以将 Jekyll 主题添� 到 GitHub Pages 站点，以自定义站点的外观。 有关详细信息，请参阅“使用 Jekyll 将主题添� 到 GitHub Pages 站点”。