Skip to main content

Aus Help & Manual importieren

Inhalte aus Help & Manual können direkt in Paligo importiert werden, das Projekt bedarf jedoch einiger Vorbereitung. Es gibt allerdings einige bekannte Einschränkungen:

  • Help & Manual verwendet eine sehr flache Struktur, die in eine strukturiertere, verschachtelte XML umgewandelt werden muss. Dies ist eine sehr herausfordernde Art der Konvertierung, und Sie sollten sicherstellen, dass beim Versuch, dies zu beheben, die beabsichtigte Reihenfolge der Inhalte nicht falsch interpretiert wurde.

  • Variablen werden nur teilweise unterstützt, da die Verwendung von Variablen stark von ihrer Umsetzung in Paligo abweicht. Nicht unterstützte Variablentypen werden im Import mit einem „Bemerkungselement“ markiert („UNBEARBEITETE VARIABLE“).

  • Die bedingte Filterung ist in Help & Manual völlig anders als in Paligo und den meisten XML-basierten Single-Sourcing-Programmen, sodass eine direkte Konvertierung dieser nicht möglich ist. Stattdessen wird sie mit „Bemerkungselementen“ markiert und sollte nach dem Import manuell korrigiert werden.

Anmerkung

Wenn Ihre Inhalte wiederverwendbare „Snippets“ enthalten, könnten einige davon in Paligo als reguläre Topics erscheinen. Ist dies bei Ihren Inhalten der Fall, können Sie die einzelnen Topics einfach jeweils in ein informaltopic umwandeln. Ein informaltopic ist eine Gruppe von Textfragmenten, die Sie in andere reguläre Topics einfügen können, es funktioniert also ähnlich wie ein Snippet.

Wählen Sie dazu das Optionsmenü ( ... ) des Topics im Content Manager und dann Bearbeiten > Struktur öffnen aus. Wandeln Sie das Topic anschließend im Abschnitt Metadaten über die Einstellung Untertyp von einer Komponente in ein informelles Topic um. Wählen Sie Aktualisieren aus, um zu bestätigen.

metadata for a topic has a subtype setting. You can use it to convert a topic (component) into an informaltopic and vice-versa.

Weitere Informationen zu informellen Topics finden Sie unter Ein informelles Topic erstellen.

Help & Manual Inhalte vorbereiten

Bevor Inhalte aus Help & Manual in Paligo importiert werden können, müssen sie vorbereitet werden.

  1. Benennen Sie die Help & Manual Projektdatei mit der Erweiterung .hmxz in .zip um. Dekomprimieren Sie das Archiv.

  2. Suchen Sie den Ordner, in dem sich Ihre Bilder befinden. Führen Sie eine Suche nach Bilddateien in diesem Ordner durch (Suche nach Bildtypdateien). Kopieren Sie alle Suchergebnisse in einen Ordner namens „Bilder“ im Ordner „Maps“, sodass Sie alle Bilder in einem Ordner und keine Unterordner haben.

  3. Benennen Sie alle Bilder in Kleinbuchstaben um, z. B. mit einem Dateiumbenennungstool wie Name Mangler für Mac, oder besuchen Sie zum Beispiel diese Website für Tipps zu Vorgehensweise mit Windows: Is there a way to batch rename files to lowercase?

    Anmerkung

    Denn selbst wenn Sie Ihre Bilder mit Großbuchstaben benannt haben, verweist Help & Manual immer in Kleinbuchstaben auf diese, und für den Import muss die Schreibweise übereinstimmen.

  4. Importassistenten verwenden Sie können den, um die ZIP-Datei zu importieren.