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

散文文档中的呈现差异

Commits and pull requests that include prose documents have the ability to represent those documents with source and rendered views.

源视图显示已输入的原始文本,而呈现的视图显示该文本在 GitHub 上呈现后的外观。 例如,这可能是在 Markdown 中显示 **bold** 和在呈现的视图中显示粗体之间的差异。

github/markup 支持的呈现文档支持散文呈现:

用于查看渲染的散文文档的纸张图标

您可以单击 查看在提交过程中对文档的更改。

呈现的散文更改

可视化属性更改

我们提供一个描述属性更改的工具提示,与字词不同的是,这些更改在呈现的文档中不可见。 例如,如果链接 URL 从一个网站更改为另一个,我们将显示类似如下的工具提示:

呈现的散文属性更改

对更改的评论

提交评论只能逐行添加到视图内的文件。

链接到标题

其他呈现的散文文档一样,将鼠标悬停在文档的标题上会产生一个链接图标。 您可以将呈现散文差异的读者链接到特定部分。

查看复杂的差异

一些拉取请求涉及大型复杂文档的大量更改。 当更改分析时间过长时,GitHub 无法一直生成更改的呈现视图;单击呈现的按钮时,您将看到类似如下的消息:

抱歉,我们无法在比较差异之前呈现文档。

您仍可使用源视图来分析和评论更改。

查看 HTML 元素

我们不直接支持 HTML 文档提交的呈现视图。 某些格式(例如 Markdown)可让您在文档中嵌入任意 HTML。 这些文档在 GitHub 上显示时,某些嵌入式 HTML 可以在预览中显示,而某些(例如嵌入式 YouTube 视频)则不可以。

一般来说,包含嵌入式 HTML 的文档更改的呈现视图将显示对 GitHub 文档视图中支持元素的更改。 必须始终在呈现视图和源视图中检查对包含嵌入式 HTML 的文档的更改以确保完整性。

问问别人

找不到要找的内容?

联系我们