散文文档中的呈现差异
Commits and pull requests that include prose documents have the ability to represent those documents with source and rendered views.
源视图显示已输入的原始文本,而呈现的视图显示该文本在 GitHub Enterprise 上呈现后的外观。 例如,这可能是在 Markdown 中显示 **bold**
和在呈现的视图中显示粗体之间的差异。
github/markup 支持的呈现文档支持散文呈现:
- Markdown
- AsciiDoc
- Textile
- ReStructuredText
- Rdoc
- Org
- Creole
- MediaWiki
- Pod
您可以单击 查看在提交过程中对文档的更改。
可视化属性更改
我们提供一个描述属性更改的工具提示,与字词不同的是,这些更改在呈现的文档中不可见。 例如,如果链接 URL 从一个网站更改为另一个,我们将显示类似如下的工具提示:
对更改的评论
提交评论只能逐行添加到源视图内的文件。
链接到标题
与其他呈现的散文文档一样,将鼠标悬停在文档的标题上会产生一个链接图标。 您可以将呈现散文差异的读者链接到特定部分。
查看复杂的差异
一些拉取请求涉及大型复杂文档的大量更改。 当更改分析时间过长时,GitHub Enterprise 无法一直生成更改的呈现视图;单击呈现的按钮时,您将看到类似如下的消息:
您仍可使用源视图来分析和评论更改。
查看 HTML 元素
我们不直接支持 HTML 文档提交的呈现视图。 某些格式(例如 Markdown)可让您在文档中嵌入任意 HTML。 这些文档在 GitHub Enterprise 上显示时,某些嵌入式 HTML 可以在预览中显示,而某些(例如嵌入式 YouTube 视频)则不可以。
一般来说,包含嵌入式 HTML 的文档更改的呈现视图将显示对 GitHub Enterprise 文档视图中支持元素的更改。 必须始终在呈现视图和源视图中检查对包含嵌入式 HTML 的文档的更改以确保完整性。