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

将 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 的正式文档

问问别人

找不到要找的内容?

联系我们