Representar diferencias en documentos en prosa
En este artículo
- Ver los cambios del atributo
- Comentar cambios
- Vincular a encabezados
- Ver diferencias complejas
- Ver elementos HTML
Las confirmaciones y solicitudes de extracción que incluyen documentos en prosa tienen la capacidad de representar esos documentos con vistas de origen y representadas.
La vista de origen muestra el texto en bruto que se escribió, mientras que la vista representada muestra la manera en que ese texto se vería una vez que se represente en GitHub Enterprise. Por ejemplo, esto puede ser la diferencia entre mostrar **negrita** en Markdown y negrita en la vista representada.
Se admite la representación en prosa para documentos representados compatibles con github/markup:
- Markdown
- AsciiDoc
- Textile
- ReStructuredText
- Rdoc
- Org
- Creole
- MediaWiki
- Pod
Puedes hacer clic en para ver los cambios hechos al documento como parte de una confirmación.
Ver los cambios del atributo
Proporcionamos una información de herramienta que describe los cambios en los atributos que, a diferencia de las palabras, no serían visibles en el documento representado. Por ejemplo, si la URL de un enlace cambia de un sitio web a otro, mostraríamos una información de herramienta como la siguiente:
Comentar cambios
Solo se pueden agregar comentarios de la confirmación en los archivos dentro de la vista de origen, línea por línea.
Vincular a encabezados
Como con otros documentos en prosa representados, deslizarse sobre un encabezado de tu documento crea un icono de enlace. Puedes vincular a los lectores de tu diferencia de prosa representada a secciones específicas.
Ver diferencias complejas
Algunas solicitudes de extracción incluyen una gran cantidad de cambios con documentos grandes y complejos. Cuando lleva demasiado tiempo analizar los cambios, GitHub Enterprise no siempre puede generar una vista representada de los cambios. Verás un mensaje similar a este cuando hagas clic en el botón representado:
Aún puedes utilizar la vista de origen para analizar y comentar cambios.
Ver elementos HTML
No admitimos directamente vistas representadas de confirmaciones en documentos HTML. Algunos formatos, como Markdown, te permiten insertar HTML arbitrarios en un documento. Cuando estos documentos se muestran en GitHub Enterprise, algunos de esos HTML insertados pueden aparecer en una vista previa, mientras que con otros no es posible hacerlo (como un video de YouTube insertado).
En general, las vistas representadas de los cambios en un documento que contiene HTML insertados mostrarán los cambios en los elementos que se admiten en la vista del documento de GitHub Enterprise. Los cambios en los documentos que contienen HTML insertados siempre se deben verificar en las vistas de origen y representada para corroborar que estén todos.