Skip to main content

Aus DITA importieren

Verwenden Sie den Paligo Importassistenten, um DITA-Inhalte direkt in Paligo zu importieren. Während des Imports bearbeitet Paligo die meisten gängigen DITA-Inhaltselemente, einschließlich conkeyrefs (teilweise).

Wenn Ihre Inhalte DITA-Konstrukte umfassen, die Paligo nicht unterstützt, können diese ausgeschlossen oder als DocBook Elemente mit einem anderen Zweck importiert werden. Dies könnte jedoch zu einer ungültigen DocBook XML führen. Diese Fehler müssen nach dem Import manuell behoben werden.

DITA-Inhalte vorbereiten

Paligo importiert die Inhalte in den Content Manager. Überprüfen Sie die Inhalte nach Abschluss des Imports auf eventuell erforderliche manuelle Änderungen (z. B. bei vom Paligo Import nicht unterstützten DITA-Elementen).

  1. Bereiten Sie Ihre DITA-Inhalte vor und komprimieren Sie anschließend den Ordner, der sie enthält.

    Anmerkung

    Wenn Sie in Ihren DITA-Inhalten Variablen verwenden und diese als Variablen in Paligo importieren möchten, siehe Conkeyrefs als Variablen importieren.

  2. Stellen Sie sicher, dass der Ordner mit Ihren DITA-Inhalten eine Haupt-Ditamap-Datei enthält. Benennen Sie diese Ditamap-Datei wie folgt: 

    index.ditamap

    Wenn Sie über eine Ditamap für die gesamte Publikation und mehrere „Kapitel“-Ditamaps verfügen, benennen Sie nur die für die Hauptpublikation um. Dabei spielt es keine Rolle, ob es sich um eine reguläre Ditamap oder eine Bookmap handelt.

  3. Importassistenten verwenden Sie können den ,um Ihre DITA-Inhalte zu importieren.

    Wählen Sie als Importart DITA (.ditamap) und anschließend Ihre DITA-Zip-Datei als „Archivdatei“ aus.

Conkeyrefs als Variablen importieren

Wenn Sie conkeyrefs als Variablen in DITA verwendet haben, kann Paligo diese als Variablen und Variablensätze in Paligo importieren. Dazu benötigen Sie:

Anmerkung

Paligo kann als Variablen verwendete DITA conkeyrefs in Variablen und Variablensätze in Paligo konvertieren. Wenn Sie andere Konstruktionen für die Emulation von Variablen in DITA verwendet haben, wechseln Sie vor dem Import in Paligo auf die Verwendung von conkeyrefs. Dadurch kann der Import die Konvertierung von Variablen durchführen.

Wenn Sie dabei Probleme haben, bitten Sie den Support um Hilfe bei der Vorbereitung der Inhalte.

  1. Eine Ditamap, die eine topicref zu einem Topic und eine keydef zur Variablendatei enthält. Beispiel:

    <topicref href="topics/DITA-topic-w-vars.dita"/>
<keydef keys="products" href="topics/DITA-variables.dita"/>

  2. Die Variablendatei, bei der es sich um ein Topic handelt und bei der jede Variable mit einer ID deklariert ist. Beispiel:

     <p>Product name: <ph id="productname">product A1</ph></p>

  3. Ein Topic, das Verweise auf die Variablen enthält. Zum Beispiel:

    <p>This is the product name: <ph conkeyref="products/productname"/></p>

    Wo:

    • „products“ die ID der Variablendatei wiedergibt, wie in der ditamap keydef angegeben

    • „productname“ die ID der Variable darstellt.

  4. Wenn Sie über diese Dateien verfügen, fügen Sie sie zu einem Ordner hinzu und komprimieren Sie den Ordner.

  5. Importassistenten verwenden Sie können den ,um Ihre Inhalte zu importieren.

    Nach Abschluss des Imports importiert Paligo die Variablendatei als Variablensatz und die conkeyref-Elemente in Variablen.

Tipp

Weitere Informationen zu Variablen und Variablensätzen in Paligo finden Sie unter:

Beispiel für einen DITA-Import

Anhand des folgenden Beispiels sehen Sie, was passiert, wenn Sie DITA-Inhalte mit Variablen in Paligo importieren (vorausgesetzt, die DITA-Inhalte wurden korrekt erstellt).

Beispiel 1. DITA-Dateien zum Importieren von conkeyref als Variablen

Die Zip-Datei enthält einen Ordner und in diesem Ordner befinden sich:

  • index.ditamap

    Eine Ditamap, die eine topicref zu einem Topic (DITA-topic-w-vars.dita) und eine keydef zur Variablendatei (DITA-variables.dita) enthält

  • DITA-variables.dita

    Dies ist die Variablendatei, in der jede Variable mit einer ID deklariert ist.

  • DITA-topic-w-vars.dita

    Dies ist ein Topic, das conkeyref-Verweise auf die Variablendatei (DITA-variables.dita) enthält.

Die Dateien enthalten:

index.ditamap

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE map PUBLIC "-//OASIS//DTD DITA Map//EN" "map.dtd">
<map>
    <title>DITA map with variables</title>
    <topicref href="topics/DITA-topic-w-vars.dita"/>
    <keydef keys="products" href="topics/DITA-variables.dita"/>
</map>

DITA-variables.dita

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE topic PUBLIC "-//OASIS//DTD DITA Topic//EN" "topic.dtd">
<topic id="DITAvariables">
    <title>DITA_variables</title>
    <body>
        <p>This is an example of a DITA variable file</p>
        <p>Here is the variables enclosed in PH-tags with Ids:</p>
        <p>Product name: <ph id="productname">product A1</ph></p>
        <p>Product type: <ph id="producttype">produkttype A1</ph></p>
    </body>
</topic>

DITA-topic-w-vars.dita

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE concept PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd">
<concept id="dita_topic_w_vars">
    <title>DITA topic with variables</title>
    <shortdesc></shortdesc>
    <conbody>
        <p>This is an example of a topic using variables as conkeyrefs.</p>
        <p>This is the product name: <ph conkeyref="products/productname"/></p>
        <p>This is the product type: <ph conkeyref="products/producttype"/></p>
    </conbody>
</concept>

Wenn Sie diese ZIP-Datei in Paligo importieren, erzeugt Paligo:

  • Eine Publikation mit einer Gabelung zu dem Topic, das Paligo für die Datei DITA-topic-w-vars.dita erstellt.

    Paligo has created a publication for a DITA import. The publication contains a fork to a "DITA topic with variables" topic.

  • Ein Topic mit den Inhalten aus der Datei DITA-topic-w-vars.dita, konvertiert in Paligo XML mit Paligo Variablen anstelle von conkeyref-Variablen.

    A topic called "DITA topic with variables" shown in the Paligo editor. It has various paragraphs, two of which contain variables that reference a variable set.

  • Einen Variablensatz. Paligo erstellt einen Variablensatz und importiert die Inhalte der Datei DITA.variables.dita in diesen. Die importierten Daten werden in Paligo Variablen umgewandelt.

    A variable set that Paligo has generated automatically for an imported DITA variable file. It contains a variable for product name and a variable for product type. Both variables have a value set for a "general" variant.

    Die Werte für die Variablen befinden sich in der Spalte „Allgemein“. Diese Werte sind für eine Variante zu verwenden. Sie können zusätzliche Varianten hinzufügen, damit die Variablen unter verschiedenen Umständen unterschiedliche Werte haben können.