Erstellen von Markdown-Dokumenten im Editor
- Themen:
- Authoring
- Funktionen des Web-Editors
Erstellt für:
- Benutzende
Markdown ist eine einfache Markup-Sprache, mit der Sie Formatierungselemente zu Textdokumenten hinzufügen können. Adobe Experience Manager Guides bietet die Funktion zum Erstellen, Verfassen und Anzeigen einer Vorschau eines Markdown (.md) -Themas im Editor. Sie können auch die vorhandenen Markdown-Dokumente hochladen und im Editor bearbeiten.
Markdown-Thema erstellen
Führen Sie die folgenden Schritte aus, um im Editor ein Markdown-Thema zu erstellen:
-
Wählen Sie im Repository-Bereich die Option
-
Geben im Dialogfeld Neues Thema“ die folgenden Details an:
- Titel: Geben Sie einen Titel für das Thema an.
- Name: Der Dateiname wird basierend auf dem Thementitel automatisch vorgeschlagen. Wenn Ihr Admin automatische Dateinamen basierend auf der UUID-Einstellung aktiviert hat, wird das Feld Name nicht angezeigt.
- Vorlage Wählen Sie Markdown aus der Dropdown-Liste aus. Die Vorlage Thema ist standardmäßig ausgewählt.
- Path: Durchsuchen Sie den Pfad, in dem Sie die Themendatei speichern möchten. Standardmäßig wird der Pfad des aktuell ausgewählten Ordners im Repository im Feld Pfad angezeigt.
Im Falle eines Upgrades müssen Sie die Markdown-Vorlage zum aktuell verwendeten Profilordner hinzufügen. Sie können eine neue Markdown-Vorlage aus dem Editor erstellen oder eine vorhandene Vorlage für die Bearbeitung von Markdown-Inhalten verwenden. Weitere Informationen zum Hinzufügen von Authoring-Vorlagen in Experience Manager Guides finden Sie unter Konfigurieren von globalen Profilen oder Profilen auf.
-
Wählen Sie Erstellen aus.
Das Markdown-Thema wird unter dem ausgewählten Pfad erstellt und ist zur Bearbeitung geöffnet.
Kennenlernen der Editor-Funktionen für ein Markdown-Thema
Dieser Abschnitt führt Sie durch die verschiedenen Funktionen, die im Editor für die Bearbeitung von Markdown-Themen verfügbar sind. Die Authoring-Oberfläche ist in die folgenden Abschnitte oder Bereiche unterteilt:
Symbolleiste
Die Symbolleiste befindet sich direkt unter der Registerkartenleiste. In der Symbolleiste verfügbare Funktionen werden wie folgt erläutert:
Hinweis: Sie können auch Bilder und andere Dateien per Drag-and-Drop in den Markdown-Editor ziehen. Dateien werden als Querverweis-Links hinzugefügt, während Bilder als Standardelemente des Bilds angezeigt werden.
Inhaltsbearbeitungsbereich
Im Inhaltsbearbeitungsbereich wird die Markdown-Quelle Ihres Themas angezeigt, in der Sie alle Inhaltsbearbeitungen vornehmen. In der Seitenansicht wird dieser Bereich in zwei Abschnitte unterteilt - Markdown-Quellansicht auf der linken Seite und Vorschau auf der rechten Seite. Sie können mehrere Themen gleichzeitig öffnen, die auf den jeweiligen Registerkarten angezeigt werden.
Source-, Side-by-Side- und Vorschau-Modus
Für das Markdown-Authoring unterstützt der Editor drei verschiedene Anzeigemodi, um die Inhaltserstellung und -formatierung zu unterstützen:
- Quelle
- Nebeneinander
- Vorschau
Quelle
Dies ist die Markdown-Code-Ansicht des Editors. Sie können Markdown-Themen wie in jedem normalen Markdown-Editor bearbeiten. In der Source-Ansicht haben Sie die Möglichkeit, eine Revision des Dokuments zu speichern, Überschriften einzufügen, eine Tabelle einzufügen, ein Bild einzufügen und vieles mehr.
Verwenden Sie diese Ansicht, wenn Sie sich nur auf das Schreiben und Bearbeiten des Roh-Markdown konzentrieren möchten, ohne die gerenderte Ausgabe anzuzeigen.
Seite an Seite
In diesem Modus wird der Editor in zwei Bereiche unterteilt:
- Das Source-Bedienfeld, das das bearbeitete Markdown-Thema anzeigt.
- Das Bedienfeld Vorschau , das die gerenderte Ausgabe des Markdown-Themas in Echtzeit anzeigt.
Verwenden Sie diese Ansicht, wenn Sie die gerenderte Ausgabe bei der Bearbeitung von Markdown-Themen in Echtzeit anzeigen möchten.
Vorschau
Beim Öffnen eines Markdown-Themas im Vorschaumodus wird angezeigt, wie ein Thema angezeigt wird, wenn es von einem Benutzer in seinem Browser angezeigt wird. In dieser Ansicht werden alle Bearbeitungsfunktionen aus der Symbolleiste entfernt. Sie können jedoch weiterhin auf die Funktionen Als neue Versionen speichern, Sperren/Entsperren in der Symbolleiste und auf die Funktion Dateieigenschaften im rechten Bereich zugreifen.
Rechtes Bedienfeld
Das rechte Bedienfeld bietet Zugriff auf das Bedienfeld **Dateieigenschaften“.
Die Dateieigenschaften umfassen die beiden folgenden Abschnitte:
Allgemein
Im Abschnitt Allgemein haben Sie Zugriff auf die folgenden Funktionen:
- Dateiname: Zeigt den Dateinamen des ausgewählten Themas an.
- ID: Zeigt die ID des ausgewählten Themas an.
- Language: Zeigt die Sprache des Themas an. Sie wird im Feld Sprache auf der Seite Eigenschaften festgelegt.
- Erstellt am: Zeigt Datum und Uhrzeit an, zu der das Thema erstellt wurde.
- Geändert am: Zeigt Datum und Uhrzeit an, zu der das Thema geändert wurde.
- Gesperrt von: Zeigt den Benutzer an, der das Thema ausgecheckt hat.
- Dokumentstatus: Sie können den Dokumentstatus des aktuell geöffneten Themas auswählen und aktualisieren. Weitere Informationen finden Sie unter Dokumentstatus.
- Tags: Dies sind die Metadaten-Tags des Themas. Sie werden über das Feld Tags auf der Seite Eigenschaften festgelegt. Sie können sie in der Dropdown-Liste eingeben oder auswählen. Die Tags werden unter dem Dropdown-Menü angezeigt. Um ein Tag zu löschen, klicken Sie auf das Kreuzsymbol neben dem Tag.
- Weitere Eigenschaften bearbeiten: Sie können auf der Seite mit den Dateieigenschaften weitere Eigenschaften bearbeiten.
Verweise
Der Abschnitt Verweise bietet Ihnen Zugriff auf die folgenden Funktionen:
- Verwendet in: Die Option Verwendet in Verweisen listet die Dokumente auf, auf die die aktuelle Datei verwiesen oder verwendet wird.
- Ausgehende Links: Unter Ausgehende Links werden die Dokumente aufgelistet, auf die im aktuellen Dokument verwiesen wird.
Alle in und Outgoing-Links verwendeten Verweise sind mit den Dokumenten per Hyperlink verbunden. Sie können die verknüpften Dokumente einfach öffnen und bearbeiten.
Funktionseinschränkungen
Die folgenden Experience Manager Guides-Funktionen können derzeit nicht für das Markdown-Authoring verwendet werden:
- Überprüfung
- Zusammenführen
- KI-Assistent
- Änderungen verfolgen
- Suchen und Ersetzen
- Suchen und Filtern
Übergeordnetes Thema: Einführung in den Editor