Publicamos atualizações frequentes em nossa documentação, e a tradução desta página ainda pode estar em andamento. Para obter as informações mais recentes, acesse a documentação em inglês. Se houver problemas com a tradução desta página, entre em contato conosco.
Versão do artigo: Enterprise Server 2.20

Renderizar diferenças em documentos em prosa

Neste artigo

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

Ícone de papel para exibir documento em prosa renderizado

Você pode clicar em para ver as alterações feitas no documento como parte de um commit.

Alterações em prosa renderizada

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:

Alterações no atributo de prosa renderizada

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:

Desculpe, não conseguimos renderizar o documento antes do diffing.

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.

Pergunte a uma pessoa

Não consegue encontrar o que procura?

Entrar em contato