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

此版本的 GitHub Enterprise 将停止服务 此版本的 GitHub Enterprise 已停止服务 2019-10-16. No patch releases will be made, even for critical security issues. For better performance, improved security, and new features, upgrade to the latest version of GitHub Enterprise. For help with the upgrade, contact GitHub Enterprise support.

将 Markdown 处理器更新为 kramdown

如果您尚未使用 kramdown(Jekyll 3.0.0 的默认 Markdown 处理器),则必须在 _config.yml 文件中更新 Markdown 处理器。

GitHub 页面 支持 kramdown 作为 Markdown 处理器。

默认情况下,kramdown 支持 GitHub 风格的 Markdown,因此您可以将 Markdown 与 GitHub 页面 配合使用,如同在 GitHub 上使用 Markdown 一样

提示:如果您当前正在使用支持 GitHub 风格 Markdown 的 Markdown处理器(例如 RdiscountRedcarpet),则无需更改 Markdown 文件即可正确呈现内容。

如果您使用除 Kramdown 以外的 Markdown 处理器,则必须更改站点配置文件中的 Markdown 设置。

  1. 在 GitHub Enterprise 上,导航到仓库的主页面。

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

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

    使用编辑图标打开文件编辑器

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

    config.yml 中的 markdown 值

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

    关于更改的提交消息

  6. 在 commit message(提交消息)字段下方,决定要将提交添加到当前分支还是添加到新分支。如果当前分支为 master,则应选择为提交创建新分支,然后创建拉取请求

    提交分支选项

  7. 单击 Propose file change(提议文件更改)

    Propose file change(提议文件更改)按钮

有关使用 kramdown 的更多信息,请参阅 kramdown 的快速参考指南kramdown 的正式文档

问问别人

找不到要找的内容?

联系我们