Unterschiede in Dokumenten mit Fließtext rendern
Inhalt dieses Artikels
- Attributänderungen visualisieren
- Kommentare zu Änderungen
- Links mit Headern
- Komplexe Unterschiede anzeigen
- HTML-Elemente anzeigen
Commits und Pull Requests an Fließtextdokumenten unterstützen die Darstellung dieser Dokumente im Quell- und im gerenderten Format.
In der Quellansicht wird der eingegebene Rohtext angezeigt. In der gerenderten Ansicht wird der Text dagegen so angezeigt, wie er gerendert auf GitHub Enterprise aussehen würde. Beispielsweise wird fett ausgezeichneter Text in der Quellansicht in Markdown **fett** dargestellt, in der gerenderten Ansicht dagegen fett.
Das Rendering von Fließtext wird für gerenderte Dokumente unterstützt, die von github/markup unterstützt werden:
- Markdown
- AsciiDoc
- Textile
- ReStructured Text
- Rdoc
- Org
- Creole
- MediaWiki
- Pod
Zum Anzeigen der im Zuge eines Commits vorgenommenen Änderungen an einem Dokument klicken Sie auf das Symbol .
Attributänderungen visualisieren
Zu Attributänderungen, die im Gegensatz zu Worten im gerenderten Dokument nicht sichtbar werden, erhalten Sie einen Tooltip. Beispielsweise erhalten Sie bei der Änderung einer Link-URL in die URL einer anderen Website einen Tooltip wie diesen:
Kommentare zu Änderungen
Das Commit von Kommentaren kann Dateien in der Quellansicht nur zeilenweise hinzugefügt werden.
Links mit Headern
Wie bei anderen gerenderten Dokumenten mit Fließtext wird ein Linksymbol erstellt, sobald Sie den Mauszeiger über einen Dokumentheader bewegen. Sie können die Leser Ihres gerenderten Fließtextes über Links zu bestimmten Abschnitten leiten.
Komplexe Unterschiede anzeigen
Einige Pull Requests umfassen sehr viele Änderungen an großen und komplexen Dokumenten. Wenn die Analyse der Änderungen zu lange dauert, kann GitHub Enterprise nicht immer eine gerenderte Ansicht der Änderungen generieren. Wenn Sie auf die Schaltfläche für die gerenderte Ansicht klicken, sehen Sie in diesem Fall eine Meldung wie die Folgende:
Jedoch können Sie die Änderungen auch in der Quellansicht analysieren und kommentieren.
HTML-Elemente anzeigen
Gerenderte Ansichten der Commits an HTML-Dokumenten werden nicht direkt unterstützt. In einigen Formaten wie Markdown können Sie beliebig HTML im Dokument einbetten. Wenn diese Dokumente in GitHub Enterprise dargestellt werden, kann ein Teil dieser eingebettenen HTML in einer Vorschau angezeigt werden, manch andere HTML (z. B. eingebettete YouTube-Videos) hingegen nicht.
Im Allgemeinen zeigen gerenderte Ansichten von Dokumentänderungen mit eingebetteter HTML Änderungen an den Elementen an, die in der GitHub Enterprise-Ansicht des Dokuments unterstützt werden. Aus Gründen der Vollständigkeit sollten Änderungen an Dokumenten, die eingebettete HTML enthalten, immer sowohl in der gerenderten als auch in der Quellansicht überprüft werden.