Über Import und Export
Mit Paligo können Sie bestehende Inhalte in verschiedenen Formaten importieren, darunter HTML, DocBook, DITA, Microsoft Word, Paligo Export Format (XML), Atlassian Confluence, MadCap Flare, Zendesk Guide (Helpcenter) und mehr. Einige können direkt importiert werden, in anderen Fällen müssen Sie die Inhalte zunächst in ein anderes Format konvertieren und dann importieren.
Was von einem Format in ein anderes importiert werden kann, unterliegt stets einigen Einschränkungen; einige Importformate funktionieren besser als andere. Generell gilt: Je strukturierter das Legacy-Format, desto vollständiger der Import.
Wenn ein Import zu groß ist, empfiehlt Paligo, den Import in kleinere Pakete aufzuteilen. Variablensätze, die in früheren Importen enthalten waren, werden dupliziert, sofern keine Variablensatz-ID in „Einem vorhandenen Variablensatz zuordnen“ eingegeben wird, siehe Importassistenten verwenden und Variablensatz-ID finden.
Sie können jedoch nur einen Variablensatz zuordnen. Bei einem Import mit mehreren Variablensätzen werden also die anderen dennoch dupliziert. Daher bietet es sich an, vor dem Export von Inhalten:
-
Die Variablensätze zu einem zusammenzuführen oder
-
Einen Variablensatz pro Importpaket zu verwenden
Warnung
Ein Import ist nicht dasselbe wie eine Migration, sondern ein Tool, das den Migrationsprozess deutlich beschleunigt. Jeder Import muss jedoch immer manuell überprüft werden, um sicherzustellen, dass keine Inhalte fehlen oder in irgendeiner Weise fehlerhaft sind.
Anmerkung
Wenn Sie Inhalte importieren, erstellt Paligo nicht automatisch einen Snapshot der importierten Inhalte. Paligo empfiehlt, immer einen Snapshot in der Ressourcenansicht erstellen der importierten Inhalte zu erstellen, um eine archivierte Version zum Vergleich mit den von Ihnen vorgenommenen Änderungen zu haben.
Tipp
Informationen zu Übersetzungen finden Sie unter Ein Übersetzungspaket exportieren und Ein Übersetzungspaket importieren.
Voraussetzung für einen erfolgreichen Import ist, dass das Legacy-Format ausreichend gut strukturiert ist. Beachten Sie auch, dass Sie, wenn Sie aus unstrukturierten und nicht auf Topics basierenden Inhalten (wie Word) importieren, wahrscheinlich einen Großteil der Inhalte umschreiben sollten, um ihn auf Topics zu basieren, wiederverwendbar zu machen usw. Auch wenn die Importfunktion sehr gut funktioniert, sollten Sie daher immer sorgfältig abwägen, welche Strategie für Ihre Inhalte am besten ist.
Wenn Ihre Inhalte bereits gut strukturiert und in Topic-ähnliche Abschnitte unterteilt ist, können Sie sehr von einem Import profitieren, der Ihnen Zeit bei der Migration spart. Aber wenn viel umgeschrieben werden muss, profitieren Sie weniger, und der Import ist in einem solchen Fall vielleicht gar nicht sinnvoll.
„Intelligenter Import“ bedeutet, dass Paligo nicht einfach blind alle Ihre Inhalte importiert, sondern direkt eine Wiederverwendung ermöglicht.
Paligo kann in vielen Fällen intelligent erkennen, ob derselbe Inhalt bereits importiert wurde. Das heißt, Paligo erkennt, ob ein Topic oder Bild mit einem zuvor bereits importierten identisch ist. So erhalten Sie keine unnötigen Duplikate und Ihre Arbeit an der Wiederverwendung kann bereits während des Imports beginnen.
Damit Paligo Topics und Bilder erkennt, müssen sie identisch sein. Ist dies jedoch der Fall, wird das Topic oder Bild automatisch ignoriert und stattdessen das bereits im System vorhandene wiederverwendet.
Sie können viele verschiedene Arten von Inhalten in Paligo importieren. Einige Formate können direkt importiert werden, während andere einen indirekten Import erfordern, bei dem Sie die Inhalte in ein anderes Format konvertieren, bevor Sie sie in Paligo importieren.
-
Direkte Importe bedeutet, dass Sie den Importassistenten verwenden können, ohne die Dateien konvertieren zu müssen.
-
Indirekte Importebedeutet, dass Sie die Inhalte mit einer externen Anwendung in ein Format konvertieren müssen, das Paligo für direkte Importe unterstützt, bevor Sie den Importassistenten verwenden können.
Tipp
Überprüfen Sie immer das vorhandene Tool auf Ausgabe- oder Konvertierungsformate. Wenn Sie beispielsweise Adobe FrameMaker-Inhalte importieren möchten, können Sie mit FrameMaker eine XHTML-Version erstellen und dann die XHTML-Inhalte in Paligo importieren.
In der folgenden Tabelle sind die verschiedenen Importformate beschrieben. Für jedes Format sind unterschiedliche Vorbereitungen erforderlich.
Tipp
Sie können den Import auch an Ihre Anforderungen anpassen. Für weitere Informationen wenden Sie sich bitte an den Support.
Importformat |
Beschreibung |
---|---|
Paligo Export File (PEF) |
Direkter Import im Paligo Importassistenten. Dieses XML-Format wird unter anderem für Backups verwendet, siehe Paligo Export File (PEF) importieren. |
Author-it |
Exportieren Sie nach XHTML und verwenden Sie die Option Author-it-Format im Importassistenten. Bereiten Sie die Inhalte gemäß Aus anderen Formaten importieren vor. |
Confluence |
Direkter Import im Paligo Importassistenten. Der Import funktioniert mit einem HTML Confluence Space Export und anderen XHTML-Importen. Bereiten Sie die Inhalte gemäß Aus Confluence importieren vor. |
DITA (Ditamap) |
Direkter Import im Paligo Importassistenten. Bereiten Sie die Inhalte gemäß Aus DITA importieren vor. |
DocBook 4 oder 5 |
Direkter Import im Paligo Importassistenten. Bereiten Sie die Inhalte gemäß Aus DocBook importieren vor. |
FrameMaker |
Exportieren Sie nach XHTML und verwenden Sie die Option Confluence-Format im Importassistenten. Bereiten Sie die Inhalte gemäß Aus anderen Formaten importieren vor. |
HTML |
Direkter Import im Paligo Importassistenten. Bereiten Sie die Inhalte gemäß HTML importieren (einzelne Datei) und HTML importieren (mehrere Dateien) vor. |
Help & Manual |
Direkter Import im Paligo Importassistenten. Bereiten Sie die Inhalte gemäß Aus Help & Manual importieren vor. |
MadCap Flare |
Direkter Import im Paligo Importassistenten. Bereiten Sie die Inhalte gemäß Aus MadCap Flare importieren vor. |
Microsoft Word |
Für die Vorbereitung des Imports aus Microsoft Word gibt es drei Möglichkeiten, siehe Aus Microsoft Word importieren. |
RoboHelp |
Exportieren Sie nach XHTML, HTML, DITA oder MS Word und verwenden Sie die entsprechende Formatoption im Importassistenten. Bereiten Sie die Inhalte gemäß Aus anderen Formaten importieren vor. |
Swagger OpenAPI |
Direkter Import im Paligo Importassistenten. Bereiten Sie die Inhalte gemäß Swagger OpenAPI importieren vor. |
Zendesk Guide (Help Center) |
Direkter Import im Paligo Importassistenten. Bereiten Sie die Inhalte gemäß Aus Zendesk importieren vor. |
Sonstige Formate:
|
Exportieren Sie nach XHTML, HTML, DITA oder MS Word und verwenden Sie die entsprechende Formatoption im Importassistenten. Bereiten Sie die Inhalte gemäß Aus anderen Formaten importieren vor. |