Benutzerhandbuch Abbrechen

Veröffentlichen in der Atlassian Confluence-Wissensdatenbank

Suchen

Zuletzt aktualisiert am 28. März 2024

Erfahren Sie, wie Sie Ihre Inhalte direkt in der Atlassian Confluence-Wissensdatenbank veröffentlichen.

Einführung

Die Atlassian Confluence-Wissensdatenbank bietet Teams schnellen und einfachen Zugriff auf Lösungen. Sie bietet eine zugängliche Plattform für das Wissensmanagement mit einfacher Erstellung und Organisation von Inhalten und einer leistungsstarken Suchmaschine für Mitarbeiter und Kunden.

Durch die Integration von Confluence wurden die Veröffentlichungsmöglichkeiten von Adobe RoboHelp erweitert, sodass Artikel jetzt direkt in der Confluence-Wissensdatenbank veröffentlicht werden können.

Voraussetzungen

Um eine Verbindung mit der Confluence-Wissensdatenbank herzustellen, muss Ihre Organisation in Atlassian ein Konto einrichten. Weitere Informationen finden Sie unter Atlassian Support.

Wichtige Ressourcen:

Profile
Einrichten von Konten

Einrichten des Workflows

Im Folgenden finden Sie die Schritte zum Konfigurieren der Confluence-Wissensdatenbank vor der Veröffentlichung Ihrer Ausgabe.

Konfigurieren Sie ein Veröffentlichungsprofil.
Erstellen und konfigurieren Sie eine Ausgabevoreinstellung.

Konfigurieren von Veröffentlichungsprofilen

Sie müssen ein Veröffentlichungsprofil erstellen und konfigurieren, bevor Sie Ihre Ausgabe in der
Confluence-Wissensdatenbank veröffentlichen. So erstellen und konfigurieren Sie ein Profil:

Klicken Sie auf der Symbolleiste auf Bearbeiten > Veröffentlichunsprofile.
Klicken Sie im Dialogfeld Veröffentlichungsprofile auf , um ein Profil zu erstellen.
Wählen Sie im Dropdown-Listenfeld Servertyp die Option Atlassian Confluence aus.
Fügen Sie den Profilnamen für Confluence hinzu.
Es gibt zwei Möglichkeiten, Ihr Profil mit dem Atlassian-Server zu verbinden.

Mithilfe von OAuth

Wählen Sie die Option für OAuth, um eine Verbindung mit der Atlassian-Website herzustellen, und klicken Sie auf Anmelden.

Hinweis:

Dies wird nur für Konten unterstützt, die in Confluence Cloud verfügbar sind.
Über die Website-URL

Geben Sie die Website-URL ein. Beispiel: https://yourdomain.atlassian.net.
- Benutzer-ID: Geben Sie die Benutzer-ID ein, mit der Sie ein Konto bei Atlassian erstellt haben.
- API-Schlüssel: Geben Sie den API-Schlüssel für die Anmeldung ein. Generieren Sie den API-Schlüssel anhand der Informationen unter Manage API tokens for your Atlassian account | Atlassian Support (Verwalten von API-Token für Ihr Atlassian-Konto).
Klicken Sie auf Speichern.

RoboHelp speichert das Profil und zeigt den Profilnamen in der Spalte „Profile“ an.

BEARBEITEN EINES PROFILS

Um ein Profil zu bearbeiten, klicken Sie auf den Profilnamen und bearbeiten Sie die Felder.

LÖSCHEN EINES PROFILS

Um ein Profil zu löschen, klicken Sie in neben dem Profil auf .

Ausgabevorgabe erstellen

So erstellen Sie eine Ausgabevoreinstellung in RoboHelp:

Klicken Sie im Bereich Ausgabevorgaben auf .
Geben Sie im Dialogfeld „Neue Vorgabe“ die folgenden Optionen an:

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

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

Ziel Wählen Sie in der Ziel-Dropdown-Liste Confluence-Wissensdatenbank.
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 Confluence-Wissensdatenbank-Ausgabevorgabe

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

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. Drücken Sie dazu Strg+Umschalt+9 und wählen Sie eine Variable aus der Dropdown-Liste aus. Drücken Sie anschließend die Eingabetaste. Hinweis: Wenn Sie einen Variablensatz auf der Registerkarte „Inhalt“ im Feld Variablensatz angegeben haben, wird der Wert der ausgewählten Variablen während der Ausgabegenerierung aus dem Variablensatz ausgewählt.

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

Stellen Sie sicher, dass sich der Ausgabepfad NICHT im Projektordner befindet. Die Ausgabe kann nicht generiert werden, wenn sich der Ausgabepfad im Projektordner befindet. 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. Hier wird die Liste der von Confluence unterstützten Sprachen angezeigt.

Kodierung: Confluence empfiehlt die Unicode-Kodierung (UTF-8), die standardmäßig ausgewählt wird.

Skript nach der Generierung: Wählen Sie die .js-Skriptdatei aus der Dropdown-Liste aus, um nach der Ausgabegenerierung das benutzerdefinierte Skript auszuführen.

Inhalt

Geben Sie mit den folgenden Optionen inhaltsbezogene Ausgabeeinstellungen wie die Einstellungen für Inhaltsverzeichnis, Bedingungsausdruck und Variablensatz an.

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.

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 Dropdown-Liste 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 Expanding-Titel in die Ausgabe einbezogen.

Inhalt des Dropdowntexts einbeziehen: Wählen Sie diese Option, um Dropdown-Text in Ihre Wissensdatenbank-Ausgabe aufzunehmen. Andernfalls wird nur der Dropdown-Titel in die Ausgabe eingeschlossen.

Hinweis:

Beachten Sie unbedingt, dass Confluence das Hinzufügen von JavaScript oder Cascading Style Sheets (CSS) in den Artikeln nicht zulässt, sodass Ihre Publikation keinen Dropdown-Text, keinen Expanding-Text und keine Miniaturbilder enthalten darf. Wenn diese Elemente dennoch verwendet werden, wird der eingeschlossene Text als einfacher Text beibehalten.

Layout

Konfigurieren Sie mit der Option das Erscheinungsbild Ihrer Ausgabe.

Confluence

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

Bereich: Geben Sie den Bereich ein, in dem der Inhalt veröffentlicht werden soll. Dieser Bereich muss in Ihrer Confluence-Site vorhanden sein.

Seite: Geben Sie die übergeordnete Seite ein, unter der der Inhalt veröffentlicht werden soll. Wenn keine Seite ausgewählt ist, wird der Inhalt im Stammverzeichnis des ausgewählten Bereichs veröffentlicht.

Alle Stile in Inlinestile umwandeln: Mithilfe dieser Option können Sie sicherstellen, dass die in RoboHelp verwendete Formate beibehalten werden, wenn Sie Ihre Ausgabe in Confluence veröffentlichen. Das Anfügen von Stylesheets ist nicht zulässig.

Themenüberschrift aus dem Artikeltext entfernen: Wählen Sie diese Option, um die Themenüberschriften zu entfernen, die in RoboHelp beim Veröffentlichen der Ausgabe in Confluence verwendet werden.

Schlüsselwörter aus Thema als Artikel-Tags verwenden: Wählen Sie diese Option aus, um Suchbegriffe aus dem Thema als Artikel-Tags aus der Ausgabe zu verwenden, die Sie in Confluence veröffentlicht haben.

Hochladen als Entwurf: Wenn Sie diese Option aktivieren, weisen alle in Confluence veröffentlichten Artikel den Entwurfsstatus auf.

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 Dokumenten wie PPT, PPTX, DOC, DOCX und PDF verknüpfte Themen in die veröffentlichte Ausgabe aufgenommen werden sollen.

Artikel

Wählen Sie die Themen aus, die Sie in der Confluence-Wissensdatenbank veröffentlichen möchten. Erweitern Sie einen Knoten im Inhaltsverzeichnis, und wählen Sie die Themen aus, die Sie veröffentlichen möchten.

Wählen Sie Speichern , um die an der Ausgabevorgabe vorgenommenen Änderungen zu speichern.

Veröffentlichen in der Confluence-Wissensdatenbank

Sie können die Ausgabevorgabe Wissensdatenbank so konfigurieren, dass sie mit Confluence verknüpft ist, und dann Ihren Inhalt in der Confluence-Wissensdatenbank veröffentlichen.

Klicken Sie in der Symbolleiste auf die Registerkarte Ausgabe. Es wird eine Liste der vordefinierten Ausgabevorgaben angezeigt.
Wenn Sie eine dieser Vorgaben bearbeiten möchten, doppelklicken Sie im Bereich Ausgabevorgaben auf die gewünschte Ausgabevorgabe.
Sobald Sie die Vorgabe konfiguriert haben, können Sie sie in Confluence veröffentlichen. Wählen Sie das Menüsymbol (...) neben der Vorgabe aus und wählen Sie Veröffentlichen.

Sie können die Einstellungen für die Confluence-Ausgabevorgabe auch bearbeiten, nachdem Sie auf Bearbeiten geklickt haben.
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.
Um in den ausgewählten Profilen (Servern) zu veröffentlichen, wählen Sie die zu veröffentlichenden Artikel auf der Registerkarte „Artikel“ aus. Wählen Sie die Ausgabevorgabe aus und wählen Sie dann in der Standardsymbolleiste. Oder klicken Sie mit der rechten Maustaste auf die Ausgabevorgabe und klicken Sie dann auf Veröffentlichen.
RoboHelp pusht den Inhalt an Confluence. Nach Abschluss der Veröffentlichung zeigt RoboHelp einen Bericht zum veröffentlichten Inhalt an.
Um die veröffentlichte Ausgabe anzuzeigen, wählen Sie das Vorschausymbol aus, um die Vorschau des veröffentlichten Inhalts anzuzeigen.