Getting Started with Paligo

Importing DITA

DITA can be imported directly in the Paligo Import Wizard. Follow these instructions to prepare your import package.

Note

The Paligo can handle import of a lot of the most common DITA content, including conrefs partially. If something is not currently supported, that will need to be treated manually post-import.

Note

Conkeyrefs used as variables can be automatically converted into variables and variable sets in Paligo. If you have used any other construction for emulating variables in DITA, you may want to consider changing that before import to make use of variable conversion.

The structure that works is if you have a topicref or keyref with the attribute keys set on it, and the topic referred to has phrase or keydef elements with id attributes.

  1. In a folder with your DITA content, make sure you have just one main ditamap file. Name this ditamap file index.ditamap.

    If you have e.g one ditamap for the entire publication, and several "chapter" ditamaps or the like, only select and rename the main publication one. It doesn't matter if that's a regular ditamap or a bookmap.

  2. Include the DTD files inside the folder if they are not already there.

    (If they are not there, you can get them from the DITA OT, and if you are using standard (non-specialized) DITA, the folders from the DTD you need are usually base and technicalContent.)

  3. If you didn't already have these DTD folders in your content folder, you may have to make sure that your content files reference the DTDs correctly in the DocType declaration. So if you have one that looks like this:

    <!DOCTYPE topic PUBLIC "-//OASIS//DTD DITA Topic//EN" "topic.dtd" []>
    

    Then if you don't really have your DTD in the same folder, you need to change this declaration to point to where it is, for example if you copied the DTD folders as described above:

    <!DOCTYPE topic PUBLIC "-//OASIS//DTD DITA Topic//EN" "technicalContent/dtd/topic.dtd" [
    ]>
    

    Note

    The same needs to be done for concepts, tasks, ditamaps, as they all have different DTDs.

    Tip

    The easiest way to do this is with an XML or text editor that can search and replace in all your files at once. Then just search for the current DocType declaration you have in a document, and replace it with the corresponding new one. Do the same for the different topic types and ditamaps.

    Contact support if you need guidance for this.

  4. When you have prepared the files, zip the folder.

  5. Import the zip file using the Import Wizard, selecting DITA (ditamap) as the source format to import.

    If you want, set the custom options. See Importing.

    Note

    If you are importing content converting conkeyrefs to variable sets also, as described above, and have previously imported content using the same keys, you should also select to use the existing variable set already created, so you don't get duplicate variable sets.

    You find the variable set id if you open it, and then in the browser address bar get the id right after "edit/".

    Paligo will collect multiple variable sets into one. If you want to separate them into multiple ones again this can be done after import.