Skip to main content

Netlify-Integration

Zusammenfassung

Sie können Inhalte direkt aus Paligo zu Netlify hochladen. Richten Sie die Paligo-to-Netlify-Integration so ein, dass Paligo eine Verbindung zu Netlify herstellen kann. Anschließend können Sie eine Veröffentlichung zu einem Netlify-Projekt ausführen.

Paligo logo with an arrow pointing to the netlify logo

Paligo unterstützt das direkte Veröffentlichen zur Webhosting-Plattform Netlify. Das bedeutet, dass Sie HTML5-Inhalte in Paligo erstellen können, z. B. ein HTML5-Helpcenter, und direkt zu Netlify veröffentlichen können. Die Integration unterstützt nur HTML5-Ausgaben.

Bevor Sie Paligo mit Netlify verbinden können, benötigen Sie ein Netlify-Konto mit einem persönlichen Zugriffs-Token (Personal Access Token, PAT). Informationen zum Erstellen eines persönlichen Zugriffs-Tokens finden Sie in der offiziellen Netlify-Dokumentation.

Außerdem benötigen Sie eine Site-ID. Wir erklären, wie Sie die Site-ID in Erstmaliges Veröffentlichen zu Netlify erhalten.

Erstmaliges Veröffentlichen zu Netlify

Um Paligo mit Netlify zu verbinden, müssen Sie eine Site in Netlify einrichten, damit Sie die Site-ID erhalten können. Wenn Sie zum ersten Mal zu Netlify veröffentlichen, haben Sie drei Optionen (in Netlify):

  • Importieren eins vorhandenen Projekts aus Git

  • Starten über eine Netlify-Vorlage

  • Manuelle Bereitstellung

Wir empfehlen Ihnen, die Site für Ihre Paligo-Publikation manuell zu erstellen. Gehen Sie hierzu wie folgt vor:

  1. Erstellen Sie in Paligo die Publikation, die Sie zu Netlify veröffentlichen möchten.

  2. Veröffentlichen Sie diese als reguläre Ausgabe mit einem geeigneten Layout. Sie können sie beispielsweise als HTML5-Helpcenter mit einem HTML5-Helpcenter-Layout veröffentlichen. Informationen zum Veröffentlichen finden Sie unter Inhalte veröffentlichen.

    Bei der Veröffentlichung erhalten Sie eine Zip-Datei, die in Ihren Browser heruntergeladen wird.

  3. Navigieren Sie in Netlify zu Ihren Sites und wählen Sie Neue Site hinzufügen aus. Wählen Sie die Option Manuell bereitstellen aus und ziehen Sie dann Ihre Paligo-Ausgabe-Zip-Datei per Drag-and-Drop in Netlify.

    Netlify wird die Zip-Datei hochladen und verarbeiten und eine neue Site für Sie erstellen. Sie erhält einen automatisch generierten Namen, den Sie jedoch in Netlify ändern können, wenn notwendig.

  4. Wählen Sie die Site aus und rufen Sie ihre Site-Einstellungen auf.

    Site panel in Netlify. It has a Site settings button.

    In den Site-Informationen gibt es eine Site-ID. Kopieren Sie die Site-ID, da Sie diese für die Einrichtung der Paligo-Integration benötigen.

    Site details in Netlify. There is a Site ID entry that you need to copy so that it can be pasted into Paligo's Netlify integration settings.

Da Sie jetzt eine Site und eine Site-ID besitzen, können Sie Paligo für die Verbindung mit Netlify einrichten. Wenn die Verbindung hergestellt ist, können Sie Inhalte aus Paligo zu Netlify veröffentlichen und müssen nicht länger Zip-Dateien per Drag-and-Drop kopieren.

Verbinden von Paligo mit Netlify

So verbinden Sie Paligo mit Netlify:

  1. Melden Sie sich bei Paligo über ein Benutzerkonto mit Administratorberechtigungen an.

  2. Melden Sie sich bei Paligo über ein Benutzerkonto mit Administratorberechtigungen an.

  3. Wählen Sie den Avatar in der oberen rechten Ecke aus. User avatar. It shows the user's image and their name. Next to the name is a downward pointing arrow, which when selected, reveals a menu.

  4. Wählen Sie im Menü Einstellungen aus. Cog icon.

  5. Wählen Sie die Registerkarte Integrationen. Jigsaw piece icon.

    Paligo settings. The Integrations tab is highlighted.

  6. Suchen Sie die Netlify-Einstellungen und wählen Sie Hinzufügen aus.

    Die Schaltfläche Hinzufügen wird nur angezeigt, wenn aktuell keine Einstellungen vorhanden sind. Wenn Einstellungen vorhanden sind, wird stattdessen die Schaltfläche Ändern angezeigt.

    Paligo zeigt die Netlify-Integrationseinstellungen an.

    Netlify integration settings in Paligo. There is a Personal Access Token field and a Site ID field.

  7. Generieren Sie in Netlify ein persönliches Zugriffs-Token (Personal Access Token, PAT) für Ihr Benutzerkonto, kopieren Sie es und fügen Sie es dann in das Feld Persönliches Zugriffs-Token in Paligo ein.

    Informationen zum Erstellen eines persönlichen Zugriffs-Tokens finden Sie in der offiziellen Netlify-Dokumentation.

    Anmerkung

    Wenn Sie einen persönlichen Zugriffsschlüssel erstellen, können Sie den Schlüssel nur sehen und kopieren, wenn Sie ihn erstellen. Anschließend ist er nicht mehr verfügbar. Wenn Sie ihn erstellen, müssen Sie ihn daher kopieren und in Paligo einfügen, während Sie die Einstellungen in Netlify noch geöffnet haben.

  8. Geben Sie die Site-ID ein.

    Die Site-ID definiert den Ort, an dem der Inhalt aus Paligo empfangen wird. Sie finden Sie unter Sites > Site-Übersicht > Site-Einstellungen in Netlify.

    Site details in Netlify. There is a Site ID entry that you need to copy so that it can be pasted into Paligo's Netlify integration settings.

    Anmerkung

    Die Site-ID, die Sie hier eingeben, wird als Standard verwendet, wenn Sie von Paligo zu Netlify veröffentlichen. Sie können bei der Veröffentlichung eine andere Site-ID auswählen, wenn notwendig (siehe In Netlify veröffentlichen).

  9. Drücken Sie Speichern.

  10. Wählen Sie die Schaltfläche Ändern für die Integration aus.

  11. Wählen Sie Testeinstellungen aus, um einen Verbindungstest durchzuführen.

    Test_Reset_Settings_Integrations_small.jpg

  12. Lautet Ihre Einstellung:

    • Richtig, zeigt Paligo eine grüne Erfolgsmeldung an.

    • Falsch, zeigt Paligo eine rote Fehlermeldung an.

      Überprüfen Sie jede Verbindungseinstellung sorgfältig, um sicherzustellen, dass Sie keine Fehler gemacht haben, und versuchen Sie es erneut.

      Wenn der Verbindungstest weiterhin fehlschlägt, wenden Sie sich an den Paligo-Support, um Unterstützung zu erhalten.

Wenn die Verbindung hergestellt ist, können Sie In Netlify veröffentlichen.

In Netlify veröffentlichen

Bevor Sie von Paligo zu Gitlab veröffentlichen können, benötigen Sie Folgendes:

Wenn diese vorhanden sind, können Sie Ihre Inhalte in Paligo veröffentlichen. Sie werden automatisch zu einer Netlify-Site hochgeladen.

  1. Wählen Sie das gepunktete Menü (...) für das Topic oder die Publikation im Content Manager aus.

    selectpublish.png

  2. Wählen Sie Veröffentlichen aus. Publish_button_small.png

    publish-document-jan23.png

    Paligo zeigt das Dialogfeld Dokument veröffentlichen an.

  3. Wählen Sie den Ausgabetyp, den Sie veröffentlichen möchten (z. B. PDF, HTML, HTML5, Word, XML, eLearning, SCORM usw.).

  4. Wählen Sie das Layout, das für Ihre Ausgabe verwendet werden soll.

  5. Wählen Sie die zu veröffentlichenden Sprachversionen aus.

    Languages section of Publish document dialog. There are options for each language. English UK and Swedish are selected.

    Anmerkung

    Wenn keine Übersetzungen verfügbar sind, wird nur die Ausgangssprache angezeigt. Bei mehreren genehmigten Übersetzungen in verschiedene Sprachen können Sie auswählen, welche Sie mit aufnehmen möchten. Paligo veröffentlicht jede Sprachversion als separate Ausgabe.

    Bei der PDF-Ausgabe können Sie sie als eine einzige, mehrsprachige Publikation veröffentlichen; aktivieren Sie hierzu das Kontrollkästchen Ausgewählte Sprachen kombinieren.

  6. [en] If your content is set up to use Filterung/Profiling, use the Profiling attributes section to apply them. [Optional]. If you do not use filtering, ignore this setting.

    [en] Select Edit and then choose the value for each filter that you want Paligo to use. For example, for Audience, choose Expert to include content that is marked as for expert users.

    Wenn Sie keinen Filter anwenden möchten, lassen Sie das Feld leer.

    Profiling attributes dialog. Outputformat is set to include HTML.

    Wählen Sie OK aus, um das/die gewählte(n) Profiling-Attribut(e) hinzuzufügen.

    Profiling attributes section of Publish document dialog. Shows Outputformat: HTML selected.

  8. Aktivieren Sie im Abschnitt Upload-Ausgabe das Kontrollkästchen Zu Netlify hochladen.

    Standardmäßig lädt Paligo die Ausgabe zu der Site hoch, die in den Paligo-to-Netlify-Integrationseinstellungen angegeben ist.

    Upload output settings in the publishing settings. The Upload to Netlify box is checked.

    Sie können die Inhalte auch zu einer anderen Site veröffentlichen, wenn erforderlich. Wählen Sie das Symbol Bearbeiten neben Zu Netlify hochladen aus und geben Sie dann im Netlify-Dialogfeld die Site-ID ein. Sie finden die Site-ID in den Site-Einstellungen in Netlify. Die von Ihnen ausgewählten Einstellungen werden nur für diesen einzelnen Veröffentlichungsprozess verwendet. Jede zukünftige Veröffentlichung wird die Site verwenden, die in den Integrationseinstellungen definiert ist.

    Netlify dialog for choosing which site to publish to.

  9. Im Abschnitt Ausgabedateiname können Sie den Dateinamen verwalten.

    Standardmäßig verwendet Paligo die in den Systemeinstellungen festgelegte Dateinamensyntax.

    Output filename section. There is a Template field that contains the values ID, Title, and Format. In the top-right corner is a preview of the filename that Paligo will generate if the current settings are used.

    Um die im Dateinamen enthaltenen Angaben zu ändern, geben Sie Ihr gewünschtes Format in den Publikationseinstellungen ein. Die Standardeinstellung lautet: ID-Title-Format.

    Sie können folgende Angaben in den Namen aufnehmen:

    • ID - Die ID des Dokuments.

    • Titel - Der Titel der Publikation oder des Topics, das Sie veröffentlichen.

    • Format - Der Name des Ausgabeformats, zum Beispiel PDF oder HTML5.

    • Bearbeitungsdatum - Das Datum, an dem die Publikation oder das Topic zuletzt bearbeitet wurde.

    • Label der Verzweigung – Der Text aus dem Label der Verzweigung für die Publikation oder das Topic. Dies gilt nur, wenn Ihre Inhalte verzweigt wurden und die Verzweigung über ein Label verfügt. Details hierzu finden Sie unter Beschriftungen für Zweige hinzufügen oder bearbeiten.

    • Eindeutiger Wert - Eine von Paligo generierte zufällige Zeichenfolge, die dem Dateinamen hinzugefügt wird, um ihn einzigartig zu machen. Dadurch kann verhindert werden, dass die Datei durch spätere Veröffentlichungen desselben Dokuments überschrieben wird.

    Tipp

    Wenn Sie @ in das Feld eingeben, zeigt Paligo eine Liste der verfügbaren Werte an, aus denen Sie wählen können. Um einen Wert zu entfernen, klicken Sie ihn an und verwenden Sie die Löschtaste oder Rücktaste, um alle Zeichen zu entfernen.

    Anmerkung

    Der in der oberen rechten Ecke angezeigte Dateiname ist eine Vorschau auf den Dateinamen, den Paligo bei der Veröffentlichung verwendet.

  10. Legen Sie die optionalen Parameter fest (lassen Sie das Kontrollkästchen deaktiviert, wenn Sie diese Funktionen nicht wünschen):

    • Speichern Sie die Ausgabe in Paligo - Aktivieren Sie das Kontrollkästchen, um die Zip-Datei in der Ressourcenübersicht zu speichern. Deaktivieren Sie das Kontrollkästchen, wenn Paligo nur die veröffentlichte Ausgabedatei in Ihrem Browser herunterladen soll.

    • E-Mail an mich - Aktivieren Sie dieses Kontrollkästchen, wenn Paligo Ihnen eine E-Mail schicken soll, wenn die Publikation bereit ist. Dies ist bei sehr großen Publikationen von Vorteil, deren Verarbeitung und Veröffentlichung länger dauern können.

    • Debug-Build erstellen - Aktivieren Sie dieses Kontrollkästchen, wenn Paligo eine Protokolldatei und einen Link-Bericht einfügen soll. Wenn Ihre Inhalte ein Problem verursachen, kann der Paligo Support Sie bitten, diese Funktion zu aktivieren, damit er die Protokolldateien zur Ermittlung der Ursache nutzen kann.

  11. Wählen Sie Dokument veröffentlichen aus.

    Paligo beginnt mit der Verarbeitung Ihrer Inhalte und wendet Ihre Layout- und Publikationseinstellungen an. Die benötigte Zeit ist von dem Umfang der Inhalte abhängig, die Sie veröffentlichen (je mehr Inhalte, desto länger dauert der Vorgang).

    Publish_Progress_Bar_small.jpg

    Ein Fortschrittsbalken zeigt Ihnen an, wie viel der Verarbeitung Paligo bereits abgeschlossen hat und wie viel noch zu tun ist. Wenn die Verarbeitung abgeschlossen ist, wird eine Benachrichtigung angezeigt.

    Die veröffentlichte Ausgabe erscheint wie folgt:

    • Eine Zip-Datei mit der veröffentlichten Ausgabe erscheint im Ordner Downloads auf Ihrem Computer.

      Wenn Sie die Einstellungen Ihres Browsers geändert haben, um heruntergeladene Dateien an einem anderen Ort zu speichern, befindet sich die Zip-Datei stattdessen dort.

      Wenn Sie eine Publishing-Integration verwenden, wird die Zip-Datei auch an den entsprechenden Dienst gesendet.

    • Ein Link im Panel Aktivitätsfeed zum Herunterladen der veröffentlichten Inhalte.

    Anmerkung

    Um die Inhalte online zur Verfügung zu stellen, entpacken Sie zunächst die Datei. Sie können die Datei dann lokal verwenden oder einen FTP-Client wie Filezilla verwenden, um den entpackten Inhalt auf einen Webserver hochzuladen.

    Tipp

    Sie können Ihre Publikationseinstellungen speichern und wiederverwenden, um einen reibungsloseren Publikationsprozess zu erreichen, siehe Publikationseinstellungen. Alle gespeicherten Einstellungen können auch für [en] Batch Publishing verwendet werden.

    Publish document dialog has a Save Settings option and a Saved Settings tab. The option saves the currently shown settings and these can then be selected in a single action on the tab.