我们经常发布文档更新,此页面的翻译可能仍在进行中。有关最新信息,请访问英文文档。如果此页面上的翻译有问题,请告诉我们
文章版本: Enterprise Server 2.20

使用 Jekyll 为 GitHub Pages 站点设置 Markdown 处理器

您可以选择一个 Markdown 处理器来确定 Markdown 在 GitHub Pages 站点上的呈现方式。

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

拥有仓库写入权限的人可为 GitHub Pages 站点设置 Markdown 处理器。

GitHub Pages 支持两种 Markdown 处理器:kramdown 和 GitHub 自己的扩展 CommonMark 处理器,后者用于在整个 GitHub Enterprise 中呈现 GitHub 风格的 Markdown。 更多信息请参阅“关于 GitHub 上的书写和格式化”。

您可以在任一处理器上使用 GitHub 风格的 Markdown,但只有我们的 CommonMark 处理器始终与您在 GitHub Enterprise 上看到的结果相匹配。

  1. 在 GitHub Enterprise 上,导航到站点的仓库。

  2. 在仓库中,浏览到 _config.yml 文件。

  3. 在文件视图的右上角,单击 打开文件编辑器。

    编辑文件按钮

  4. 找到以 markdown: 开头的行,然后将值更改为 kramdownGFM

    config.yml 中的 Markdown 设置

  5. 在页面底部,输入一条简短、有意义的提交消息,描述您对文件所作的更改。 您可以在提交消息中将提交归于多个作者。 更多信息请参阅“创建有多个合作作者的提交”。

    有关更改的提交消息

  6. 在提交消息字段下面,确定是要将提交添加到当前分支还是新分支。 If your current branch is the default branch, you should choose to create a new branch for your commit and then create a pull request. 更多信息请参阅“创建新的拉取请求”。

    提交分支选项

  7. 单击 Propose new file(提议新文件)

    提议新文件按钮

延伸阅读

问问别人

找不到要找的内容?

联系我们