Benutzerhandbuch Abbrechen

Veröffentlichen im Zendesk-Hilfe-Center

  1. Benutzerhandbuch zu RoboHelp
  2. Einführung
    1. Erste Schritte im RoboHelp-Arbeitsbereich
    2. Neuerungen bei RoboHelp (2022 release)
      1. Neuerungen in Update 5
      2. Neuerungen in Update 4
      3. Neuerungen in Update 3
      4. Neuerungen in Update 2
      5. Neuerungen in Update 1
    3. Behobene Probleme in RoboHelp
    4. Systemanforderungen für RoboHelp
    5. Herunterladen von RoboHelp für Windows und macOS
    6. Herunterladen und Installieren der Adobe-App
    7. Häufig gestellte Fragen zu RoboHelp
    8. Neuerungen bei RoboHelp (2020 release)
      1. Neuerungen in Update 8
      2. Neuerungen in Update 7
      3. Neuerungen in Update 6
      4. Neuerungen in Update 5
      5. Neuerungen in Update 4
      6. Neuerungen in Update 3
      7. Neuerungen in Update 2
      8. Neuerungen in Update 1
  3. Projekte
    1. Planen Ihres RoboHelp-Projekts
    2. Erstellen eines Projekts
    3. Verwalten von Projekten
    4. Arbeiten mit Themen und Ordnern
    5. Generieren von Berichten
    6. Arbeiten mit kontextsensitiver Hilfe
    7. Verwalten von Verweisen
    8. Festlegen von Einstellungen in RoboHelp
  4. Zusammenarbeit mit Autoren
    1. Zusammenarbeit mithilfe von Git
    2. Zusammenarbeit mithilfe von SharePoint Online
    3. Zusammenarbeit mit von Azure DevOps (Team Foundation Server)
  5. PDF-Layout
    1. PDF-Vorlagen
    2. Designen eines Seitenlayouts
    3. PDF-Ausgabe veröffentlichen
    4. Arbeiten mit den gängigen Inhaltsstilen
    5. Komponenten einer PDF-Vorlage
    6. Unterstützung für Sprachvariablen
    7. Anpassen von PDFs
  6. Bearbeiten und Formatieren
    1. Formatieren Ihres Inhalts
    2. Erstellen und Verwalten von Querverweisen
    3. Erstellen und Verwalten von Verknüpfungen
    4. Snippets als Einzelquellenelemente
    5. Arbeiten mit Bildern und Multimedia
    6. Erstellen und Verwenden von Variablen für einfache Updates
    7. Arbeiten mit Variablensätzen
    8. Verwenden des Tools „Suchen und Ersetzen“
    9. Automatisches Speichern Ihrer Inhalte
    10. Bearbeitung nebeneinander in der geteilten Ansicht
    11. Verwenden der Rechtschreibprüfungsfunktion
    12. Erstellen und Bearbeiten von Lesezeichen
    13. Einfügen und Aktualisieren von Feldern
    14. Wechseln zwischen mehreren Ansichten
    15. Automatische Nummerierung in CSS
  7. Importieren und Verknüpfen
    1. Importieren von Markdown-Dateien in ein Projekt
    2. Importieren von Word-Dokumenten in ein Projekt
    3. Importieren von FrameMaker-Dokumenten in ein Projekt
  8. Inhaltsverzeichnisse, Indizes, Glossare und Zitate
    1. Erstellen und Verwalten von Inhaltsverzeichnissen
    2. Erstellen und Verwalten von Indizes
    3. Erstellen und Verwalten eines Glossars
    4. Erstellen und Verwalten von Zitaten
    5. Abfolgen erstellen und verwalten
    6. Arbeiten mit „Siehe auch“ und verwandten Themen
  9. Bedingter Inhalt
    1. Was ist bedingter Inhalt?
    2. Bedingungs-Tags erstellen und anwenden
    3. Konfigurieren von Ausgabevorgaben für bedingten Inhalt
    4. Bedingten Inhalt optimieren und verwalten
  10. Microcontent
    1. Microcontent
  11. Überprüfung und Zusammenarbeit
    1. Überprüfung und Zusammenarbeit
  12. Übersetzung
    1. Übersetzen von Inhalten in mehrere Sprachen
    2. Konfigurieren eines Übersetzungsframeworks für einen Dienstleister
  13. Generieren der Ausgabe
    1. Generieren der Ausgabe
    2. Generieren einer Frame-los-Ausgabe
    3. Generieren der Wissensdatenbankausgabe
    4. Generieren von PDF-Ausgabe
    5. Generieren einer interaktiven HTML5-Ausgabe
    6. Generieren einer Worddokument-Ausgabe
    7. Generieren einer „Nur Inhalt“-Ausgabe
    8. Generieren einer E-Book-Ausgabe
    9. Generieren einer Microsoft HTML Help-Ausgabe in RoboHelp
    10. Generieren einer App-Ausgabe
  14. Ausgabe veröffentlichen
    1. Veröffentlichen auf einem RoboHelp-Server
    2. Veröffentlichen auf einem FTP-Server, einem sicheren FTP-Server oder einem Dateisystem
    3. Veröffentlichen in SharePoint Online
    4. Veröffentlichen im Zendesk-Hilfe-Center
    5. Veröffentlichen in der Salesforce-Wissensdatenbank
    6. Veröffentlichen in der ServiceNow-Wissensdatenbank
    7. Veröffentlichen in der Zoho-Wissensdatenbank
    8. Veröffentlichen in Adobe Experience Manager
    9. Veröffentlichen in der Atlassian Confluence-Wissensdatenbank
  15. Anhang
    1. Adobe RoboHelp Scripting-Referenz
    2. RoboHelp-Tastaturbefehle

Erfahren Sie, wie Sie Ihre Inhalte direkt im Zendesk-Hilfe-Center veröffentlichen.

Musterseiten, die in der PDF- oder Word-Ausgabevorlage verwendet werden, wurden in "Seitenlayout" umbenannt.

Musterseiten, die für Themenvorlagen oder Onlineausgaben verwendet werden, wurden in "Themenlayouts" umbenannt.

Weitere Informationen finden Sie unter Vorlagen in Adobe RoboHelp.

Adobe RoboHelp erweitert seine Veröffentlichungsfunktionen und bietet Ihnen die Möglichkeit der Veröffentlichung als Wissensdatenbankausgabe direkt im Zendesk-Hilfe-Center.

Voraussetzungen

Um eine Verbindung mit dem Zendesk-Hilfe-Center herzustellen, müssen Sie Ihr Konto einrichten, um loszulegen. Weitere Informationen finden Sie unter Erste Schritte mit Zendesk.

Stellen Sie außerdem sicher, dass die Option API-Authentifizierung mit der E-Mail-Adresse und dem Kennwort eines Agenten aktivieren auf der Registerkarte Einstellungen in der Zendesk-API auf der Zendesk-Seite aktiviert ist.

Einrichten des Workflows

Im Folgenden finden Sie die Schritte zum Konfigurieren des Zendesk-Hilfe-Centers vor der Veröffentlichung Ihrer Ausgabe.

Ausgabevorgabe erstellen

Gehen Sie wie folgt vor, um eine Ausgabevorgabe in RoboHelp zu erstellen:

  1. Führen Sie in einem geöffneten Projekt einen der folgenden Schritte aus:

    • Klicken Sie auf der linken Seite der Standardsymbolleiste auf die Registerkarte Ausgabe.
    • Klicken Sie in der Standardsymbolleiste in der rechten oberen Ecke auf Schnell erstellen  und dann auf das Symbol Einstellungen bearbeiten .

    Die Ansicht „Ausgabe“ wird geöffnet.

  2. Klicken Sie in der Symbolleiste „Ausgabe“ auf Ausgabevorgaben.Daraufhin wird der Bereich „Ausgabevorgaben“ geöffnet.

  3. Klicken Sie im Bereich Ausgabevorgaben auf .

  4. Geben Sie im Dialogfeld „Neue Vorgabe“ die folgenden Optionen an:

    Typ Wählen Sie in der Dropdown-Liste den voreingestellten Wissensdatenbank-Typ aus.

    Name Geben Sie einen Namen für die Ausgabevorgabe an.

    Ziel Wählen Sie in der Dropdown-Liste Zendesk-Hilfe-Center.

  5. Klicken Sie auf Fertig.

    Sie haben im Bereich Ausgabevorgaben in der Symbolleiste Ausgabe Zugriff auf die Ausgabevorgaben. Stattdessen können Sie auch im Dialogfeld Schnell erstellen des Authoring-Fensters auf die Ausgabevorgabe zugreifen.

Konfigurieren einer Zendesk-Ausgabevorgabe

Sie können mit den folgenden Einstellungen die Ausgabevorgabe Wissensdatenbank konfigurieren:

Allgemein

Titel: Geben Sie den Titel für die generierte Ausgabe an.

Ausgabepfad: Geben Sie einen Speicherort für die Ausgabe an.

Stellen Sie sicher, dass sich der Ausgabepfad NICHT im Projektordner befindet.Wenn sich der Ausgabepfad im Projektordner befindet, schlägt die Ausgabegenerierung fehl. Außerdem sollte der von Ihnen ausgewählte Ordner KEINE Inhalte enthalten, die Sie benötigen. RoboHelp löscht den Inhalt des Ordners, bevor die Ausgabe generiert wird.

Ausgabepfad relativ zum Projekt speichern: Wenn diese Option aktiviert ist und Sie zum Ausgabepfad navigieren, ist der Pfad zur Ausgabe nun ein relativer statt ein absoluter Wert. 

Sprache: Wählen Sie die Sprache für die Ausgabe aus der Dropdownliste aus.

Hinweis: Die Sprache in Zendesk muss mit der Sprache übereinstimmen, die Sie in RoboHelp auswählen. Wenn Sie beispielsweise Französisch (Frankreich) in RoboHelp ausgewählt haben, müssen Sie in Zendesk Französisch (Frankreich) auswählen, nicht Französisch oder Französisch (Kanada), sondern einzig und allein Französisch (Frankreich). Die Sprache in beiden Programmen muss übereinstimmen, sonst kommt es zu Fehlern bei der Veröffentlichung.

Kodierung: Wählen Sie in der Dropdown-Liste die Kodierung aus, die für die Ausgabe verwendet werden soll. Geben Sie den Typ des Zeichenkodierungsformats an, der für Ihren Inhalt verwendet werden soll.

Skript nach der Generierung: Um Ihr benutzerdefiniertes Skript nach der Ausgabegenerierung auszuführen, wählen Sie die Skriptdatei in der Dropdownliste aus.

Allgemein

Geben Sie mit den folgenden Optionen grundlegende Ausgabeeinstellungen wie Titel, Ausgabepfad, Kodierung usw. an.

Titel Geben Sie den Titel für die generierte Ausgabe an.

Sie können Variablen im Titel verwenden. Geben Sie dazu STRG+1 ein, und wählen Sie eine Variable aus der Dropdown-Liste aus. Drücken Sie anschließend die Eingabetaste. Wenn Sie während der Ausgabegenerierung einen Variablensatz auf der Registerkarte „Inhalt > Variablensatz“ angegeben haben, wird der Wert der ausgewählten Variablen aus dem Variablensatz ausgewählt.

Ziel Geben Sie mithilfe der Dropdown-Liste das Ziel zum Generieren der ausgewählten Ausgabe in der „Wissensdatenbank“ an.

Ausgabepfad Geben Sie einen Speicherort für die Ausgabe an. Um einen Speicherort auszuwählen, klicken Sie auf .

Stellen Sie sicher, dass sich der Ausgabepfad NICHT im Projektordner befindet.Wenn sich der Ausgabepfad im Projektordner befindet, schlägt die Ausgabegenerierung fehl. Außerdem sollte der von Ihnen ausgewählte Ordner KEINE Inhalte enthalten, die Sie benötigen. RoboHelp löscht den Inhalt des Ordners, bevor die Ausgabe generiert wird.

Ausgabepfad relativ zum Projekt speichern: Wenn diese Option aktiviert ist und Sie zum Ausgabepfad navigieren, ist der Pfad zur Ausgabe nun ein relativer statt ein absoluter Wert.  

Kodierung Wählen Sie in der Dropdown-Liste den Typ des Zeichenkodierungsformats aus, der für Ihren Inhalt verwendet werden soll.

Skript nach der Generierung Um Ihr benutzerdefiniertes Skript nach der Ausgabegenerierung auszuführen, wählen Sie die .js-Skriptdatei in der Dropdownliste aus.

Inhalt

Geben Sie mit den folgenden Optionen inhaltsbezogene Ausgabeeinstellungen an, z. B. Einstellungen für Inhaltsverzeichnis, Bedingungsausdruck, Variablensatz und Einschließen von Expanding- und Dropdowntext.

Inhaltsverzeichnis Wählen Sie in der Dropdownliste das Inhaltsverzeichnis aus, das in der Ausgabe enthalten sein soll. Diese Dropdownliste zeigt die in Ihrem Projekt verfügbaren Inhaltsverzeichnisse an. Das erste Inhaltsverzeichnis in dieser Dropdownliste ist standardmäßig ausgewählt.

Der Satz von Dateien und ihre Referenzen, die im ausgewählten Inhaltsverzeichnis enthalten sind, werden in der generierten Ausgabe angezeigt.

Hinweis:

Sie müssen verstehen, wie Sie Ihre Publikation den Kategorien und Abschnitten in Zendesk zuordnen. Weitere Informationen zum Zuordnen finden Sie unter Konfigurieren des Inhaltsverzeichnisses für Zendesk.

Bedingungsausdruck Geben Sie mithilfe der Dropdownliste den Bedingungsausdruck für Ihre Ausgabe an. Mit dieser Einstellung können Sie Inhalte abhängig vom gewünschten Ausgabetyp oder von der Benutzerbasis einfach ein- oder ausschließen. Klicken Sie auf , um den ausgewählten Bedingungsausdruck zu bearbeiten. Sie können in der Dropdown-Liste auch „Keine“ auswählen, um keinen Bedingungsausdruck anzugeben.

Variablensatz Geben Sie mithilfe der Dropdownliste den Variablensatz für Ihre Ausgabe an. In der Dropdownliste können Sie <Standardvariablensatz> auswählen, um den Standardvariablensatz des Projekts zu verwenden. Mit Variablensätzen können Sie die ausgabenspezifische Verwendung von Variablen implementieren. Sie können beispielsweise verschiedene Variablensätze zum Generieren von Ausgaben für Kunden und interne Benutzer verwenden.

Inhalt des Expanding-Texts einbeziehen Wählen Sie diese Option, um Expanding-Text in Ihre „Wissensdatenbank“-Ausgabe aufzunehmen. Andernfalls wird nur der erweiternde Titel in die Ausgabe aufgenommen. Der Expanding-Text wird jedoch in der erweiterten Form in der Ausgabe angezeigt.

Dropdown-Textinhalt einschließen Wählen Sie diese Option, um Dropdown-Text in Ihre „Wissensdatenbank“-Ausgabe aufzunehmen. Andernfalls wird nur der Dropdown-Titel in die Ausgabe aufgenommen. Der Dropdown-Text wird jedoch in der Ausgabe angezeigt.

Layout

Konfigurieren Sie mit der Option das Erscheinungsbild Ihrer Ausgabe.

Zendesk

Geben Sie mit den folgenden Optionen Zendesk-Veröffentlichungseinstellungen an, z. B. „Veröffentlichungsprofil“, „Sichtbar für“, „Verwaltet von“:

Veröffentlichungsprofil Wählen Sie in der Dropdown-Liste Ihr Zendesk-Verbindungsprofil aus. Informationen zum Erstellen eines Veröffentlichungsprofils finden Sie unter Konfigurieren von Veröffentlichungsprofilen.

Sichtbar für Klicken Sie auf die Dropdown-Liste, um eine Gruppe von Benutzern auszuwählen, um die Sichtbarkeitseinstellungen Ihrer veröffentlichten Inhalte zu steuern. Die Ansichtsberechtigungen werden auf dem Zendesk-Server abhängig von Ihrem Zendesk-Konto festgelegt.

Verwaltet von Klicken Sie auf den Dropdown-Pfeil, und wählen Sie dann Verwaltungsberechtigungen aus, um zu bestimmen, wer Bearbeitungs- und Veröffentlichungsrechte haben kann. Diese Verwaltungsberechtigungen werden auf dem Zendesk-Server in Abhängigkeit von Ihrem Zendesk-Konto vorgeneriert. 

Alle Artikel in derselben Kategorie veröffentlichen Wählen Sie diese Option aus, um alle Themen des Inhaltsverzeichnisses in einer einzigen Kategorie und einem Abschnitt auf der Zendesk-Website zu veröffentlichen. Weitere Informationen zu Kategorien und Abschnitten finden Sie unter Organisieren von Wissensdatenbankinhalten in Kategorien und Abschnitten.

Alle Stile in Inlinestile umwandeln Wählen Sie diese Option aus, um sicherzustellen, dass die in RoboHelp verwendete Stile beibehalten werden, wenn Sie Ihre Ausgabe in Zendesk veröffentlichen.

Bilder hochladen Wählen Sie diese Option aus, wenn Bilder in Themen in die veröffentlichte Ausgabe aufgenommen werden sollen.

Verknüpfte Dokumente hochladen Wählen Sie diese Option, wenn in Themen verknüpfte Dokumente wie PPT, PPTX, DOC, DOCX und PDF in die veröffentlichte Ausgabe aufgenommen werden sollen.

Javascript einbeziehen Wählen Sie diese Option aus, um JavaScript in Ihre Ausgabe aufzunehmen, um erweiternden Text, Dropdown-Text, Popups und Miniaturansichten anzuzeigen. Wenn diese Option deaktiviert ist, wird der Inhalt als einfacher Text angezeigt, wenn er auf der Website veröffentlicht wird.

Hinweis:

Zendesk lässt standardmäßig keine JavaScript-Inhalte in Artikeln zu. Sie können sie jedoch in Zendesk aktivieren, indem Sie zu Handbucheinstellungen -> Sicherheit -> „Unsichere Inhalte anzeigen“ aktivieren navigieren.

Konfigurieren von Veröffentlichungsprofilen

Sie müssen ein Profil erstellen und konfigurieren, bevor Sie Ihre Ausgabe in Zendesk veröffentlichen. So erstellen und konfigurieren Sie ein Profil:

  1. Wählen Sie Bearbeiten > Veröffentlichungsprofile.

    Das Dialogfeld Veröffentlichungseinstellungen wird geöffnet.

  2. Klicken Sie auf , um ein Profil zu erstellen.

  3. Wählen Sie im Feld Servertyp die Option Zendesk-Hilfe-Center.

  4. Gehen Sie für den Servertyp Zendesk-Hilfe-Center wie folgt vor:

    • Name Zeigt den Standardprofilnamen an. Ändern Sie gegebenenfalls den Namen.
    • Website-URL Fügen Sie einen Websitenamen hinzu, um die Website-URL abzuschließen.Der Anfang der URL enthält die Domäne Ihrer Organisation.
                   Beispiel: https://companyname.zendesk.com/
    •  Benutzer-ID Geben Sie die Benutzer-ID an.
    • Kennwort Geben Sie das Kennwort für diesen Benutzer an.
  5. Klicken Sie auf Speichern.

    RoboHelp speichert das Profil und zeigt den Profilnamen in der Spalte Profile an. Um ein Profil zu bearbeiten, klicken Sie auf den Profilnamen und bearbeiten Sie die Felder. Um ein Profil zu löschen, klicken Sie für die Farbe auf .

Konfigurieren der Struktur des Inhaltsverzeichnisses für das Zendesk-Hilfe-Center

Im letzten Schritt vor der Veröffentlichung überprüfen Sie, ob Ihr Inhaltsverzeichnis dazu organisiert ist, Ihre Inhalte in Kategorien und Abschnitten zu veröffentlichen, wobei Sie die folgenden Richtlinien berücksichtigen:

  • Da die oberste Ebene des Inhaltsverzeichnisses in Kategorien und die zweite Ebene in Abschnitte konvertiert wird, sollten Sie ein zweistufiges Inhaltsverzeichnis erstellen.
  • Veröffentlichte Artikel, die nicht in diese Struktur fallen, werden in Kategorien und Abschnitte umgeordnet.
Zweistufiges Inhaltsverzeichnis
Eine Illustration des zweistufigen Inhaltsverzeichnisses

Veröffentlichen im Zendesk-Hilfe-Center

Sie können die Ausgabevoreinstellung „Wissensdatenbank“ so konfigurieren, dass sie mit Zendesk verknüpft ist, und dann Ihre Inhalte im Zendesk-Hilfe-Center veröffentlichen.

  1. Klicken Sie auf die Registerkarte Ausgabe in der Standard-Symbolleiste.In der Symbolleiste Ausgabevorgaben ist die Standardauswahl in der Ausgabesymbolleiste. 

  2. Doppelklicken Sie im Bereich Ausgabevorgaben auf eine Ausgabevoreinstellung, um sie zu bearbeiten.

  3. Klicken Sie im Ausgabevoreinstellungseditor auf die Registerkarte Veröffentlichen, um das in der Zendesk-Registerkartenkonfiguration ausgewählte Profil anzuzeigen.

    Sie können die Serverinformationen auch im Dialogfeld Profil veröffentlichen bearbeiten, das Sie durch Klicken auf starten können. 

  4. Wählen Sie die Profile (Server) aus, auf denen Sie Inhalte veröffentlichen möchten.

  5. Klicken Sie im Bereich „Ausgabevorgaben“ auf das Symbol „Vorgabe generieren“ 

    Sie können dann einen Fortschrittsbalken neben der ausgewählten Ausgabevorgabe im Bereich „Ausgabevorgaben“ anzeigen. Sobald die Ausgabegenerierung abgeschlossen ist, wird in der unteren rechten Ecke des Bildschirms das Dialogfeld „Erfolg“ angezeigt. 

    Klicken Sie nach Abschluss der Ausgabegenerierung im Bereich „Ausgabevorgaben“ auf , um die Ausgabe anzuzeigen.

  6. Um in den ausgewählten Profilen (Servern) zu veröffentlichen, klicken Sie auf die Ausgabevorgabe und dann in der Standardsymbolleiste auf . Oder klicken Sie mit der rechten Maustaste auf die Ausgabevorgabe, und klicken Sie auf Veröffentlichen.

  7. RoboHelp pusht den Inhalt an Zendesk. Nach Abschluss der Veröffentlichung zeigt Robohelp einen Bericht über den veröffentlichten Inhalt an.

  8. Um die veröffentlichte Ausgabe anzuzeigen, klicken Sie auf das -Symbol, um zur Landingpage des Zendesk-Hilfe-Center zu gelangen, wo Sie zu Ihrem Artikel navigieren können.

Schneller und einfacher Hilfe erhalten

Neuer Benutzer?