Schnipsel in Document360 werden von der Seite Schnipsel unter Inhaltswerkzeugen erstellt und verwaltet. Von dieser Seite aus können Sie neue Ausschnitte erstellen, Ihren Editor auswählen, Eddy AI zur Verfeinerung von Inhalten verwenden, prüfen, wo Schnipsel in Ihrer Wissensdatenbank verwendet werden, und sie einzeln oder in großen Mengen bearbeiten oder löschen.
Die Seite mit den Ausschnitten
- Navigiere in der linken Navigationsleiste zu Inhaltswerkzeugen () ().
- Wählen Sie Inhaltsressourcen > Ausschnitte im linken Navigationsfenster aus.
| Element | Beschreibung |
|---|---|
| Erstellen Sie | Erstellt einen neuen Snippet. |
| Erkennung von doppelten Inhalten | Identifiziert doppelten Text in deiner Dokumentation und schlägt vor, ihn in Schnipsel umzuwandeln. |
| Sprachen | Filtert die Ausschnittliste nach Global oder einer bestimmten Sprache. |
| Suchschnipsel | Sucht nach Ausschnitten nach Namen. |
| Auswahlbox | Wählt einen oder mehrere Schnipsel für das Massenlöschen aus. |
| Name | Klicken Sie auf den Namen eines Ausschnitts, um den Inhalt anzuschauen. |
| Verwendung in | Zeigt an, wo der Ausschnitt verwendet wurde. Zeigt einen Bindestrich an, wenn er nicht verwendet wird. Wenn verwendet, klicken Sie auf Ansicht, um die Artikel oder Kategorienseiten zu sehen, auf denen es eingefügt wurde. Archivierte Artikel und Kategorieseiten werden nicht gezählt. |
| Sprache | Gibt die Sprache an, die dem Ausschnitt zugewiesen ist. |
| Zuletzt modifiziert | Zeigt das Datum und die Uhrzeit an, an der der Ausschnitt zuletzt aktualisiert wurde. |
| Übersetzungsstatus | Klicken Sie auf das Globus-Symbol, um den Übersetzungsfortschritt zu überprüfen. Ein grünes Häkchen bedeutet, dass der Ausschnitt in diese Sprache übersetzt wurde. Ein X bedeutet, dass er es nicht ist. |
| Bearbeitung | Öffnet den Ausschnitt zum Bearbeiten. |
| Löschen | Löscht den Ausschnitt. Für das Massenlöschen aktivieren Sie die Kontrollkästchen und klicken Sie oben auf Löschen . |
Erkennung von doppelten Inhalten
Das Banner zur Erkennung von doppelten Inhalten oben auf der Snippets-Seite hilft Ihnen, wiederholte Texte in Ihrer Dokumentation zu identifizieren und zu verwalten. Diese Funktion wird von Eddy AI betrieben. Sie scannt Ihr Projekt nach Absätzen, die mehrfach in Artikeln vorkommen, erstellt einen Bericht, der zeigt, wo doppelte Inhalte vorhanden sind, und schlägt vor, diese in wiederverwendbare Snippets umzuwandeln.
- Klicken Sie auf "Duplikate suchen " auf dem Banner, um mit dem Scannen Ihres Projekts zu beginnen.
- Nach Abschluss des Scans wird die Gesamtzahl der erkannten doppelten Textblöcke angezeigt.
- Wenn bereits ein Scan durchgeführt wurde, klicken Sie erneut auf Scannen , um den Vorgang erneut durchzuführen.
- Klicken Sie auf "Vorschläge überprüfen ", um den Bericht zur Erkennung doppelter Inhalte zu öffnen und die Ergebnisse zu überprüfen.
Weitere Informationen finden Sie unter Erkennung doppelter Inhalte →
Erstellen Sie einen Ausschnitt
- Auf der Seite Ausschnitte klicken Sie oben rechts auf Erstellen .
- Im Dialog "Neuen Ausschnitt erstellen " konfigurieren Sie Folgendes:
- Name: Geben Sie einen Namen von bis zu 50 Zeichen ein. Sie können Buchstaben, Zahlen, Bindestriche und Unterstriche verwenden.
- Sprache: Wählen Sie eine Sprache aus. Der Standard ist Global.
- Editor: Erweitert Erweitert und wähle Markdown oder Erweitert WYSIWYG aus. Der Standard basiert auf den Projekteinstellungen.
- Klicken Sie auf Erstellen.
- Geben Sie Ihre Inhalte im Editor ein.
Markdown-Editor: Verwenden Sie die Formatierungstools, um Ihren Text zu formatieren.
Erweiterter WYSIWYG-Editor: Verwenden Sie die Symbolleiste oder das Schnelleinsatzmenü, um Ihre Inhalte zu formatieren.
Sobald du den erweiterten WYSIWYG-Editor ausgewählt hast, kannst du nicht mehr zurück zu Markdown wechseln. Wenn du mit Markdown startest, kannst du für Übersetzungszwecke in Advanced WYSIWYG konvertieren, da Markdown kein Übersetzen mit Eddy AI unterstützt. Du kannst nach der Konvertierung nicht wieder zu Markdown wechseln.
- Um die Sprache des Snippets zu wechseln, verwenden Sie das Sprach-Dropdown-Menü oben im Editor.
- Klicken Sie auf Speichern oder drücken Sie
Ctrl + S.
Du kannst auch benutzerdefiniertes HTML in der Code-Ansicht zum Formatieren verwenden. Nicht unterstützte Tags werden automatisch bereinigt.
Verwenden Sie Eddy AI in Snippet-Inhalten
Während Sie einen Ausschnitt im erweiterten WYSIWYG-Editor entwerfen, fahren Sie mit der Maus über beliebige Inhalte und verwenden Sie Eddy AI, um den Text länger oder kürzer zu machen, ihn zu verbessern, den Ton zu ändern, Sprache zu konvertieren, die Stimme zu verändern, Sätze zu teilen oder Elemente wie Tabellen, Kreisdiagramme und Flussdiagramme zu generieren.
Snippet-Nutzung anzeigen
Bevor Sie einen Ausschnitt bearbeiten oder löschen, können Sie genau prüfen, welche Artikel und Kategorieseiten ihn verwenden.
- Auf der Seite Ausschnitte finden Sie den Ausschnitt in der Spalte "Verwendet in ".
- Klicken Sie auf Ansicht. Das Referenzanzeigen-Panel öffnet sich. Für jede Referenz sehen Sie die Artikelversion, den Projektarbeitsbereich und die Sprache, den Namen des Benutzers, der den Ausschnitt hinzugefügt hat, den Artikelstatus (Entwurf oder Veröffentlicht) sowie Datum und Uhrzeit der Einfügung.
- Klicken Sie auf das Symbol , um diese Artikelversion in einem neuen Tab zu öffnen.
Archivierte Artikel und Kategorieseiten sind im Referenzanzeigen-Panel nicht aufgeführt und werden in der Spalte "Verwendet" nicht gezählt. Ein Ausschnitt, der nur in archivierten Inhalten verwendet wird, zeigt einen Bindestrich, als wäre er ungenutzt. Die Referenzen bleiben erhalten und erscheinen wieder, wenn der Inhalt nicht archiviert wird.
Einen Ausschnitt bearbeiten
- Auf der Seite Ausschnitte fahren Sie mit der Maus über den Ausschnitt und klicken Sie auf das Symbol Bearbeiten ().
- Aktualisieren Sie den Inhalt nach Bedarf.
- Klicken Sie auf Aktualisieren.
Wenn Sie einen Ausschnitt aktualisieren, werden die Änderungen automatisch in allen Artikeln und Kategorieseiten angezeigt, auf denen er verwendet wird, einschließlich veröffentlichter, ohne dass sie erneut veröffentlicht werden müssen.
Lösche einen Ausschnitt
- Auf der Seite Ausschnitte fahren Sie mit der Maus über den Ausschnitt und klicken Sie auf das Löschen ()-Symbol.
- Klicke im Bestätigungsdialog auf Ja .
Um das Löschen in Massen zu löschen, markiere die Kontrollkästchen neben den gewünschten Ausschnitten und klicke oben in der Liste auf Löschen .
Wenn Sie einen Ausschnitt löschen, wird er aus allen Artikeln entfernt, in denen er referenziert wird. Der Artikel behält seine aktuelle Version bei. Auf der Wissensdatenbank-Seite passt sich der umgebende Inhalt automatisch an und es bleibt kein leerer Speicher mehr übrig. Im Portal erscheint ein Ladesymbol im Inhaltsblock, in dem der Ausschnitt entfernt wurde. Wählen Sie diesen Block aus, um einen weiteren Ausschnitt einzufügen oder ihn manuell zu löschen.
Überlegungen
| Gegenstand | Detail |
|---|---|
| Länge des Snippet-Namens | Maximal 50 Zeichen. |
| Snippet-Namen-Charaktere | Nur Buchstaben, Zahlen, Bindestriche und Unterstriche. |
| Ausschnittname | Kann nach der Entstehung nicht mehr verändert werden. |
| Editor-Typ | Nach dem Wechsel zu Advanced WYSIWYG kann man nicht mehr auf Markdown zurücksetzen. |
| Globale Ausschnitte | Kann nicht übersetzt werden. |
| Snippet-Anzahl pro Projekt | Bis zu 200 Schnipseln. |
| Variablen in Schnippeln | Nicht unterstützt. Variablen werden in der Editor-Vorschau oder PDF-Exporten nicht korrekt dargestellt. |
| Archivierte Inhalte | Archivierte Artikel und Kategorieseiten sind aus der Spalte "Verwendet" und dem Referenzanzeigen-Panel ausgeschlossen. |
Best Practices
- Wählen Sie Ihren Editor bei der Erstellung sorgfältig aus. Der Wechsel von Markdown zu Advanced WYSIWYG ist möglich, aber nicht umkehrbar. Verwenden Sie Advanced WYSIWYG, wenn Sie den Ausschnitt übersetzen oder Rich Formating verwenden möchten.
- Benennen Sie Schnipsel beschreibend. Verwenden Sie Namen, die den Inhaltstyp und Zweck angeben, zum Beispiel
Support_Contact_BlockoderAPI_Disclaimer. Dadurch lassen sich Ausschnitte leichter finden und einfügen, ohne dass jeder einzelne vorschauen muss. - Verwenden Sie standardmäßig den globalen Scope. Stellen Sie die Sprache auf Global ein, es sei denn, der Inhalt des Snippets unterscheidet sich tatsächlich je nach Sprache. Sprachspezifische Snippets erfordern eine separate Verwaltung pro Sprache.
- Überprüfen Sie Abhängigkeiten vor dem Löschen. Verwenden Sie die Ansicht in der Spalte "Verwendet in ", um die Auswirkungen über Artikel hinweg zu bestätigen, bevor Sie einen Ausschnitt löschen, der möglicherweise weit verbreitet ist. Archivierte Inhalte sind nicht gelistet, also schauen Sie auch auf der Archivseite, wenn Sie archivierte Artikel oder Kategorien haben.
- Bevorzuge Ausschnitte gegenüber Kopieren und Einfügen. Wenn derselbe Inhaltsblock in mehr als zwei Artikeln vorkommt, erstelle einen Ausschnitt, anstatt ihn manuell zu duplizieren.