Commits e pull requests que incluem documentos de prosa podem representar esses documentos com as exibições source (original) e rendered (renderizada).
A exibição original mostra o texto bruto que foi inserido, enquanto a exibição renderizada mostra como o texto será exibido após a renderização no GitHub Enterprise. Por exemplo, há uma diferença na exibição do **bold**
no Markdown e do bold in na visualização renderizada.
A renderização da prosa é possível para documentos renderizados compatíveis com o github/markup:
- Markdown
- AsciiDoc
- Textile
- ReStructuredText
- Rdoc
- Org
- Creole
- MediaWiki
- Pod
Você pode clicar em para ver as alterações feitas no documento como parte de um commit.
Exibir alterações nos atributos
Nós fornecemos uma dica de ferramenta descrevendo as alterações nos atributos, que diferentes de palavras, não seriam visíveis no documento renderizado. Por exemplo, se a URL de um link for alterada, mostraremos uma dica de ferramenta como esta:
Fazer comentários em alterações
Os comentários de commit comments só podem ser adicionados aos arquivos na exibição original, linha por linha.
Vincular a cabeçalhos
Assim como ocorre em outros documentos de prosa renderizados, posicionar o mouse sobre um cabeçalho no documento cria um ícone de link. Você pode encaminhar os leitores do seu diff de prosa renderizado a seções específicas.
Exibir diffs complexos
Algumas pull requests envolvem um grande número de alterações e documentos grandes e complexos. Quando as alterações demoram muito para serem analisadas, nem sempre o GitHub Enterprise consegue produzir uma exibição renderizada das alterações; você verá uma mensagem similar a esta quando clicar no botão renderizado:
Você ainda pode usar a exibição original para analisar e comentar as alterações.
Exibir elementos HTML
Não oferecemos suporte direto a exibições renderizadas de commits para documentos HTML. Alguns formatos, como o Markdown, permite a inclusão de HTML arbitrário no documento. Quando esses documentos são mostrados no GitHub Enterprise, parte do HTML integrado pode ser mostrado em uma pré-visualização, enquanto outra parte (como um vídeo integrado do YouTube) não.
Em geral, as exibições renderizadas de alterações em um documento que contém HTML integrado mostrarão as alterações nos elementos que são compatíveis com a exibição do GitHub Enterprise do documento. As alterações em documentos que contém HTML integrado devem sempre ser confirmadas nas exibições original e renderizada.