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

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

Hover over a link to another article to get more details. If you have ideas for how we can improve this page, let us know in the discussion.

使用 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 页面和 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 前页,包括用引号括起来的帖子标题、帖子的日期和时间(格式为 YYYY-MM-DD hh:mm:ss -0000),以及任意数量的帖子类别。
    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 站点添加主题”。