Verwendung von Ausschnitten

Snippets ist eine vordefinierte Menge von Inhaltsblöcken, die der Inhaltsmanager oder Autor als wiederverwendbare Inhalte verwendet. Der Inhalt des Snippets kann von einfachen Texten oder Phrasen bis hin zu langen Absätzen, Tabellen, Bildern und mehr reichen. In Document360 werden die Ausschnitte in einer Bibliothek gespeichert, und Sie können sie während der Bearbeitung einfach mit einem Klick in Artikel einfügen.

ANMERKUNG

Der Ausschnitt wird dem Leser als regulärer Inhalt auf der Knowledge Base-Seite erscheinen. Der Leser wird nicht wissen, dass der Inhalt durch Snippet gerendert wurde.

Zugriff auf die Snippets-Seite

Du kannst einen Ausschnitt von der Snippets Seite ansehen, bearbeiten oder löschen.  

1. Navigiere zu Documentation () in der linken Navigationsleiste in der Knowledge base portal.

2. Im linken Navigationsfeld gehen Sie zu Content tools > Content reuse > Snippets.

   Die Seite Snippets zeigt eine Liste aller Schnipsel an, die zu Ihrem Projekt hinzugefügt wurden.

1.   Anleitung: Sieh dir ein Tutorial an, wie man Schnipsel verwendet.

2.   Dokumentation: Öffnen Sie den Dokumentationsartikel über Ausschnitte.

3. Erstellen: Erstellen Sie einen neuen Ausschnitt.

4. Erkennung von doppelten Inhalten: Identifizieren und verwalten Sie doppelten Text in Ihrer Dokumentation und wandeln Sie sie in Ausschnitte um.

5. Sprachen: Filtern Sie die Ausschnittliste nach Global oder einer bestimmten Sprache.

6. Suchschnipsel: Suche nach Ausschnitten nach Namen.

7. Verwendet in: Zeigt, wo der Ausschnitt verwendet wird.

   • Wenn der Ausschnitt nicht verwendet wird, zeigt das Feld einen Strich -an.

   • Wenn der Ausschnitt verwendet wird, klicken Sie auf Ansicht, um die Artikel oder Kategorieseiten zu sehen, auf denen er eingefügt wurde.

8. Sprache: Gibt die Sprache des Ausschnitts an.

9. Zuletzt geändert: Zeigt das Datum und die Uhrzeit der letzten Aktualisierung des Snippets an.

10. Vorschau: Klicken Sie auf den Namen des Ausschnitts, um die Inhalte vorzusehen.

11. Fortschritt: Sehen Sie sich den Übersetzungsstatus des Ausschnitts an. Klicken Sie auf das Globussymbol ()-Symbol neben jedem Ausschnitt. A zeigt an, dass der Ausschnitt in diese Sprache übersetzt wurde, während das Symbol anzeigt, dass er noch nicht übersetzt wurde.

12. Bearbeitung (): Bearbeite den Ausschnitt-Inhalt.

13. Löschen (): Klicken Sie, um einen Ausschnitt zu löschen. Um mehrere Ausschnitte in einer einzigen Instanz zu löschen, wählen Sie die gewünschten Kontrollkästchen aus und klicken Sie oben auf Löschen .

Banner zur Erkennung doppelter Inhalte

Um doppelten Text in Ihrer Dokumentation zu identifizieren und zu verwalten, ist oben auf der Snippets-Seite ein neues Banner zur Erkennung von doppelten Inhalten verfügbar.

Diese Funktion, betrieben von Eddy AI, ist nur für Kunden mit Enterprise-Tarifen verfügbar. Es scannt Ihr Projekt nach Absätzen, die mehrfach in den Artikeln vorkommen. Sobald der Scan abgeschlossen ist, erstellt das System einen detaillierten Bericht, der zeigt, wo sich doppelte Inhalte befinden, und schlägt vor, diese in wiederverwendbare Ausschnitte umzuwandeln.

Erkennung von doppeltem Inhalt

1. Klicken Sie auf " Duplikate finden " auf dem Banner, um Ihr Projekt nach doppelten Inhalten zu scannen.

2. Sobald der Scan abgeschlossen ist, wird die Gesamtzahl der erkannten doppelten Textblöcke angezeigt.

3. Wenn bereits ein Scan durchgeführt wurde, klicken Sie erneut auf Scannen , um den Vorgang erneut durchzuführen.

4. Klicken Sie auf "Vorschläge überprüfen ", um den Bericht zur Erkennung doppelter Inhalte zu öffnen und die Ergebnisse zu überprüfen.

ANMERKUNG

Für weitere Informationen lesen Sie den Artikel auf Duplicate content detection.

Erstellung eines Ausschnitts

Um einen neuen Ausschnitt zu erstellen:

1. Navigiere zu Documentation () in der linken Navigationsleiste in der Knowledge base portal.

2. Im linken Navigationsfenster navigieren Sie zu Content tools > Content reuse > Snippets.

   Die Seite Snippets erscheint. Wenn du zuvor Ausschnitte hinzugefügt hast, kannst du sie hier sehen.

3. Klicken Sie oben rechts auf Erstellen .

4. Im Dialog "Neuen Ausschnitt erstellen ":

   1. Geben Sie einen Namen ein (bis zu 50 Zeichen). Du kannst Buchstaben, Zahlen, Bindestriche und Unterstriche verwenden.

   2. Wähle eine Sprache (standardmäßig ist Global). Du kannst bei Bedarf eine bestimmte Sprache auswählen.

   3. Erweitern Sie das erweiterte Dropdown-Menü und wählen Sie Ihren Editor (Markdown oder Advanced WYSIWYG). Der Standard-Editor basiert auf deinen allgemeinen Projekteinstellungen.

5. Klicken Sie auf Erstellen.

Nach der Erstellung:

6. Verwenden Sie den ausgewählten Editor, um Ihren Snippet-Inhalt einzugeben.

   1. Wenn Markdown verwendet wird, erscheint der Markdown-Editor.

   2. Wenn Sie Advanced WYSIWYG verwenden, sind die Editor-Toolbar, die Codeansicht, der Eddy AI Summary Generator und der Eddy AI FAQ Generator verfügbar.

ANMERKUNG

• 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 keine maschinelle Übersetzung unterstützt). Dann kannst du nicht mehr zurück zu Markdown wechseln.

7. Du kannst die Sprache über das Sprach-Dropdown oben wechseln.

8. Nachdem du deinen Ausschnitt entworfen hast, klicke auf Speichern oder drücke, Ctrl+S um die Verknüpfung zu verwenden.

ANMERKUNG

Formatierungsoptionen

• Du kannst die Formatierung auf deinen Snippet-Inhalt mit der Werkzeugleiste anwenden:

  • Markdown-Editor: Für Formatierungshilfe lesen Sie den Artikel auf dem Markdown editor.

  • Fortgeschrittener WYSIWYG-Editor: Für eine vollständige Liste der Funktionen lesen Sie den Artikel auf dem Advanced WYSIWYG editor.

• Du kannst benutzerdefiniertes HTML in den Code-Ansichten verwenden. Allerdings werden nicht unterstützte Tags automatisch desinfiziert.

• Wenn Sie den erweiterten WYSIYWG-Editor auswählen, können Sie das Schrägstrichmenü im Snippet-Editor nutzen, um auf Formatierungswerkzeuge wie Überschrift 2, Kopf 3, Kopf 4, Nummerierte Liste, Mehrebenenliste, Aufzählungsliste, Checkliste, Inline-Code und Codeblock zuzugreifen, und Sie können auch Elemente wie Bild, Video, Link, Tabelle, Teiler, Akkordeon, Callout, Tabs, FAQs, LaTeX einfügen.  und Emoji.

Verwendung von Eddy-KI in Snippet-Inhalten

Während Sie einen Ausschnitt entwerfen, können Sie mit der Maus über den gewünschten Inhalt fahren und mit Eddy AI den Text länger oder kürzer machen, verbessern, den Ton ändern, Sprache konvertieren, die Stimme ändern, Sätze aufteilen oder Elemente wie Tabellen, Kreisdiagramme und Flussdiagramme generieren.

Unten rechts kannst du auch auf die Generator-FAQ und Generator-Zusammenfassung von Eddy AI zugreifen (die Zusammenfassungsoption ist nur für englischsprachige Ausschnitte verfügbar).

Einen Ausschnitt in den Artikel einfügen

Sie können einen Ausschnitt auf zwei Arten in die Artikel einfügen:

Methode 1: Verwendung der Syntax (Markdown-Editor)

Methode 2: Verwendung der Werkzeugleiste (Markdown und WYSIWYG)

Methode 3: Verwendung des Schrägstrichmenüs (Erweiterter WYSIWYG-Editor)

Anzeige der Verwendung von Snippets (Artikel-/Kategorieabhängigkeit)

Um zu sehen, wo ein Ausschnitt verwendet wird:

1. Klicken Sie in der Spalte "Verwendet " auf Ansicht.

2. Das Referenzanzeigen-Panel erscheint. Du wirst sehen:

   • Die Artikelversion.

   • Der Projektarbeitsbereich und die Sprache.

   • Der Team-Kontoname und das Profilbild des Nutzers, der den Ausschnitt hinzugefügt hat.

   • Im Artikel heißt es (Entwurf und veröffentlicht).

   • Die Zeit-/Datuminformation, wann der Ausschnitt auf der Artikel-/Kategorieseite eingefügt wurde.

   • Klicken Sie auf das Symbol , um dieselbe Artikelversion in einem neuen Tab zu öffnen.

Bearbeitung eines Ausschnitts

Um einen Ausschnitt zu bearbeiten:

1. Navigiere zu Documentation () in der linken Navigationsleiste in der Knowledge base portal.

2. Im linken Navigationsfeld gehen Sie zu Content tools > Content reuse > Snippets.

   Die Seite Snippets erscheint. Du findest die Liste der bereits hinzugefügten Ausschnitte.

3. Fahre mit der Maus über den Ausschnitt, den du bearbeiten möchtest, und klicke auf das Symbol Bearbeiten ().

4. Aktualisieren Sie den Inhalt nach Bedarf.

5. Klicken Sie auf Aktualisieren.

ANMERKUNG

Wenn du einen Ausschnitt aktualisierst, werden die Änderungen automatisch in allen Artikeln und Kategorieseiten angezeigt, auf denen er verwendet wird, einschließlich veröffentlichter, ohne dass du sie erneut veröffentlichen musst.

Löschen eines Ausschnitts

Um einen Ausschnitt zu löschen:

1. Navigiere zu Documentation () in der linken Navigationsleiste in der Knowledge base portal.

2. Im linken Navigationsfenster navigieren Sie zu Content tools > Content reuse > Snippets.

   Die Snippets-Seite erscheint. Du findest die Liste der bereits hinzugefügten Ausschnitte.

3. Fahre mit der Maus über den gewünschten Ausschnitt und klicke auf das Löschen ()-Symbol.

4. Klicken Sie im Dialogfeld "Löschen" auf Ja.

5. Um mehrere Schnipsel massenhaft zu löschen, wählen Sie mehrere beabsichtigte Ausschnitte auf der Seite "Schnipseln" aus und klicken Sie oben in der Liste auf die Option "Löschen ()".

ANMERKUNG

• Wenn du einen Ausschnitt löschst, wird er aus allen Artikeln entfernt, in denen er referenziert wird.

• Der Artikel behält seine aktuelle Version bei.

• Auf der Knowledge Base-Seite passt sich der umgebende Inhalt an, sodass kein leerer Platz bleibt, wo der Ausschnitt entfernt wurde.

• Im Portal erscheint ein Ladesymbol im Inhaltsblock, in dem der Ausschnitt entfernt wurde. Du kannst diesen Block auswählen, um einen weiteren Snippet einzufügen, oder den Block manuell löschen.

Übersetzung von Ausschnitten

Sie können Ausschnitte in mehreren Sprachen erstellen, um eine Lokalisierung in Ihrer Wissensdatenbank sicherzustellen.

ANMERKUNG

Globale Schnipsel können nicht übersetzt werden.

Neue Ausschnitte übersetzen

Um einen neuen Ausschnitt während der Erstellung zu übersetzen:

1. Navigiere zu Documentation () in der linken Navigationsleiste in der Knowledge base portal.

2. Im linken Navigationsfenster navigieren Sie zu Content tools > Content reuse > Snippets.

3. Klicken Sie auf Erstellen.

4. Im Dialog "Neuer Ausschnitt erstellen " geben Sie den Namen des Ausschnitts ein, wählen die gewünschte Sprache und wählen Sie Ihren bevorzugten Editor.

5. Klicken Sie auf Erstellen.

6. Im Dropdown-Menü Sprache wählen Sie die gewünschte Sprache für den Ausschnitt aus.

7. Geben Sie den Inhalt in Ihrer gewünschten Sprache ein.

8. Um den Inhalt in andere Sprachen zu übersetzen, klicken Sie auf das Dropdown-Menü "In andere Sprachen übersetzen ".

9. Wählen Sie die gewünschten Sprachen aus der Liste und klicken Sie auf Übersetzen.

ANMERKUNG

• Die Standardsprache wird als Hauptsprache markiert.

• Übersetzte Sprachen zeigen nach Abschluss der Übersetzung ein grünes Häkchen (✔) an.

• Du kannst manuell zu unübersetzten Sprachen wechseln und bei Bedarf Übersetzungen hinzufügen.

10. Klicken Sie auf Speichern , um alle Übersetzungen zu speichern.

Wenn du zum Beispiel einen Ausschnitt für eine Begrüßungsnachricht auf Englisch erstellst, kannst du die Übersetzungsfunktion nutzen, um dieselbe Nachricht auf Französisch, Spanisch, Niederländisch usw. hinzuzufügen.

Übersetzung bestehender Ausschnitte

1. Klicken Sie auf der Seite Snippets auf den gewünschten vorhandenen Snippet, den Sie übersetzen möchten.

2. Navigiere zu Übersetzen in andere Sprachen und wähle die gewünschte Sprache aus, die der Ausschnitt übersetzt werden muss.

3. Klicken Sie auf Übersetzen.

4. Falls nötig, kannst du in andere Sprachen navigieren und erneut in diese übersetzen.

5. Um den Inhalt erneut zu übersetzen, klicken Sie erneut auf Übersetzen. Dadurch wird die bestehende Übersetzung durch eine neue überschrieben.

6. Wenn du den übersetzten Ausschnitt für eine bestimmte Sprache entfernen musst, klicke auf das Symbol More () und wähle Sprache entfernen.

   Du kannst den Inhalt jederzeit neu übersetzen, falls nötig.

Fehlerbehebung

Schnipsel erscheinen nicht im Editor-Menü

Dieses Problem tritt typischerweise auf, wenn ein Ausschnitt in einer Sprache erstellt, aber in einem Artikel in einer anderen Sprache verwendet wird. In Document360 sind Schnipsel sprachspezifisch, sofern sie nicht unter der globalen Spracheinstellung erstellt werden.

Schritte zur Lösung:

• Stellen Sie sicher, dass der Ausschnitt in derselben Sprache wie der Aufsatz verfasst ist, an dem Sie arbeiten.

• Wenn der Ausschnitt in einer anderen Sprache erstellt wurde, verwenden Sie die Option Übersetzen in andere Sprachen , die im Bereich Inhaltswiederverwendung verfügbar ist.

• Nach der Übersetzung wechseln Sie im Artikeleditor zur gewünschten Sprache. Der Ausschnitt sollte jetzt erscheinen, wenn du versuchst, ihn in den Artikel einzufügen.

ANMERKUNG

Schnipartikel, die unter einer bestimmten Sprache erstellt werden, erscheinen nur in Artikeln, die in derselben Sprache verfasst sind.

Sollten die Ausschnitte nach Befolgen der obigen Schritte immer noch nicht erscheinen, kontaktieren support@document360.com Sie bitte die folgenden Details:

• Ein Screenshot des Ausschnitts im Bereich Wiederverwendung von Inhalten.

• Ein Screenshot, der zeigt, dass der Ausschnitt nicht im Artikeleditor erscheint..