Frecuentemente publicamos actualizaciones de nuestra documentación. Es posible que la traducción de esta página esté en curso. Para conocer la información más actual, visita la documentación en inglés. Si existe un problema con las traducciones en esta página, por favor infórmanos.

Representar diferencias en documentos en prosa

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

Icono Paper (Papel) para ver el documento en prosa representado

Puedes hacer clic en para ver los cambios hechos al documento como parte de una confirmación.

Cambios en prosa representados

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:

Cambios en atributos de la prosa representados

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:

No podemos representar el documento antes de la comparación. Lo sentimos.

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.

Pregunta a una persona

¿No puedes encontrar lo que estás buscando?

Contáctanos